LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

crane-push

upload tarball as container image

TLDR

Push tarball as image
$ crane push [image.tar] [registry/repo:tag]
copy
Push and write the resulting image digest
$ crane push [image.tar] [registry/repo:tag] --image-refs [refs.txt]
copy
Push with a specific platform index
$ crane push [image.tar] [registry/repo:tag] --index
copy

SYNOPSIS

crane push [options] tarball image

DESCRIPTION

crane push uploads a tarball as a container image to a registry. The tarball should be in OCI or Docker image format (as produced by crane pull, docker save, or crane export).The command reads the image layers from the tarball and pushes them to the target repository, then uploads the manifest. Authentication uses the same Docker credentials configured in ~/.docker/config.json.

PARAMETERS

--image-refs file

Path to write the full image reference (including digest) by tag.
--index
Push a collection of images as a single index (manifest list).
--platform os/arch
Specify platform when pushing a multi-platform tarball.

CAVEATS

The registry must be reachable and the user must have push access. For multi-platform images, use --index. Large tarballs stream from disk, so sufficient bandwidth is required.

SEE ALSO

crane(1), crane-pull(1), docker(1), skopeo(1)

Copied to clipboard
Kai