Skip to main content

wf create cluster

wf create cluster

Create a kubernetes cluster in the workspace


Lets you provision a kubernetes cluster in the workspace. The cluster itself is provisioned from a predefined plan (a template). You can view plans available to you by running:

$ wf get plans

Once the cluster is built, members of your workspace can get access by running:

$ wf login

wf create cluster [flags]


# Retrieve a list of all the plans available to you:
$ wf get clusterplans

# See the detail of a specific plan:
$ wf get clusterplans <name> -o yaml

# See the possible cloud access configuration available to your workspace:
$ wf get cloudaccessconfigs -w my_workspace

# Create a single nonprod cluster named dev:
$ wf -w my_workspace create cluster dev --plan gke --stage nonprod --cloud-access cloud_access_config_name

# Check the status of the cluster named dev:
$ wf -w my_workspace get cluster dev -o yaml

# Create a cluster and share it with other workspaces
$ wf -w my_workspace create cluster dev --allocate-all
$ wf -w my_workspace create cluster dev --allocate workspace1,workspace2

# If you only have the one allocated cloud access config for a cloud provider in your
# workspace you do not need to specify --cloud-access / -a. It will be automatically
# selected for you:
$ wf -w my_workspace create cluster dev --plan gke

# Once the cluster is created, use the access cluster command to use it.
# By default all access to clusters is short-lived, you must assume a set
# of permissions before working with clusters. This will modify
# ${HOME}/.kube/config with the connection details, allowing you to
# use 'kubectl' to interact with it:
$ wf access cluster -w my_workspace


      --allocate strings         list of workspaces to allocate to, e.g. workspace1,workspace2
--allocate-all make this cluster available to all workspaces
-a, --cloud-access string Name of the cloud access config to use for this cluster
-d, --description string A short description for the cluster
--dry-run Shows the resource but does not apply or create (defaults: false)
-h, --help help for cluster
-p, --plan string Cluster plan that this cluster will be templated from
--service-account string Secret name holding the service account details
-T, --show-time Shows the time it took to successfully provision a new cluster
-s, --stage string The stage for this cluster

Options inherited from parent commands

      --debug              Debug / trace logging (default: false)
--force Force operation to happen (default: false)
--no-wait Do not wait for resources to provision
-o, --output string Output format of the resource (json,yaml,table,template) (default "table")
--profile string Use a profile other than your current - to change current: wf use profile NAME
--show-headers Display headers on table out (default true)
--verbose Verbose logging (default: false)
-w, --workspace string Workspace to use