Skip to content

cub worker create

cub worker create

Create a worker

Synopsis

Create a bridge worker in your environment. Workers are responsible for executing tasks and managing resources in your infrastructure.

The worker-slug must be unique within a space. Workers can be used to:

  1. Apply configurations to target environments
  2. Monitor and manage resource states

Examples:

  # Create a worker in a space
  cub worker create --space my-space k8s-worker-1

  # Create a worker and run it for the Kubernetes toolchain
  cub worker create --space my-space worker-1
  cub worker run --space my-space worker-1 -t=kubernetes
cub worker create <worker-slug> [flags]

Options

      --allow-exists          Allow creation of resources that already exist
      --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 create
      --is-server-worker      mark this worker as a server-hosted worker
      --label strings         labels in key=value format; can separate by commas and/or use multiple instances of the flag
      --org-role string       organization-level role for the worker (e.g., admin, manager, editor, user, viewer, creator, member, none)
  -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.
      --use-user-identity     server worker operates using the requesting user's identity (requires --is-server-worker)
      --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

SEE ALSO