Skip to main content

Control plane

A self-hosted cluster runs its own Kubernetes control plane on machines in your account, so you size it like a node group: one machine type, a name and an odd number of nodes. On EKS, GKE and AKS the cloud runs the control plane, and a cluster's manifest has no controlPlane.

Before you start​

  • A self-hosted cluster you are creating: Self-hosted Kubernetes.
  • A machine type the region offers: astroctl cloud aws machines list -r <region>.

In the console​

  1. On the create wizard's Node groups step for a self-hosted cluster, the Control plane card comes first.
  2. Under Machine type, select Choose machine and pick one.
  3. Keep or change the Name, and set Minimum nodes and Maximum nodes: the same odd number, 1, 3 or 5.

You should see​

The dry run on Review passes, and once the cluster is ready its Overview counts the control plane's nodes with the rest.

Settings​

NameclusterSpec.controlPlane.nodeGroup.nameRequired

The control plane node group's name.

Accepts
A DNS name, 1 to 50 characters.
Machine typeclusterSpec.controlPlane.nodeGroup.machineTypesRequired

The machine type the control plane runs on.

Accepts
At least one machine type the region offers.
See
astroctl cloud <aws|gcp> machines list -r <region>
Minimum nodesclusterSpec.controlPlane.nodeGroup.minNode

How many control plane nodes run.

Accepts
An odd number: 1, 3 or 5.
Default
1
Maximum nodesclusterSpec.controlPlane.nodeGroup.maxNode
Accepts
An odd number, equal to minNode.
Default
1
clusterSpec.controlPlane.nodeGroup.labels

Labels on the control plane's nodes.

controlPlane holds one nodeGroup, a single object rather than a list:

YAML
controlPlane:
nodeGroup:
name: control-plane
machineTypes:
- t3.medium
minNode: 1
maxNode: 1

Other ways in​

  • SDK and API: clusterSpec.controlPlane in the cluster manifest. See the API reference.

With astroctl​

Terminal
astroctl cloud aws regions list
astroctl cloud aws regions zones list -r us-west-2
astroctl cloud aws machines list -r us-west-2 --cpuMin 2 --cpuMax 4

Every flag: astroctl cloud.

Next​