oras restore

[Experimental] Restore artifacts to a registry from an OCI image layout, which can be either a directory or a tar archive.

oras restore [flags] --input <path> <registry>/<repository>[:<ref1>[,<ref2>...]]

Examples

Restore a single artifact from a tar archive:

oras restore --input hello.tar localhost:5000/hello:v1

Restore a single artifact from a directory:

oras restore --input hello localhost:5000/hello:v1

Perform a dry run without actually uploading artifacts:

oras restore --input hello --dry-run localhost:5000/hello:v1

Restore multiple specific tags:

oras restore --input hello localhost:5000/hello:v1,v2

Restore all tagged artifacts:

oras restore --input hello localhost:5000/hello

Exclude referrers when restoring artifacts:

oras restore --input hello --exclude-referrers localhost:5000/hello

Use Referrers API for discovering referrers:

oras restore --input hello --distribution-spec v1.1-referrers-api localhost:5000/hello

Use Referrers Tag Schema for discovering referrers:

oras restore --input hello --distribution-spec v1.1-referrers-tag localhost:5000/hello

Restore to an insecure registry:

oras restore --input hello --insecure localhost:5000/hello:v1

Restore to a plain HTTP registry (no TLS):

oras restore --input hello --plain-http localhost:5000/hello:v1

Set custom concurrency level:

oras restore --input hello --concurrency 6 localhost:5000/hello:v1

Options

      --ca-file string                             server certificate authority file for the remote registry
      --cert-file string                           client certificate file for the remote registry
      --concurrency int                            concurrency level (default 5)
  -d, --debug                                      output debug logs (implies --no-tty)
      --distribution-spec string                   [Preview] set OCI distribution spec version and API option for target. Options: v1.1-referrers-tag, v1.1-referrers-api
      --dry-run                                    simulate the restore process without actually uploading any artifacts
      --exclude-referrers                          restore artifacts excluding their referrers
  -H, --header stringArray                         add custom headers to requests
  -h, --help                                       help for restore
      --identity-token string                      registry identity token
      --identity-token-stdin                       read identity token from stdin
      --input string                               path to the OCI layout, either a tar archive (*.tar) or a directory
      --insecure                                   allow connections to SSL registry without certs
      --key-file string                            client private key file for the remote registry
      --no-tty                                     [Preview] disable progress bars
  -p, --password string                            registry password or identity token
      --password-stdin                             read password from stdin
      --plain-http                                 allow insecure connections to registry without SSL check
      --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