tldr/pages/common/crane-append.md

crane append

Push an image based on an (optional) base image. Appends layers containing the contents of the provided tarballs. More information: https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_append.md.

• Push image based on a base image:

crane append {{[-b|--base]}} {{image_name}}

• Push image with appended layer from tarball:

crane append {{[-f|--new_layer]}} {{layer_name1 layer_name2 ...}}

• Push image with appended layer with new tag:

crane append {{[-t|--new_tag]}} {{tag_name}}

• Push resulting image to new tarball:

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

• Use empty base image of type OCI media instead of Docker:

crane append --oci-empty-base

• Annotate resulting image as being based on the base image:

crane append --set-base-image-annotations

• Display help:

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