Skip to main content
Version: 1.3.0-beta.1

oras blob push

Push a blob to a registry or an OCI image layout

oras blob push [flags] <name>[@digest] <file>

Examples

Push blob 'hi.txt' to a registry:

oras blob push localhost:5000/hello hi.txt

Push blob 'hi.txt' with the specific digest:

oras blob push localhost:5000/hello@sha256:9a201d228ebd966211f7d1131be19f152be428bd373a92071c71d8deaf83b3e5 hi.txt

Push blob from stdin with blob size and digest:

oras blob push --size 12 localhost:5000/hello@sha256:9a201d228ebd966211f7d1131be19f152be428bd373a92071c71d8deaf83b3e5 -

Push blob 'hi.txt' and output the descriptor:

oras blob push --descriptor localhost:5000/hello hi.txt

Push blob 'hi.txt' with the specific returned media type in the descriptor:

oras blob push --media-type application/vnd.oci.image.config.v1+json --descriptor localhost:5000/hello hi.txt

Push blob 'hi.txt' and output the prettified descriptor:

oras blob push --descriptor --pretty localhost:5000/hello hi.txt

Push blob without TLS:

oras blob push --insecure localhost:5000/hello hi.txt

Push blob 'hi.txt' into an OCI image layout folder 'layout-dir':

oras blob push --oci-layout layout-dir hi.txt

Options

      --ca-file string                             server certificate authority file for the remote registry
--cert-file string client certificate file for the remote registry
-d, --debug output debug logs (implies --no-tty)
--descriptor output the descriptor
-H, --header stringArray add custom headers to requests
-h, --help help for push
--identity-token string registry identity token
--identity-token-stdin read identity token from stdin
--insecure allow connections to SSL registry without certs
--key-file string client private key file for the remote registry
--media-type string specify the returned media type in the descriptor if --descriptor is used (default "application/vnd.oci.image.layer.v1.tar")
--no-tty [Preview] do not show progress output
--oci-layout set target as an OCI image layout
--oci-layout-path string set the path for the OCI image layout target
-p, --password string registry password or identity token
--password-stdin read password from stdin
--plain-http allow insecure connections to registry without SSL check
--pretty prettify JSON objects printed to stdout
--registry-config path path of the authentication file for registry
--resolve host:port:address[:address_port] customized DNS for registry, formatted in host:port:address[:address_port]
--size int provide the blob size (default -1)
-u, --username string registry username