tldr/pages/common/crane-mutate.md

crane mutate

Modify image labels and annotations. The container must be pushed to a registry, and the manifest is updated there. More information: https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_mutate.md.

• New annotations to set (default []):

crane mutate {{[-a|--annotation]}}/{{[-l|--label]}} {{annotation/label}}

• Path to tarball/command/entrypoint/environment variable/exposed-ports to append to image:

crane mutate {{--append}}/{{--cmd}}/{{--entrypoint}}/{{[-e|--env]}}/{{--exposed-ports}} {{var1 var2 ...}}

• Path to new tarball of resulting image:

crane mutate {{[-o|--output]}} {{path/to/tarball}}

• Repository in the form os/arch/variant:osversion,platform to push mutated image:

crane mutate --set-platform {{platform_name}}

• New tag reference to apply to mutated image:

crane mutate {{[-t|--tag]}} {{tag_name}}

• New user to set:

crane mutate {{[-u|--user]}} {{username}}

• New working dir to set:

crane mutate {{[-w|--workdir]}} {{path/to/work_directory}}

• Display help:

crane mutate {{[-h|--help]}}