artifacts

Usage

ocm download artifacts [<options>]  {<artifact>} 

Options

      --dirtree          extract as effective filesystem content
  -h, --help             help for artifacts
      --layers ints      extract dedicated layers
  -O, --outfile string   output file or directory
      --repo string      repository name or spec
  -t, --type string      archive format (directory, tar, tgz) (default "directory")

Description

Download artifacts from an OCI registry. The result is stored in artifact set format, without the repository part

The files are named according to the artifact repository name.

If the repository/registry option is specified, the given names are interpreted relative to the specified registry using the syntax

<OCI repository name>[:<tag>][@<digest>]

If no –repo option is specified the given names are interpreted as extended OCI artifact references.

[<repo type>::]<host>[:<port>]/<OCI repository name>[:<tag>][@<digest>]

The –repo option takes a repository/OCI registry specification:

[<repo type>::]<configured name>|<file path>|<spec json>

For the Common Transport Format the types directory, tar or tgz are possible.

Using the JSON variant any repository types supported by the linked library can be used:

  • ArtifactSet: v1
  • CommonTransportFormat: v1
  • DockerDaemon: v1
  • Empty: v1
  • OCIRegistry: v1
  • oci: v1
  • ociRegistry

With option –layers it is possible to request the download of dedicated layers, only. Option –dirtree expects the artifact to be a layered filesystem (for example OCI Image) and provided the effective filesystem content.

The –type option accepts a file format for the target archive to use. It is only evaluated if the target archive does not exist yet. The following formats are supported:

  • directory
  • tar
  • tgz

The default format is directory.

See Also

  • ocm download — Download oci artifacts, resources or complete components