Skip to content

cub release get

cub release get

Get details about a release

Synopsis

Get detailed information about a specific release.

The release may be identified by its number within a specific --space, the number cub release list shows, or by its id. Within a specific --space, it may instead be identified by an OCI reference via one of the following flags:

--oci-reference An OCI image reference. A manifest digest (sha256:...) selects the release with that manifest digest. Otherwise is a tag; the only supported tag is "latest", which selects the space's newest release. --bundle-digest The release's bundle content digest (sha256:...).

Examples:

  # Get details about release 3 of a space
  cub release get --space my-space 3

  # Get details about a release by id
  cub release get --space my-space 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c

  # Get a release in JSON format
  cub release get --space my-space -o json 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c

  # Get the space's newest release (tag reference)
  cub release get --space my-space --oci-reference latest

  # Get a release by its OCI manifest digest
  cub release get --space my-space --oci-reference sha256:2222...

  # Get a release by its bundle content digest
  cub release get --space my-space --bundle-digest sha256:1111...
cub release get [release-num | release-id] [flags]

Options

      --bundle-digest string   Bundle content digest (sha256:...) of the release to get, instead of a release id
  -h, --help                   help for get
      --oci-reference string   OCI reference of the release to get: the "latest" tag or a manifest digest (sha256:...)
  -o, --output string          Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --quiet                  No default output.
      --select string          Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels"
      --verbose                Detailed output, additive with default output

Options inherited from parent commands

      --component string   the Component of --variant, when that names the variant alone; --variant <component>/<variant> says the same in one flag
      --context string     The context to use for this command
      --debug              Debug output
      --space string       space to operate in, by slug or UUID. Omitted, a list or bulk operation spans the organization and a single entity is named as <space>/<slug>
      --variant string     variant to operate in, as <component>/<variant>, or as <variant> with --component: the space naming that Component whose Variant label is <variant>. The same scope as --space, named by what it is rather than by the space's slug; the two cannot be combined

SEE ALSO