Create Harbor registry instances

Use the Google Distributed Cloud (GDC) air-gapped Managed Harbor Service (MHS) to create a Harbor registry instance in each project. A Harbor registry instance serves as a central repository for storing and managing container images in a cloud-native environment. It extends the capabilities of the open-source Docker distribution. The following restrictions apply:

  • You can create a maximum of one instance per project.
  • Instances are isolated and don't share any data or compute resources.

Before you begin

If you are responsible for creating Harbor registry instances, contact your Project IAM Admin to request the Harbor Instance Admin (harbor-instance-admin) role, which lets you get, list, watch, create, update, patch, and delete Harbor instances, backup repositories, backup plans, backups, and restores within a project namespace. This role includes the required permissions to provision new Harbor instances.

Create a Harbor registry instance

Create a Harbor registry instance in the GDC console or the gdcloud CLI.

Console

In the GDC console, follow these steps:

  1. In the navigation menu, in the CI/CD section, click Harbor Container Registry.
  2. Click Create Instance.
  3. In the Instance name field, enter a name for the instance.
  4. Optional: In the Projects section, to create a default project for this Harbor instance, click the Create a default project when creating this instance toggle to the on position, and then do the following:
    1. In the Project Name field, enter a project name.
  5. Read the Harbor managed Terms of Service, and then select the checkbox if you accept the terms.
  6. Click Create. The Status shows In progress, and the Name shows an external link containing the name of your newly created Harbor instance.
  7. After the instance is created and the Status shows Ready, click the external link on the page to visit the web UI of the Harbor instance.

gdcloud

Create the Harbor registry instance:

gdcloud harbor instances create INSTANCE \
  --project=PROJECT

Replace the following:

  • INSTANCE: the name of the instance
  • PROJECT: the name of the GDC project in which to create the instance

What's next

After your Harbor registry instance is ready, you can create projects to host your image collections or manage your existing instances: