Skip to main content
Version: 0.11

Create & Import Your First Cluster Using kubectl

This section will guide you through creating your first cluster and importing it into Rancher Manager using kubectl.

Prerequisites​

Create Your Cluster Definition​

To generate the YAML for the cluster, do the following (assuming the Docker infrastructure provider is being used):

  1. Open a terminal and run the following:
export CONTROL_PLANE_MACHINE_COUNT=1
export WORKER_MACHINE_COUNT=1
export KUBERNETES_VERSION=v1.30.0

clusterctl generate cluster cluster1 \
--from https://raw.githubusercontent.com/rancher-sandbox/rancher-turtles-fleet-example/templates/docker-rke2.yaml \
> cluster1.yaml
  1. View cluster1.yaml to ensure there are no tokens. You can make any changes you want as well.

The Cluster API quickstart guide contains more detail. Read the steps related to this section here.

  1. Create the cluster using kubectl
kubectl create -f cluster1.yaml

Mark Namespace or Cluster for Auto-Import​

To automatically import a CAPI cluster into Rancher Manager, there are 2 options:

  1. Label a namespace so all clusters contained in it are imported.
  2. Label an individual cluster definition so that it's imported.

Labeling a namespace:

kubectl label namespace default cluster-api.cattle.io/rancher-auto-import=true

Labeling an individual cluster definition:

kubectl label cluster.cluster.x-k8s.io cluster1 cluster-api.cattle.io/rancher-auto-import=true