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) |