akuity_argocd_cluster_create

akuity argocd cluster create

Create a cluster

Synopsis

Create a cluster.

With --upsert, an existing cluster of the same name is updated instead: only the settings given by flags are changed and every other setting of the cluster is preserved. A setting cannot be cleared by omitting its flag (e.g. leaving out --label keeps the labels); an explicitly passed value, such as an empty kustomization file, is applied. Labels, annotations, the project and the kustomization are cleared by passing them empty (--label '', --annotation '', --project '', an empty kustomization file); an empty --version or --namespace is not applied and the stored value is kept. Registry flags given without --kustomization-path only set their image rules and keep the cluster's other image rules and patches.

With --upsert --force --version the server-side upsert is used, which keeps the same merge but cannot clear labels, annotations or the project, nor turn --namespace-scoped off. On an Akuity Platform that predates partial cluster updates, --upsert falls back to the server-side upsert, which there resets every setting not given by flags. Updating an existing cluster needs the update action on clusters. With the get action as well, the CLI reads the cluster and patches it; without get, the server-side upsert merges instead, which cannot clear settings, and registry flags without --kustomization-path replace the kustomization.

akuity argocd cluster create [flags]

Examples

akuity argocd cluster create \
  --organization-name=<name> \
  --instance-name=<name> \
  <cluster-name>

Options

      --agent-size string                       Agent size (One of small,medium,large,auto) (default "small")
      --akuity-custom-image-registry string     Custom image registry for Akuity images
      --annotation stringArray                  Cluster annotation (e.g. --annotation 'key1' or 'key1=value1')
      --argoproj-custom-image-registry string   Custom image registry for Argoproj images
      --datadog-annotations                     Enable Datadog annotations on the cluster agent
      --disable-auto-update                     Disable automatic updates of agent components
      --disable-auto-upgrade                    Disable automatic updates of agent components (DEPRECATED: use --disable-auto-update instead)
      --force                                   Disables optional cluster settings validation
  -h, --help                                    help for create
      --instance-id string                      ArgoCD instance ID
      --instance-name string                    ArgoCD instance name
      --kustomization-path string               Path to kustomization.yaml that contains cluster agent kustomization
      --label stringArray                       Cluster label (e.g. --label 'key1' or 'key1=value1')
  -n, --namespace string                        Target namespace (default "akuity")
      --namespace-scoped                        Namespace scoped cluster installation
      --org-id string                           Alias for organization-id
      --org-name string                         Alias for organization-name
      --organization-id string                  Akuity cloud organization ID
      --organization-name string                Akuity cloud organization name
  -o, --output string                           Output format. One of (json, yaml, wide) (default "wide")
      --project string                          Argo CD Project cluster belongs to
      --redis-tunneling                         Tunnels agent redis connection instead of using a direct connection (default 'false')
      --state-replication                       Enables agent state replication (default 'false')
      --upsert                                  Update if exists; only the flags given are changed, other settings are preserved (an explicitly empty value clears a setting)
      --version string                          Desired cluster agent target version

Options inherited from parent commands

      --insecure-skip-tls-verify   If true, the server's certificate will not be checked for validity
      --no-color                   Disable colored output (default true)
      --server string              The server url of the Akuity cloud (default "https://akuity.cloud")