1. Using Visual Builder Studio
  2. Maximize the Power of Your Project
  3. Access External Docker Registries
  4. Link an External Docker Registry to Your Project

Link an External Docker Registry to Your Project

As a project owner, you can link an external Docker registry to your project:

  1. In the left navigator, click Project Administration Project Administration.
  2. Click Repositories.
  3. In Docker Registries, click + Link External Registry.
    To view all linked Docker registries, expand Linked External Docker Registries.
  4. In Registry Name and Short Description, enter a unique Docker registry name and a description.
  5. In Registry URL, enter the URL of the Docker (or Docker Hub) registry. For example, you could enter https://registry-1.docker.io.

    The registry you specify should support the v2 API version and catalog endpoints.

    To link to OCIR, enter the registry path in the https://<ocir_region_code>.ocir.io format. For example: If your region is Ashburn, enter iad.ocir.io. See Availability by Region Name and Region Code to locate the region codes.

  6. In Authentication, select the authentication type
    • Basic (default): Select and enter the basic username and password details in Username and Password.

      To authenticate and access the external Docker Hub registry, specify your Docker ID.

      To connect to OCIR, enter the username of the OCI user who can access OCIR in the<tenancy_name>/<oci_user_name> format. For example, mytenancy/myociuser. In password, enter the OCI user's auth token. See Getting an Auth Token.

    • OAuth2: Select and enter the long-lived access token for authentication in Auth Token. Don’t enter a short-lived access token.

      For more information about OAuth2 in Docker, see https://docs.docker.com/registry/spec/auth/oauth/.

    • Anonymous: Select if the registry can be accessed anonymously and doesn’t require authentication.
  7. Click Create.
After verifying the credentials and the URL, the registry will be added to the Linked External Docker Registries section. You can browse its repositories and images from the Docker Docker Registry page.

After linking a Docker registry, you can also configure a job to use it while running a build. If you update the linked Docker registry’s details, the updated information will be passed to any build jobs that use those details.