Skip to main content

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​

crusoe registry images list my-repo --location us-east1-a
  • Visit the Crusoe Cloud console
  • Select the "Container Registry" tab in the left nav
  • Select a repository to view the repo's details and the list of images

Listing Manifests​

crusoe registry manifests list nginx --repo-name my-repo --location us-east1-a
  • Visit the Crusoe Cloud console
  • Select the "Container Registry" tab in the left nav
  • Select the repository containing your image
  • 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.

crusoe registry images delete my-image-name --repo-name my-repo --location us-east1-a
  • Visit the Crusoe Cloud console
  • Select the "Container Registry" tab in the left nav
  • Click on your repository to see all details and images
  • Images can be deleted from the repository details page or image details page.

Deleting Manifests​

You can delete specific manifests by tag or digest.

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>
  • Visit the Crusoe Cloud console
  • Select the "Container Registry" tab in the left nav
  • Select the repository containing your image
  • Select the image
  • From the image details page, select the "Delete" icon next to tags/digests you wish to delete