Skip to content

Container image registry

On the DSH, you deploy custom services from the container image registry, which is a repository for container images.

  • The DSH uses the Harbor Docker registry to store container images.
  • You can create an account in the DSH’s Harbor registry, and push images to the registry.
  • In the service definition of your service, you can then specify which container image to pull for your service.
  • The Harbor projects are shared across platforms:
    • As a consequence, you can first test an image on a DSH staging platform.
    • You can then deploy that same image to a DSH production platform.
    • You can use exactly the same image, without having to go through the process of rebuilding it and pushing it to the Harbor registry.

Accessing Harbor

Take the following steps if you want to access Harbor:

  1. Click “Services” > “Registry” in the menu bar of the DSH Console. Harbor opens in a new browser tab.
  2. Click “Login with keycloak”, and enter the credentials for the authentication method that you use on the DSH: email and password, KPN Grip OIDC, or Google.
  3. If this is the first time that you log in to Harbor, then you will need to choose a Harbor username:
    • Your Harbor username can contain the following characters: uppercase letters (A­­–Z), lowercase letters (a–z), numbers (0–9), underscore (_), and the at sign (@).
    • It is recommended to stick to the username that Harbor suggests.
    • Rename the suggested Harbor username if it contains a forbidden character.
  4. See the Harbor documentation to learn more about Harbor.

Tip

In Harbor, click your username in the menu bar and then “User Profile” to see your CLI secret. Use your Harbor username and CLI secret to connect to Harbor from Docker. See Harbor via Docker CLI for more information.

Harbor via Docker CLI

Once you created a username in Harbor, you can access the container image registry via Docker CLI:

docker login registry.cp.kpn-dsh.com

The DSH will prompt you for a username and password, which you can find in your user profile on Harbor. See Accessing Harbor for more information.