Disable the service

This page describes the steps to disable Container Registry.

Disabling the service

Disabling the Container Registry API does not delete container images stored in Cloud Storage buckets for registry hosts. You will continue to incur Cloud Storage storage and network egress charges for stored images.

If you are no longer using Container Registry and do not need the retain the images, delete the storage buckets.

Disable the API

To disable the API from the Google Cloud console:

consolegcloud
  1. Go to the API Overview page for Container Registry.
  2. Select the project where the API is enabled.
  3. Click Manage.
  4. Click Disable API.

Run the following command to disable the API for your current project:

gcloud services disable containerregistry.googleapis.com

Delete storage buckets

Delete the storage buckets for Container Registry if you are no longer using Container Registry

To delete each Container Registry storage bucket:

Console gcloud
  1. Go to the Cloud Storage page in the Google Cloud console.

  2. Select the storage bucket to delete. In the bucket names, PROJECT-ID is your Google Cloud project ID.

    • gcr.io: artifacts.PROJECT-ID.appspot.com
    • asia.gcr.io: asia.artifacts.PROJECT-ID.appspot.com
    • eu.gcr.io: eu.artifacts.PROJECT-ID.appspot.com
    • us.gcr.io: us.artifacts.PROJECT-ID.appspot.com

  3. Click Delete. A confirmation dialog box appears.

  4. To confirm deletion, enter the bucket name and then click Delete.

If you want to bulk delete a hundred thousand or more images in a bucket, avoid using the gcloud CLI since the deletion process takes a long time to complete. Use the Google Cloud console to perform the operation instead. For more information, see deleting Cloud Storage objects in bulk.

To delete a bucket, use the gcloud storage rm command with the --recursive flag.

gcloud storage rm gs://BUCKET-NAME --recursive

Replace BUCKET-NAME with the Container Registry storage bucket name. In the bucket names, PROJECT-ID is your Google Cloud project ID.

  • gcr.io: artifacts.PROJECT-ID.appspot.com
  • asia.gcr.io: asia.artifacts.PROJECT-ID.appspot.com
  • eu.gcr.io: eu.artifacts.PROJECT-ID.appspot.com
  • us.gcr.io: us.artifacts.PROJECT-ID.appspot.com

The response looks like the following example:

Removing gs://artifacts.my-project.appspot.com/...

If other Google Cloud services are running in the same Google Cloud project, leave the Container Registry API enabled. If you try to disable the Container Registry API. Container Registry displays a warning if other services with a configured dependency are enabled in the project. Disabling the Container Registry API automatically disables any services in the same project with a configured dependency, even if you are not currently using Container Registry with those services.

What's next