Tag 1: kubeadm init und join
Ziel: Ein Cluster aus einer Control-Plane und zwei Workern läuft, mit Calico als Pod-Netz. · Dauer: ca. 60 min · Voraussetzung: Tag 0
Briefing
CKA: „Create and manage Kubernetes clusters using kubeadm” (Teil der 25 %).
kubeadm initerzeugt Zertifikate, kubeconfigs und die Control-Plane als Static Pods.- Ohne CNI-Plugin bleiben die Nodes
NotReadyund CoreDNSPending. kubeadm joinhängt Worker mit einem Bootstrap-Token und dem CA-Hash an.- Danach weißt du, wo jede Komponente liegt – die Grundlage für alles Troubleshooting.
Drill 1: Die Control-Plane initialisieren
Nur auf cp1:
sudo kubeadm init --kubernetes-version=v1.36.6 \
--apiserver-advertise-address=172.16.0.126 \
--pod-network-cidr=192.168.0.0/16Erwartet (gekürzt):
[addons] Applied essential addon: CoreDNS
[addons] Applied essential addon: kube-proxy
Your Kubernetes control-plane has initialized successfully!
...
kubeadm join 172.16.0.126:6443 --token 7fx3pe.4hiaoxeepjqiqkoe \
--discovery-token-ca-cert-hash sha256:74b96a6bf7d68a57229d66b0384ab2d788d64ae7eb...
Warum --pod-network-cidr? Calico verwendet standardmäßig
192.168.0.0/16, und der Controller-Manager verteilt daraus
die Pod-Netze an die Nodes. Das Netz darf sich nicht mit deinem VM-Netz
überschneiden.
Fortschritt speichern? Kostenlos registrieren
Drill 2: kubectl einrichten
mkdir -p $HOME/.kube
sudo cp /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config
kubectl get nodes
kubectl get pods -n kube-systemErwartet:
NAME STATUS ROLES AGE VERSION
cp1 NotReady control-plane 13s v1.36.6
NAME READY STATUS RESTARTS AGE
coredns-589f44dc88-c9tfc 0/1 Pending 0 4s
coredns-589f44dc88-tdzsw 0/1 Pending 0 4s
etcd-cp1 1/1 Running 0 9s
kube-apiserver-cp1 1/1 Running 0 11s
kube-controller-manager-cp1 1/1 Running 0 9s
kube-proxy-85nkd 1/1 Running 0 4s
kube-scheduler-cp1 1/1 Running 0 9s
NotReady und Pending sind hier richtig: Es
fehlt noch das Pod-Netz.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Calico installieren
Calico kommt mit einem Operator. Erst die CRDs, dann der Operator, dann die Konfiguration:
C=https://raw.githubusercontent.com/projectcalico/calico/v3.33.1/manifests
kubectl create -f $C/operator-crds.yaml
kubectl create -f $C/tigera-operator.yaml
kubectl create -f $C/custom-resources.yamlErwartet (letzte Zeilen):
installation.operator.tigera.io/default created
apiserver.operator.tigera.io/default created
goldmane.operator.tigera.io/default created
whisker.operator.tigera.io/default created
Die custom-resources.yaml setzt den IP-Pool auf
192.168.0.0/16 – passend zu Drill 1. Warten, bis alles
verfügbar ist:
kubectl wait --for=condition=Available tigerastatus --all --timeout=300s
kubectl get tigerastatusErwartet:
NAME AVAILABLE PROGRESSING DEGRADED SINCE MESSAGE
apiserver True False False 16s All objects available
calico True False False 66s All objects available
goldmane True False False 6s All objects available
ippools True False False 2m51s All objects available
tiers True False False 11s All objects available
whisker True False False 1s All objects available
Tipp: In den ersten zwei Minuten zeigt
tigerastatusMeldungen wiethe server is currently unable to handle the request. Das ist der Calico-API-Server, der noch startet – abwarten.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Worker anhängen
Das Token aus Drill 1 gilt 24 Stunden. Einen frischen Join-Befehl erzeugst du jederzeit neu:
kubeadm token create --print-join-commandErwartet:
kubeadm join 172.16.0.126:6443 --token 7hfiwr.s013h2vr0prmgukn \
--discovery-token-ca-cert-hash sha256:74b9...
Auf worker1 und worker2 diesen Befehl mit
sudo ausführen:
sudo kubeadm join 172.16.0.126:6443 --token <TOKEN> \
--discovery-token-ca-cert-hash sha256:<HASH>Erwartet (letzte Zeilen):
* The Kubelet was informed of the new secure connection details.
Run 'kubectl get nodes' on the control-plane to see this node join the cluster.
Zurück auf cp1:
kubectl wait --for=condition=Ready nodes --all --timeout=300s
kubectl get nodes -o wideErwartet (gekürzt):
NAME STATUS ROLES VERSION INTERNAL-IP ... CONTAINER-RUNTIME
cp1 Ready control-plane v1.36.6 172.16.0.126 ... containerd://2.4.2
worker1 Ready <none> v1.36.6 172.16.0.228 ... containerd://2.4.2
worker2 Ready <none> v1.36.6 172.16.0.83 ... containerd://2.4.2
Fortschritt speichern? Kostenlos registrieren
Drill 5: Rundgang – Static Pods
Die Control-Plane läuft nicht als Deployment, sondern als Static
Pods: Das kubelet auf cp1 liest Manifeste aus einem
Verzeichnis und startet sie selbst.
sudo grep -E 'staticPodPath|cgroupDriver' /var/lib/kubelet/config.yaml
sudo ls /etc/kubernetes/manifestsErwartet:
cgroupDriver: systemd
staticPodPath: /etc/kubernetes/manifests
etcd.yaml
kube-apiserver.yaml
kube-controller-manager.yaml
kube-scheduler.yaml
Wem gehört der API-Server-Pod?
kubectl get pod -n kube-system kube-apiserver-cp1 \
-o jsonpath='{.metadata.ownerReferences[0].kind}{"\n"}'Erwartet: Node – ein Mirror-Pod.
Löschen über kubectl bringt nichts; ändern oder entfernen
kannst du ihn nur über die Datei im Manifest-Verzeichnis.
Die wichtigsten Flags des API-Servers:
sudo grep -E -- '--(etcd-servers|service-cluster-ip-range)=' \
/etc/kubernetes/manifests/kube-apiserver.yaml
sudo grep -E -- '--(authorization-mode|advertise-address)=' \
/etc/kubernetes/manifests/kube-apiserver.yamlErwartet:
- --etcd-servers=https://127.0.0.1:2379
- --service-cluster-ip-range=10.96.0.0/12
- --advertise-address=172.16.0.126
- --authorization-mode=Node,RBAC
Fortschritt speichern? Kostenlos registrieren
Drill 6: Rundgang – Zertifikate und kubeconfigs
ls /etc/kubernetes
sudo kubeadm certs check-expiration | head -8Erwartet (gekürzt):
admin.conf controller-manager.conf kubelet.conf manifests pki scheduler.conf
super-admin.conf
CERTIFICATE EXPIRES RESIDUAL TIME CERTIFICATE AUTH...
admin.conf Nov 17, 2027 21:11 UTC 364d ca
apiserver Nov 17, 2027 21:11 UTC 364d ca
apiserver-etcd-client Nov 17, 2027 21:11 UTC 364d etcd-ca
Für welche Namen gilt das Zertifikat des API-Servers?
sudo openssl x509 -in /etc/kubernetes/pki/apiserver.crt -noout -ext subjectAltNameErwartet:
X509v3 Subject Alternative Name:
DNS:cp1, DNS:kubernetes, DNS:kubernetes.default, DNS:kubernetes.default.svc,
DNS:kubernetes.default.svc.cluster.local, IP Address:10.96.0.1,
IP Address:172.16.0.126
admin.conf ist deine Admin-kubeconfig,
super-admin.conf ein Notfallzugang, der RBAC umgeht – gut
wegschließen. Zertifikate laufen nach einem Jahr ab (Tag 13).
Fortschritt speichern? Kostenlos registrieren
Drill 7: Rauchtest
kubectl create deployment web --image=nginx:1.29 --replicas=2
kubectl expose deployment web --port=80
kubectl rollout status deployment web
kubectl get pods -o wideErwartet (gekürzt):
deployment "web" successfully rolled out
NAME READY STATUS RESTARTS AGE IP NODE
web-795767664d-7rh28 1/1 Running 0 22s 192.168.235.137 worker1
web-795767664d-sxn8l 1/1 Running 0 22s 192.168.189.66 worker2
Die Pods landen nur auf den Workern: cp1 hat den Taint
node-role.kubernetes.io/control-plane:NoSchedule. Jetzt DNS
und Service testen:
kubectl run test --image=busybox:1.37 --rm -it --restart=Never -- \
sh -c 'nslookup web.default.svc.cluster.local; wget -qO- -T5 web | grep title'Erwartet (gekürzt):
Server: 10.96.0.10
Name: web.default.svc.cluster.local
Address: 10.103.215.8
<title>Welcome to nginx!</title>
Aufräumen:
kubectl delete deployment,service webFortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Erzeuge einen neuen Join-Befehl für einen Worker. Zeitziel: 15 s
- Zeige die Taints von
cp1. Zeitziel: 30 s - Finde Pod- und Service-Netz des Clusters, ohne in Manifeste zu schauen. Zeitziel: 60 s
Lösung
kubeadm token create --print-join-command
kubectl get node cp1 -o jsonpath='{.spec.taints}{"\n"}'
kubectl get cm -n kube-system kubeadm-config \
-o jsonpath='{.data.ClusterConfiguration}' | grep -E 'podSubnet|serviceSubnet'Erwartet:
kubeadm join 172.16.0.126:6443 --token ...
[{"effect":"NoSchedule","key":"node-role.kubernetes.io/control-plane"}]
podSubnet: 192.168.0.0/16
serviceSubnet: 10.96.0.0/12
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
kubectl get nodesErwartet: drei Nodes, alle Ready,
Version v1.36.6.
kubectl get pods -n kube-system --field-selector=status.phase!=RunningErwartet:
No resources found in kube-system namespace.
kubectl get tigerastatus calicoErwartet: AVAILABLE ist
True.
Challenge
Wo speichert etcd seine Daten, und auf welchen Adressen nimmt es Client-Verbindungen an?
Hinweis: etcd ist ein Static Pod.
Lösung
sudo grep -E '^\s+- --(data-dir|listen-client-urls)' /etc/kubernetes/manifests/etcd.yamlErwartet:
- --data-dir=/var/lib/etcd
- --listen-client-urls=https://127.0.0.1:2379,https://172.16.0.126:2379
Das Datenverzeichnis brauchst du in Tag 13 beim etcd-Restore.
Fortschritt speichern? Kostenlos registrieren
Prüfungstipp
- Static Pods: Manifest in
/etc/kubernetes/manifestsanlegen, ändern oder verschieben – das kubelet reagiert innerhalb von Sekunden. Prüfungsaufgaben fragen das gern ab. kubeadm token create --print-join-commandmerken; in der Prüfung ist das Init-Token oft abgelaufen.
Enterprise-Notiz
- Eine einzelne Control-Plane ist ein Single Point of Failure – Produktion braucht drei (Tag 16).
kubeadm initgehört in eine Konfigurationsdatei (--config), die versioniert wird.- Bootstrap-Tokens kurz halten (
--ttl) und nach dem Join löschen. super-admin.confundca.keygehören in einen Tresor, nicht auf die Node-Platte.