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

Listing Manifests

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

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

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>