crane
Container images managing tool. Some subcommands such as `pull`, `push`, `copy`, etc. have their own usage documentation.
More info →Subcommands (22)
Push an image based on an (optional) base image. Appends layers containing the contents of the provided tarballs.
Log in or access credentials.
Read a blob from a registry.
List the repositories in a registry.
Get the configuration of an image.
Efficiently copy a remote image from source to target while retaining the digest value.
This command is an alias of `crane copy`.
Delete an image reference from its registry.
Get the digest of an image.
Export filesystem of a container image as a tarball.
Flatten an image's layers into a single layer. Pushes digest to original image repository if no tags are specified.
Modify an image index. Some subcommands such as `append` and `filter` have their own usage documentation.
List the tags in a repository.
Get the manifest of an image.
Modify image labels and annotations. The container must be pushed to a registry, and the manifest is updated there.
Pull remote images by reference and store their contents locally.
Push local image contents to a remote registry.
Rebase an image onto a new base image.
This command serves a registry implementation on an automatically chosen port (`:0`), `$PORT`, or `--address`. The command blocks while the server accepts pushes and pulls and contents are can be stored in memory, and disk.
Efficiently tag a remote image without downloading it, which differs from the `copy` command. It skips the layer existence checks because we know the manifest already exists making it slightly faster.
Validate that an image is well-formed.
Print the version of a binary. The version string is completely dependent on how the binary was built, so you should not depend on the version format. It may change without notice.
Options (5)
-u, --usernamebooleanLog in to a registry
crane auth login {{registry}} {{[-u|--username]}} {{user}} {{[-p|--password]}} {{password}}-p, --passwordbooleanLog in to a registry
crane auth login {{registry}} {{[-u|--username]}} {{user}} {{[-p|--password]}} {{password}}-o, --omit-digest-tagsbooleanList the tags in a repository
crane ls {{repository}} {{[-o|--omit-digest-tags]}}booleanEfficiently copy a remote image while retaining the digest value
crane {{[cp|copy]}} {{source}} {{destination}} {{[-a|--all-tags]}}-a, --all-tagsbooleanEfficiently copy a remote image while retaining the digest value
crane {{[cp|copy]}} {{source}} {{destination}} {{[-a|--all-tags]}}Examples (8)
Log in to a registry
crane auth login registry [-u|--username] user [-p|--password] passwordList the repos in a registry
crane catalog registry --full-refList the tags in a repository
crane ls repository [-o|--omit-digest-tags]Pull remote images by reference and store their contents locally
crane pull image tarballPush local image contents to a remote registry
crane push path/to/directory_or_tarball imageEfficiently copy a remote image while retaining the digest value
Delete an image reference from its registry
crane delete image