Skip to main content

Create a CKS Cluster

Create and access CKS Clusters

Create a Cluster using the Cloud Console

CKS Clusters are created using the Cloud Console. To create a new Cluster, open the Cloud Console dashboard. The Cluster dashboard is the home page of the Cloud Console, and the first dashboard shown. From here, you can view and manage deployed Clusters, or create new ones.

Cluster statuses

The three cards at the top of the page provide information about the status of your current clusters:

Card nameDescription
QuotaDisplays the number of Clusters your organization has deployed over the upper limit of Clusters it is allowed to create (via its quota). Represented as count/quota. If you have not yet created any Clusters, and you have no quota assigned, the status presented is No Quota.
HealthyDisplays the number of healthy Clusters deployed. In a healthy cluster, all control plane elements, servers, and Pods are in a healthy state. The Cluster is stable and responsive, and can manage workloads.
UnhealthyDisplays the number of unhealthy clusters. A Cluster can be unhealthy for many reasons, including control plane issues, unresponsive nodes, failing pods, network failures, or storage problems.

If you do not yet have any clusters, this dashboard will be empty. To begin creating a Cluster, click the Create Cluster button to open the Cluster creation form.

The Cluster creation form has two parts. The left side of the form is a simple GUI form, while on the right side is a corresponding YAML editor. As you enter values into the dashboard, the values update accordingly in the YAML editor. You can also edit the YAML directly to adjust the Cluster configuration.

ValueTypeDescription
NameStringThe name of the Cluster. Cluster names must begin and end with a letter or number, such as foo123.
RegionDropdownThe Region where the Cluster deploys, such as US-EAST-04
VersionDropdownThe Cluster's Kubernetes version. All supported versions of Kubernetes are listed in this dropdown menu.
LabelsDictionaryThe key-value pairs for any desired Kubernetes labels.

After completing the form, click the Submit button at the bottom of the form to begin creating the Cluster.

The main Cluster creation dashboard page shows the new Cluster in the Provisioning state.

When a Cluster is ready, its status changes to Healthy. If there are configuration or deployment issues, the Cluster's status changes to Unhealthy.

View Cluster manifests

Clicking the vertical ellipses menu beside the Cluster name provides additional options for that Cluster, including the View Details option. Clicking this will show the Cluster's current manifest, as well as its age, location, name, and state. To return to the dashboard, close the panel.