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, you can see CLI Commands in the upper right corner, where you can copy corresponding commands to log 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. Click 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. Click 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. Click 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.