Zum Inhalt springen
Trainingslager IT-Trainingslager

Anhang A: Spickzettel

Alles Wichtige aus Tag 0–15 auf wenigen Seiten. Die Zahl in Klammern ist der Tag, an dem du es geübt hast. Im Zweifel gelten ranchermanager.docs.rancher.com, fleet.rancher.io, docs.rke2.io, docs.k3s.io und kubectl explain <typ>.<feld>.

Tagesstart und Gelände

source ~/rancher-lab/setup/env.sh                 # LAB, VM-Adressen aus vms.env (0, 2)
export KUBECONFIG="$LAB/kube/rancher.yaml"         # local-Cluster = Rancher (3)
kubectl --kubeconfig "$LAB/kube/werk.yaml" …       # Ziel-Cluster über Rancher (5)
R="https://rancher.$RANCHER.sslip.io"
H="Authorization: Bearer $(cat "$LAB/rancher-token")"     # API-Token (5)
Befehl Zweck Tag
rdctl start --container-engine.name=containerd … Rancher Desktop ohne Fenster starten 0
nerdctl --namespace k8s.io build -t notes-api:0.2.0 … Image direkt für k3s bauen 1
curl -sfL https://get.k3s.io mit INSTALL_K3S_VERSION k3s installieren 2
k3s ctr images import datei.tar Images ohne Registry ins Cluster 2
helm install rancher rancher-stable/rancher --set hostname=… Rancher installieren 3

Rancher-Objekte

Objekt Bedeutung Tag
clusters.provisioning.cattle.io (fleet-default) Cluster anlegen oder importieren 4, 5
clusters.management.cattle.io (c-m-…) Ranchers Sicht, Labels für Fleet, k3sConfig 4, 9, 12
clusterregistrationtokens.management.cattle.io Import- und Node-Befehle, Platzhalter {token} 4, 5
machines.cluster.x-k8s.io ein Node eines angelegten Clusters 5
projects.management.cattle.io Projekt mit Quota und Standardwerten 6
projectroletemplatebindings.management.cattle.io Rechte im Projekt 6
globalrolebindings.management.cattle.io globale Rolle, etwa user-base 6
clusterrepos.catalog.cattle.io Helm-Katalog, pro Cluster 7
gitrepos.fleet.cattle.io, clustergroups.fleet.cattle.io GitOps mit Fleet 8, 9
etcdsnapshots.rke.cattle.io etcd-Snapshot eines Clusters 13
backups.resources.cattle.io, restores.resources.cattle.io Rancher sichern 13
tokens.management.cattle.io API-Tokens mit ttl und clusterName 14

API-Aufrufe

# Anmelden und Token speichern (5)
curl -sk -X POST "$R/v3-public/localProviders/local?action=login" \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"…","responseType":"json"}' | jq -r .token
# kubeconfig für ein Cluster (5)
curl -sk -X POST -H "$H" "$R/v3/clusters/$ID?action=generateKubeconfig" | jq -r .config
# Benutzer anlegen (6)
curl -sk -X POST -H "$H" -H 'Content-Type: application/json' "$R/v3/users" -d '{…}'
# App installieren oder aktualisieren (7)
API="$R/k8s/clusters/$ID/v1/catalog.cattle.io.clusterrepos/<repo>"
curl -sk -X POST -H "$H" -H 'Content-Type: application/json' "$API?action=install" \
  -d '{"charts":[{"chartName":…,"version":…,"releaseName":…,"values":{…}}],
       "namespace":…,"wait":true,"timeout":"600s"}'
# Versionen, die Rancher kennt (12)
curl -sk -H "$H" "$R/v1-rke2-release/releases" | jq -r '.data[].id'

Felder im Cluster-Objekt

Feld Wirkung Tag
spec.kubernetesVersion, rkeConfig.machineGlobalConfig Version und RKE2-Konfiguration 5
rkeConfig.registries.configs.<host> Login und CA für Registries (caBundle: base64-PEM) 7
rkeConfig.upgradeStrategy.workerDrainOptions Drain vor dem Upgrade 12
rkeConfig.etcdSnapshotCreate.generation Snapshot anfordern 13
rkeConfig.etcdSnapshotRestore {name, generation, restoreRKEConfig} Restore 13
localClusterAuthEndpoint.enabled direkter Kontext ohne Rancher 14
defaultPodSecurityAdmissionConfigurationTemplateName Pod Security für das Cluster 14

Fleet

# fleet.yaml (8, 9)
defaultNamespace: notes
helm:
  releaseName: notes
  repo: https://gitea…/api/packages/lab/helm      # oder chart: oci://…
  chart: notes
  version: 0.3.1
  values: {…}
targetCustomizations:
  - name: k3s
    clusterSelector: {matchLabels: {provider.cattle.io: k3s}}
    helm: {values: {…}}
GitRepo-Feld Zweck Tag
targets: [{clusterName}] oder [{clusterGroup}] wohin 8, 9
clientSecretName, helmSecretName, caBundle Zugang zu Git und Helm-Repo 8
correctDrift.enabled Handänderungen zurücksetzen 8
paused Commits lesen, nicht anwenden 8
paths nur diese Ordner (ohne: das ganze Repo) B
forceSyncGeneration Abgleich erzwingen B

Fehlerbilder

Symptom Ursache Fix
cluster not found or invalid token beim Import {token} nicht ersetzt Token aus Secret crt-token-default-token (4)
READY true, Maschinen Provisioning Spalte zu früh grün Condition Ready abwarten (5)
Pods fehlen, serviceaccount "notes" not found Plattform-Teil fehlt namespace.yaml zuerst (1, 2)
Namespace unsichtbar für Projektmitglied ohne projectId-Annotation angelegt mit Annotation anlegen (6)
Quota 0/0 im neuen Namespace Projektbudget erschöpft Budget oder Anteil anpassen (6)
x509: malformed certificate am ClusterRepo PEM statt DER openssl x509 -outform der (7)
ClusterRepo in werk unsichtbar im local-Cluster angelegt im Ziel-Cluster anlegen (7)
db-0 Pending, Helm Timeout keine StorageClass local-path oder Longhorn vorher (7)
GitRepo Modified Handänderung im Cluster correctDrift (8)
Label wirkt nicht bei importiertem Cluster nur am Provisioning-Objekt am Management-Cluster setzen (9)
updates to statefulset spec … are forbidden StorageClass geändert Default-StorageClass, Backup/Restore (10)
Grafana „Page not found“ über Rancher Proxy-Pfad kubectl port-forward (11)
GitPolling=False commit not found for branch falscher Zweig spec.branch (15)
2/2, aber Commit wirkt nicht Build-Job gescheitert oder paused Job-Log, WaitApplied (15)
db-0 hängt nach etcd-Restore Volume noch am alten Node Pod löschen (13)
ServiceUnavailable über Rancher Rancher weg Kontext werk-werk1 (14)
local-path-PVC Pending unter restricted Hilfs-Pod nicht gehärtet Longhorn oder Ausnahme (14, 15)