Skip to content

cub component create

cub component create

Create a component

Synopsis

Create a Component entity, which decides which ChangeWorkflows promotions and releases of its Variants may use, and whether one is required.

ChangeWorkflows are addressed as / or by UUID.

Examples:

  # Create a component
  cub component create my-app

  # Create a component that requires one of two ChangeWorkflows to promote and release
  cub component create my-app --change-workflow-required \
    --allowed-change-workflow platform/standard-rollout \
    --allowed-change-workflow platform/hotfix

  # Create a component from a JSON definition
  cub component create my-app --from-stdin < component.json
cub component create <name> [flags]

Options

      --allow-exists                      Allow creation of resources that already exist
      --allowed-change-workflow strings   ChangeWorkflow, as <space>/<slug> or UUID, that promotions and releases may use (can be repeated or comma-separated)
      --annotation strings                annotations in key=value format; can separate by commas and/or use multiple instances of the flag
      --backing-unit-space string         space, by slug or UUID, for the backing Units --with-backing-units creates; required with it, since a Component is in no space of its own
      --change-workflow-required          require a ChangeWorkflow to promote and release
      --delete-gate strings               delete gates in key[=true] format; can separate by commas and/or use multiple instances of the flag
      --dry-run                           report what the command would write, and write nothing
      --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 create
      --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>
      --permission strings                permission in format Action:UserIDOrUsername (e.g., Manage:user@example.com, can be repeated)
      --quiet                             No default output.
      --verbose                           Detailed output, additive with default output
      --with-backing-units                give each Component the bulk operation writes a backing Unit if it has none: a ConfigHub/YAML Unit holding its configuration, kept in step with it

Options inherited from parent commands

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

SEE ALSO