Skip to content

cub changeorder

cub changeorder

ChangeOrder commands

Synopsis

The changeorder subcommands are used to manage change orders.

A ChangeSet names a change within one Space and locks the Units it is open on. A ChangeOrder names the change itself: the ChangeSets a change creates as it is promoted from Space to Space all carry the same ChangeOrderID, which is what lets a fleet be asked where a change has landed.

A ChangeOrder resides in a Space, by convention the one holding the changes to promote, and is bounded by a start and an end Tag created with it. It selects where it is headed with a Filter over Spaces, and names the Link UpdateType to follow (UpgradeUnit, the clone lineage).

Creating one decides what the change is; promoting one takes it into a target:

cub unit update --patch --space my-dev --where "Slug LIKE '%'" \ --upgrade --change-order my-base/release-42 --change-desc "Take release-42"

The change order supplies the range, so units it does not cover are passed over and a unit that has merged past where it starts is an error. A unit short of it merges the revisions before the start first, unmarked, unless --prior-revisions says Skip or Error. It marks what it promoted, so one restore undoes it:

cub unit update --patch --space my-dev --where "Slug LIKE '%'" \ --restore Before:ChangeOrder:my-base/release-42 --change-desc "Roll release-42 back"

Options

      --component string   the Component of --variant, when that names the variant alone; --variant <component>/<variant> says the same in one flag
  -h, --help               help for changeorder
      --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

Options inherited from parent commands

      --context string   The context to use for this command
      --debug            Debug output

SEE ALSO