Skip to main content
Version: 1.3

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 plans

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

# See the possible cloud accounts available to your workspace:
$ wf get cloudaccounts -w my_workspace

# Create a single nonprod cluster named dev:
$ wf -w my_workspace create cluster dev --plan gke --stage nonprod --cloud-account cloud_account_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 account for a cloud provider in your
# workspace you do not need to specify --cloud-account / -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-account string Name of the allocated cloud account / org 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 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              Indicates we should use debug / trace logging (default: false)
--force Used to force an operation to happen (default: false)
--no-wait Indicates we should 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 default for this command
--show-headers Indicates we should display headers on table out (default true)
--verbose Enables verbose logging for debugging purposes (default: false)
-w, --workspace string The workspace you are operating within