This page shows you how to create a standard single-zone cluster with the default features enabled in Google Kubernetes Engine (GKE). To enable or configure a specific feature of GKE on the cluster, see the documentation for that feature. You can also read more about the types of clusters you can create.
Before you begin
Before you start, make sure you have performed the following tasks:
- Ensure that you have enabled the Google Kubernetes Engine API. Enable Google Kubernetes Engine API
- Ensure that you have installed the Cloud SDK.
Set up default
gcloud settings using one of the following methods:
gcloud init, if you want to be walked through setting defaults.
gcloud config, to individually set your project ID, zone, and region.
Using gcloud init
If you receive the error
One of [--zone, --region] must be supplied: Please specify
location, complete this section.
gcloud initand follow the directions:
If you are using SSH on a remote server, use the
--console-onlyflag to prevent the command from launching a browser:
gcloud init --console-only
Follow the instructions to authorize
gcloudto use your Google Cloud account.
- Create a new configuration or select an existing one.
- Choose a Google Cloud project.
- Choose a default Compute Engine zone.
Using gcloud config
- Set your default project ID:
gcloud config set project project-id
- If you are working with zonal clusters, set your default compute zone:
gcloud config set compute/zone compute-zone
- If you are working with regional clusters, set your default compute region:
gcloud config set compute/region compute-region
gcloudto the latest version:
gcloud components update
Creating a cluster
The following instructions demonstrate how to create a single-zone cluster
gcloud tool or the Google Cloud Console.
To create a single-zone cluster with the
gcloud command-line tool, use one
of the following commands.
Replace the placeholder values in the commands with the following:
- cluster-name: the name of your new cluster.
- compute-zone: the compute zone in which to create the cluster.
- channel: the type of release channel,
which can be one of
stable. Clusters enrolled in the
rapidchannel are not supported for production workloads.
- version: the version you wish to specify for your cluster.
Using a release channel:
gcloud container clusters create cluster-name \ --zone compute-zone \ --release-channel channel
Using the default version:
gcloud container clusters create cluster-name \ --zone compute-zone
Using a specific version:
gcloud container clusters create cluster-name \ --zone compute-zone \ --cluster-version version
For the full list of optional flags, refer to the
gcloud container clusters
Visit the Google Kubernetes Engine menu in Cloud Console.
Click the Create cluster button.
In the Cluster basics section, complete the following:
From the navigation pane, under Node Pools, click default-pool.
In the Node pool details section, complete the following:
From the navigation pane, under Node Pools, click Nodes.
From the Image type drop-down list, select the desired node image.
Choose the default Machine configuration to use for the instances. Each machine type is billed differently. The default machine type is
e2-medium. For machine type pricing information, refer to the machine type price sheet.
From the Boot disk type drop-down list, select the desired disk type.
Enter the Boot disk size.
After you create a cluster, you need to
before you can interact with the cluster from the command line.
Google Kubernetes Engine previously supported templates for clusters. Those templates were removed from Google Cloud Console, but are still accessible from the following links: