cub release update

Update a release

Synopsis

Update a release, identified by its globally-unique release ID.

Only a release's labels, annotations, and delete gates can be updated. The bundled configuration a release was published with is fixed, and so is the name it is stored under -- the release's OCI manifest records that -- and whether it is published: use cub release withdraw to take a release out of service, and publish a new release to change what is bundled or what the bundle is called.

The release is located by its ID regardless of which Space it lives in, so --space is not required (a Release lives in its bundled Units' Space, which need not be the caller's default).

By default the release is read and sent back with the requested changes applied. Pass --patch to send just the changes instead, which is also what removes a label, annotation, or delete gate: --label key=- --annotation key=- --delete-gate name=-.

Examples:

  # Label a release
  cub release update 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c --label environment=production

  # Gate a release against deletion
  cub release update 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c --delete-gate retention/30-days

  # Clear that gate again
  cub release update --patch 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c --delete-gate retention/30-days=-

  # Update from a file
  cub release update 61f26b06-3c34-4363-8b9d-7d0a7c2b5f1c --filename release.yaml

cub release update <release-id> [flags]

Options

      --annotation strings    annotations in key=value format; can separate by commas and/or use multiple instances of the flag
      --delete-gate strings   delete gates in key[=true] format; can separate by commas and/or use multiple instances of the flag
      --filename string       Read the ConfigHub entity JSON from file, URL (https://), or stdin (-); mutually exclusive with --from-stdin
      --from-stdin            Read the ConfigHub entity JSON (e.g., retrieved with cub <entity> get --quiet --json) from stdin; merged with command arguments on create, and merged with command arguments and existing entity on update
  -h, --help                  help for update
      --label strings         labels in key=value format; can separate by commas and/or use multiple instances of the flag
  -o, --output string         Output format. One of: json, yaml, name, wide, mutations, jq=<expr>, yq=<expr>, custom-columns=<spec>
      --patch                 use the patch API, sending only the changes; required to remove a label, annotation, or delete gate
      --quiet                 No default output.
      --replace               Replace entity instead of merging when using --from-stdin or --filename
      --verbose               Detailed output, additive with default output

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output
      --space string     space ID to perform command on

cub release update