Imported
Imported: bestehender Cluster,
Registration-Manifest anwenden, cattle-cluster-agent
übernimmt. Rancher verwaltet Zugriff/RBAC, aber keinen
Node-Lifecycle. Ausnahme bei importierten RKE2/K3s: Ist die
Version-Management-Option aktiv (Setting
imported-cluster-version-management, Default
true), installiert Rancher den
system-upgrade-controller samt Plans und steuert
K8s-Version und Upgrade-Strategie. Je Cluster: Global default, True
oder False. Wer RKE2 außerhalb von Rancher upgradet, schaltet
es für den Cluster ab.
Provisioned
Provisioned (Provisioning v2): Rancher
erzeugt Nodes und Cluster über Cluster API (CAPI).
CAPI-Controller kommen über Rancher Turtles
(Chart rancher-turtles, Default seit 2.13,
eingebettetes CAPI seit 2.14 entfernt). CRD
provisioning.cattle.io/v1 Cluster, darunter
rke.cattle.io (RKEControlPlane,
ETCDSnapshot). RKE2/K3s als Distribution. RKE1 (Feld
rancherKubernetesEngineConfig im v3-Cluster): EOL
07/2025, ab Rancher 2.12 entfernt.
Registrierung
Import: kubectl apply -f <registrationURL>.
Custom-Nodes: Registrierungsbefehl aus der UI
(system-agent-install.sh mit --server,
--token und den Rollen-Flags --etcd,
--controlplane, --worker) installiert
rancher-system-agent.
Machine-Pools
machinePools: Node-Gruppen mit
Rollen-Bools
(controlPlaneRole/etcdRole/workerRole)
+ machineConfigRef je Infra-Provider (Amazon EC2,
vSphere, Harvester, …).
apiVersion: provisioning.cattle.io/v1
kind: Cluster
metadata: {name: prod-eu, namespace: fleet-default}
spec:
cloudCredentialSecretName: cattle-global-data:cc-harvester
kubernetesVersion: v1.36.5+rke2r1
rkeConfig:
machinePools:
- name: cp
controlPlaneRole: true
etcdRole: true
quantity: 3
machineConfigRef:
kind: HarvesterConfig
name: cp-medium
- name: worker
workerRole: true
quantity: 4
machineConfigRef:
kind: HarvesterConfig
name: worker-large