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
- On the create wizard's Node groups step for a self-hosted cluster, the Control plane card comes first.
- Under Machine type, select Choose machine and pick one.
- 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
Name
clusterSpec.controlPlane.nodeGroup.nameRequiredThe control plane node group's name.
Accepts
A DNS name, 1 to 50 characters.
Machine type
clusterSpec.controlPlane.nodeGroup.machineTypesRequiredThe 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 nodes
clusterSpec.controlPlane.nodeGroup.minNodeHow many control plane nodes run.
Accepts
An odd number: 1, 3 or 5.
Default
1
Maximum nodes
clusterSpec.controlPlane.nodeGroup.maxNodeAccepts
An odd number, equal to
minNode.Default
1
clusterSpec.controlPlane.nodeGroup.labelsLabels 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.controlPlanein 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.