clusterctl

Initialize management cluster

$ clusterctl init --infrastructure [aws]

$ clusterctl init --infrastructure [aws:v2.0.0]

$ clusterctl generate cluster [mycluster] --kubernetes-version [v1.28.0]

$ clusterctl get kubeconfig [mycluster]

$ clusterctl upgrade apply --contract [v1beta1]

$ clusterctl move --to-kubeconfig [target.kubeconfig]

$ clusterctl delete --infrastructure [aws]

clusterctl command [options]

clusterctl manages Kubernetes Cluster API management clusters. Installs providers, generates cluster templates, and handles lifecycle operations. Transforms Kubernetes clusters into management clusters.

init

Install Cluster API components

Generate cluster template

Process YAML templates

Get workload cluster kubeconfig

Show upgrade recommendations

Apply provider upgrades

Move resources between clusters

Delete providers

Describe cluster resources

--infrastructure provider

Infrastructure provider (aws, azure, vsphere, etc.)

Bootstrap provider

Control plane provider

Target namespace for providers

Core provider version

Config file: ~/.cluster-api/clusterctl.yaml

Set GITHUB_TOKEN to avoid API rate limiting. Requires kubectl configured for target cluster. Uses go proxy for version detection.

kubectl(1), kind(1), kubeadm(1)