Managing Images

An image, such as nginx, can have multiple manifests, which are unique versions or builds of nginx. A specific manifest can be referenced by using a tag (e.g. nginx:latest, nginx:1.18, or nginx:production), which is a mutable pointer, or using its digest (e.g. nginx@sha256:94a1...), which is an immutable hash of its contents. Each manifest has one unique digest but can have many tags pointing to it.

Listing Images

CLI

crusoe registry images list my-repo --location us-east1-a

UI

To view a repository's images in the console:

1. Go to the Container Registry page.
2. Select a repository.

Listing Manifests

CLI

crusoe registry manifests list nginx --repo-name my-repo --location us-east1-a

UI

To view an image's manifests in the console:

1. Go to the Container Registry page.
2. Select the repository containing your image.
3. Select the image to view its details page including all manifests by tag/digest.

Deleting Images

When you delete an image, all of its tags and manifests are deleted.

CLI

crusoe registry images delete my-image-name --repo-name my-repo --location us-east1-a

UI

To delete an image using the console:

1. Go to the Container Registry page.
2. Click on your repository to see all of its details and images.
3. Select the image you want to delete. You can delete images from the repository details page or the image details page.

Deleting Manifests

You can delete specific manifests by tag or digest.

CLI

Deleting a manifest by digest

crusoe registry manifests delete <image-name> --repo-name <repo-name> \
  --location <location> \
  --digest <digest>

Deleting a manifest by tag

crusoe registry manifests delete <image-name> --repo-name <repo-name> \
  --location <location> \
  --tag <tag>

UI

To delete a manifest by tag or digest using the console:

1. Go to the Container Registry page.
2. Select the repository containing your image.
3. Select the image.
4. From the image details page, select the Delete icon next to the tags/digests you want to delete.