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

Images are listed under a repository's details page in the "Registry" section of the Crusoe Cloud console.

Listing Manifests

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

From a repository's details page in the "Registry" section of the Crusoe Cloud console, you can click on an image to see its associated tags and manifests.

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

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>

Specific manifests can be deleted from the image details page within your repository.