Create a cluster

This guide walks you through creating an LKE (Linode Kubernetes Engine) cluster through Cloud Manager.

  1. Open the Create Kubernetes Cluster Form in Cloud Manager
  2. Set the Label
  3. Select a Region
  4. Choose a Kubernetes Version
  5. Add Node Pools
  6. Optionally Enable High Availability
  7. Deploy the Cluster

Open the create Kubernetes cluster form in Cloud Manager

Log in to Cloud Manager and select Kubernetes from the left navigation menu. Click the Create Cluster button. This opens the Kubernetes Create Cluster form.

Set the label

Within the Cluster Label field, enter the label you wish to use. This label lets you identify it from within Cloud Manager, Linode CLI, and Linode API. The label must be alphanumeric, between 3 and 32 characters, and unique from other cluster labels on your account.

Select a region

Select the region where the LKE cluster will reside. Regions correspond with individual data centers, each located in a different geographical area. All resources attached to your cluster are deployed in the selected region, including nodes (Compute Instances) in the Node Pools, volumes (Block Storage volumes), and load balancers (NodeBalancers). If you haven't yet deployed Compute Instances or chosen a region, select the region closest to you and/or your customers. This helps reduce latency and can make a significant impact in connection speeds and quality.

Choose a Kubernetes version

Next, select the Kubernetes Version you wish to use from the corresponding dropdown list. Only Kubernetes versions that have been approved for LKE are listed. As new versions of Kubernetes are released (and older ones are deprecated), upgrade paths are made available.

Enable high availability (optional)

LKE's HA (high availability) control plane feature is a paid add-on that provides an additional layer of redundancy to the Kubernetes cluster. It creates replicas of the control plane components, eliminating a single point of failure for your cluster and providing a guaranteed uptime of 99.99%. To enable this feature, check the Enable HA Control Plane box in the Cluster Summary section. The HA control plane can also be enabled any time after your cluster has been created.

Screenshot of the Enable HA toggle during cluster creation

🚧

Once the high availability control plane feature has been enabled, it is not possible to remove this feature and downgrade to a non-HA control plane.

Enable the control plane ACL (optional)

You can restrict access to your cluster's control plane components by enabling the control plane ACL feature. When enabled, the default policy for the ACL is DENY, which means that all traffic is blocked unless it originates from one of the IP ranges you've added. By default, this option is enabled. If you wish to disable it, toggle the switch.

If you are enabling the ACL, add any IP addresses that you or your team will use to communicate with this cluster's control plane. Enter an individual IP address or CIDR range into either the IPv4 Addresses or CIDRs and IPv6 Addresses or CIDRs field. Click the Add IPv4 / IPv6 address link to add additional addresses.

Screenshot of the Control Plane ACL section during cluster creation

🚧

It's important to note that this setting only restricts access to the cluster's control plane components, not to any other web applications running on the cluster itself.

Add node pools

Each LKE cluster is created with at least one node pool. Node pools are made up of individual worker nodes, which are run on top of Compute Instances.

📘

Currently, the available plan types for LKE worker nodes include Shared CPU, Dedicated CPU, High Memory, and Premium CPU. The 1 GB Shared CPU plan type (previously called Nanodes) is not available for deployment in an LKE cluster.

In the Add Node Pools section, locate the plan type you wish to use for your first node pool. Enter the number of worker nodes that you wish to be included in the node pool and click the Add button to add that pool to your cluster configuration. You can repeat this process to add additional node pools if desired. Node pools can also be added, resized, and deleted after the cluster has been created.

Screenshot of the Add Node Pools section during cluster creation

Deploy the cluster

Review your cluster's configuration within the Cluster Summary section. This should list each Node Pool that has been added, display the HA control plane selection, and list the monthly cost associated with this cluster. When you are satisfied with the configuration of your cluster, click the Create Cluster button. Your cluster's detail page appears while your cluster is being created. From this page, you can edit your existing Node Pools, access your Kubeconfig file, and view an overview of your cluster's resource details.