70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
|
---
|
||
|
|
stage: Package
|
||
|
|
group: Package
|
||
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
||
|
|
---
|
||
|
|
|
||
|
|
# Harbor Registry **(FREE)**
|
||
|
|
|
||
|
|
You can integrate the [Harbor container registry](../../../user/project/integrations/harbor.md#harbor-container-registry-integration) 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**.
|
||
|
|
1. Go to the project or group that you are interested in.
|
||
|
|
1. 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.
|
||
|
|
1. Click the **Copy** icon next to the image name.
|
||
|
|
|
||
|
|
1. 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.
|
||
|
|
1. Go to **Packages and registries > Harbor Registry**.
|
||
|
|
1. Click the image name to view its artifacts.
|
||
|
|
1. 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.
|
||
|
|
1. 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.
|
||
|
|
1. Click **Harbor** under **Active integrations**.
|
||
|
|
1. Clear the **Active** checkbox under **Enable integration**.
|
||
|
|
1. Select **Save changes**.
|
||
|
|
|
||
|
|
The **Packages and registries > Harbor Registry** entry is removed from the sidebar.
|