Zum Inhalt springen
Trainingslager IT-Trainingslager

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 init erzeugt Zertifikate, kubeconfigs und die Control-Plane als Static Pods.
  • Ohne CNI-Plugin bleiben die Nodes NotReady und CoreDNS Pending.
  • kubeadm join hä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/16

Erwartet (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-system

Erwartet:

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.yaml

Erwartet (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 tigerastatus

Erwartet:

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 tigerastatus Meldungen wie the 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-command

Erwartet:

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 wide

Erwartet (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/manifests

Erwartet:

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.yaml

Erwartet:

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

Erwartet (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 subjectAltName

Erwartet:

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 wide

Erwartet (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 web

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Erzeuge einen neuen Join-Befehl für einen Worker. Zeitziel: 15 s
  2. Zeige die Taints von cp1. Zeitziel: 30 s
  3. 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 nodes

Erwartet: drei Nodes, alle Ready, Version v1.36.6.

kubectl get pods -n kube-system --field-selector=status.phase!=Running

Erwartet: No resources found in kube-system namespace.

kubectl get tigerastatus calico

Erwartet: 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.yaml

Erwartet:

    - --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/manifests anlegen, ändern oder verschieben – das kubelet reagiert innerhalb von Sekunden. Prüfungsaufgaben fragen das gern ab.
  • kubeadm token create --print-join-command merken; 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 init gehört in eine Konfigurationsdatei (--config), die versioniert wird.
  • Bootstrap-Tokens kurz halten (--ttl) und nach dem Join löschen.
  • super-admin.conf und ca.key gehören in einen Tresor, nicht auf die Node-Platte.