Harbor Registry

You can integrate the Harbor container registry into GitLab and use Harbor as the container registry for your GitLab project to store images.

View the Harbor Registry

You can view the Harbor Registry for a project or group.

  1. On the top bar, select Main menu > Projects/Groups.
  2. Go to the project or group that you are interested in.
  3. On the left sidebar, select Packages and registries > Harbor Registry.

You can search, sort, and filter images on this page. You can share a filtered view by copying the URL from your browser.

At the project level, in the upper-right corner, you can see CLI Commands where you can copy corresponding commands to sign in, build images, and push images. CLI Commands is not shown at the group level.

note
Default settings for the Harbor integration at the project level are inherited from the group level.

Use images from the Harbor Registry

To download and run a Harbor image hosted in the GitLab Harbor Registry:

  1. Copy the link to your container image:
    1. Go to your project or group’s Packages and registries > Harbor Registry and find the image you want.
    2. Select the Copy icon next to the image name.
  2. Use the command to run the container image you want.

View the tags of a specific artifact

To view the list of tags associated with a specific artifact:

  1. Go to your project or group.
  2. Go to Packages and registries > Harbor Registry.
  3. Select the image name to view its artifacts.
  4. Select the artifact you want.

This brings up the list of tags. You can view the tag count and the time published.

You can also copy the tag URL and use it to pull the corresponding artifact.

Build and push images by using commands

To build and push to the Harbor Registry:

  1. Authenticate with the Harbor Registry.
  2. Run the command to build or push.

To view these commands, go to your project’s Packages and registries > Harbor Registry > CLI Commands.

Disable the Harbor Registry for a project

To remove the Harbor Registry for a project:

  1. Go to your project/group’s Settings > Integrations page.
  2. Select Harbor under Active integrations.
  3. Clear the Active checkbox under Enable integration.
  4. Select Save changes.

The Packages and registries > Harbor Registry entry is removed from the sidebar.