Manage Harbor registry instances

This page details how to manage your created Harbor registry instances. View or delete your created Harbor registry instances using the Google Distributed Cloud (GDC) air-gapped console or the GDC gdcloud CLI. Delete unused Harbor instance registries to lower your storage costs and free up space.

Before you begin

Before you begin, make sure you have the necessary permissions. Enforce least privilege access by requesting only the roles required for your specific tasks.

Required IAM roles

If you are responsible for managing Harbor registry instances, contact your Project IAM Admin to request the following project-level roles:

  • Harbor Instance Admin (harbor-instance-admin): get, list, watch, create, update, patch, and delete Harbor instances, backup repositories, backup plans, backups, and restores within a project. Request this role if you are responsible for permanently deleting unused Harbor instances to free up space.
  • Harbor Instance Viewer (harbor-instance-viewer): get, list, and watch Harbor instances within a project. Request this role if you only need the permissions to view the details and status of existing instances.

View Harbor registry instances

View your created Harbor registry instances in the GDC console or use the GDC gdcloud CLI.

Console

  1. In the navigation menu, in the CI/CD section, click Harbor Container Registry.
  2. View the list of created Harbor instances in the Instances section.
  3. For more detail about a specific instance, click the Go to Harbor Instance external link.

CLI

View the Harbor registry instance:

gdcloud harbor instances describe INSTANCE \
  --project=PROJECT

Replace the following:

  • INSTANCE: the name of the instance.
  • PROJECT: the name of the project.

Delete Harbor registry instances

Delete an existing Harbor registry instance if it is no longer required. Harbor registry instances in the GDC console or use the GDC gdcloud CLI.

Console

  1. In the navigation menu, in the CI/CD section, click Harbor Container Registry.
  2. Click Delete Instance.

  3. On the confirmation dialog:

    1. Click Cancel to stop the delete operation.
    2. Click Delete to confirm the deletion of the Harbor instance.

CLI

Delete the Harbor registry instance:

gdcloud harbor instances delete INSTANCE \
  --project=PROJECT

Replace the following:

  • INSTANCE: the name of the instance.
  • PROJECT: the name of the project.

What's next

To start hosting and managing images in your instance, create a Harbor project and configure your client connection to the Harbor registry: