chainctl images overlays update

chainctl images overlays update

Update a Custom Assembly overlay’s name or configuration.

Synopsis

Update a Custom Assembly overlay’s name, configuration, or both.

–package and –file replace the stored configuration wholesale; they do not merge with it. Repos the overlay is attached to are rebuilt with the new configuration. An update that would conflict with another overlay attached to the same tags is rejected.

chainctl images overlays update <UID|NAME> [flags]

Examples

  # Rename an overlay
  chainctl images overlays update my-overlay --name my-renamed-overlay

  # Replace an overlay's configuration from a file
  chainctl images overlays update my-overlay -f overlay.yaml

Options

  -f, --file chainctl images repos build   The name of the YAML file containing the overlay configuration, the same shape chainctl images repos build accepts. Replaces the stored config wholesale and takes precedence over --package.
      --name string                        New overlay name.
      --package strings                    Package to include (repeatable). Declares the FULL replacement set; the stored config is replaced wholesale.

Options inherited from parent commands

      --api string         The url of the Chainguard platform API. (default "https://console-api.enforce.dev")
      --audience string    The Chainguard token audience to request. (default "https://console-api.enforce.dev")
      --config string      A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly.
      --console string     The url of the Chainguard platform Console. (default "https://console.chainguard.dev")
      --force-color        Force color output even when stdout is not a TTY.
  -h, --help               Help for chainctl
      --issuer string      The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev")
      --log-level string   Set the log level (debug, info) (default "ERROR")
  -o, --output string      Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide]
  -v, --v int              Set the log verbosity level.

SEE ALSO

• chainctl images overlays - Manage Custom Assembly overlays and the repos they are attached to.