Skip to main content
An LKS Cluster is a managed Kubernetes Control Plane plus one or more Node Pools of bare metal Nodes. Latitude.sh runs the Control Plane; you manage the Cluster’s Workloads and Node Pools.

​
Prerequisites

​
Create a Cluster

1

Open Cluster creation

Go to LKS in the sidebar and click Create Cluster.
2

Select a location

Choose the region where the Cluster runs. Plan availability and pricing vary by region.
3

Name the Cluster

Enter a name of 3-63 lowercase letters, numbers, or hyphens, starting and ending with a letter or number. It must be unique within the project.
4

Describe the Cluster (optional)

Add an optional description, up to 200 characters, to record what the Cluster is for.
5

Choose a Kubernetes version

Select the Kubernetes version for the Control Plane. The newest available version is selected by default.
6

Add Node Pools

Add one or more Node Pools. Each Node Pool has a Plan and a number of Nodes, and can carry its own Labels and Taints. See Node Pools for details.
7

Create

Review the hourly price and click Create Cluster. You’re taken to the Cluster overview while it provisions.
The Control Plane is fully managed. You don’t size or access Control Plane Nodes, and no SSH keys are needed to create a Cluster.

​
Cluster status

The Cluster list and overview show the current state:

​
Access the Cluster

Download the kubeconfig from the Cluster Overview tab, under Cluster access:
  • Download kubeconfig: save the file to your machine.
  • Copy to clipboard: copy the kubeconfig contents.
  • View: preview the kubeconfig in the dashboard.
Connect with kubectl:
The kubeconfig is available once the Cluster is Active.

​
Name and description

On the Settings tab you can edit the Cluster’s Name (its display name) and its Description (up to 200 characters).

​
Upgrade the Kubernetes version

Latitude.sh publishes the Kubernetes versions available for upgrade. To upgrade the Control Plane, open the Settings tab. When a newer version is available, the Version row shows Upgrade to {version}; otherwise it shows Up to date.
A Control Plane upgrade can’t be reversed.
Node Pools stay on their current version until you upgrade them, and a Node Pool can run at most one minor version behind the Control Plane. Upgrade each pool after the Control Plane. See Upgrade a Node Pool.

​
Delete a Cluster

Open the Settings tab and click Delete, or use Delete Cluster in the Cluster’s actions menu. Type the Cluster name to confirm.
Deleting a Cluster is permanent. All Node Pools and their Nodes are destroyed, the LoadBalancer IP is released, and all data and Workloads are lost.