Skip to main content
Version: 1.2

oras manifest push

Push a manifest to remote registry.

oras manifest push [flags] <name>[:<tag>[,<tag>][...]|@<digest>] <file>

Examples

Push a manifest to repository 'localhost:5000/hello' and tag with 'v1':

oras manifest push localhost:5000/hello:v1 manifest.json

Push a manifest using a specific method for the Referrers API:

oras manifest push --distribution-spec v1.1-referrers-api localhost:5000/hello:v1 manifest.json
oras manifest push --distribution-spec v1.1-referrers-tag localhost:5000/hello:v1 manifest.json

Push a manifest with content read from stdin:

oras manifest push localhost:5000/hello:v1 -

Push a manifest and output its descriptor:

oras manifest push --descriptor localhost:5000/hello:v1 manifest.json

Push a manifest to repository 'localhost:5000/hello' and output the prettified descriptor:

oras manifest push --descriptor --pretty localhost:5000/hello manifest.json

Push a manifest with specified media type to repository 'localhost:5000/hello' and tag with 'v1':

oras manifest push --media-type application/vnd.cncf.oras.artifact.manifest.v1+json localhost:5000/hello:v1 oras_manifest.json

Push a manifest to repository 'localhost:5000/hello' and tag with 'tag1', 'tag2', 'tag3':

oras manifest push localhost:5000/hello:tag1,tag2,tag3 manifest.json

Push a manifest to repository 'localhost:5000/hello' and tag with 'tag1', 'tag2', 'tag3' and concurrency level tuned:

oras manifest push --concurrency 6 localhost:5000/hello:tag1,tag2,tag3 manifest.json

Push a manifest to an OCI layout folder 'layout-dir' and tag with 'v1':

oras manifest push --oci-layout layout-dir:v1 manifest.json

Options

      --ca-file string                             server certificate authority file for the remote registry
--concurrency int concurrency level (default 5)
-d, --debug debug mode
--descriptor output the descriptor
--distribution-spec string [Preview] set OCI distribution spec version and API option for target. options: v1.1-referrers-api, v1.1-referrers-tag
-H, --header stringArray add custom headers to requests
-h, --help help for push
--insecure allow connections to SSL registry without certs
--media-type string media type of manifest
--oci-layout set target as an OCI image layout
-p, --password string registry password or identity token
--password-stdin read password or identity token 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]
-u, --username string registry username
-v, --verbose verbose output