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

Request the necessary permissions from your IAM administrator. 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 IAM Project 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.

### gdcloud

View the Harbor registry instance:

```bash
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.

### gdcloud

Delete the Harbor registry instance:

```bash
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:

- [Create Harbor projects](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform-application/pa-ao-operations/create-harbor-projects.md.txt)
- [Configure Docker to trust the Harbor root CA](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform-application/pa-ao-operations/configure-docker-trust.md.txt)
- [Sign in to Docker and Helm](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform-application/pa-ao-operations/configure-docker-authentication.md.txt)