Command: get artifacts

Usage

ocm get artifacts [<options>] {<artifact-reference>}

Options

  -a, --attached           show attached artifacts
  -h, --help               help for artifacts
  -o, --output string      output mode (JSON, json, tree, wide, yaml)
  -r, --recursive          follow index nesting
      --repo string        repository name or spec
  -s, --sort stringArray   sort fields

Description

Get lists all artifact versions specified, if only a repository is specified all tagged artifacts are listed.

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 the option –recursive the complete reference tree of a index is traversed.

With the option –output the output mode can be selected. The following modes are supported:

  • (default)
  • JSON
  • json
  • tree
  • wide
  • yaml

Examples


$ ocm get artifact ghcr.io/mandelsoft/kubelink
$ ocm get artifact --repo OCIRegistry::ghcr.io mandelsoft/kubelink

See Also

  • ocm get — Get information about artifacts and components