Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände

Ziel: Eine VM mit Single-Node-k3s, den Werkzeugen sops, age, helm und yq und einem privaten Git-Repo auf einem eigenen Forgejo – der Ort, an dem ab morgen verschlüsselte Secrets landen. · Dauer: ca. 60 min · Voraussetzung: Ubuntu-24.04-VM mit 4 vCPU und 8 GB RAM

Briefing

  • Das ganze Buch läuft auf einer VM argo (172.16.0.182), Benutzer ubuntu. Sie ist Arbeitsplatz und Cluster zugleich. Arbeitsordner: ~/sops/tagNN/.
  • Das Git-Repo lab/secrets liegt auf einem eigenen Forgejo im Cluster, nicht auf GitHub. So sieht dein Labor genau das, was ein Angreifer mit Leserecht aufs Repo sehen würde – und Flux und Argo CD (Tag 10 und 11) klonen es später clusterintern.
  • Jedes Werkzeug kommt als Binärdatei für deine Architektur, mit Prüfsumme, nie per curl | sh aus fremder Quelle (k3s ist die eine dokumentierte Ausnahme).
                 VM argo 172.16.0.182 (4 vCPU, 7,7 GiB)
 ┌─────────────────────────────────────────────────────────────────┐
 │ Arbeitsplatz: sops, age, helm, yq, git   ~/sops/repo            │
 │ k3s v1.37.2  (:6443)   local-path (Default-StorageClass)        │
 │   forgejo  NodePort :30300   Repo lab/secrets (privat)          │
 └─────────────────────────────────────────────────────────────────┘

Drill 1: Die VM prüfen

Bevor du installierst, schaust du nach, was schon da ist.

# auf argo
free -m
nproc
df -h / | tail -1
ss -tlnp | grep -E ':(80|443|6443|30300|30820) ' ; echo "Treffer: $?"

Erwartet:

               total        used        free      shared  buff/cache   available
Mem:            7941         477        7025           2         708        7463
Swap:              0           0           0
4
/dev/sda1        77G  4.5G   72G   6% /
Treffer: 1

Treffer: 1 heißt: grep hat nichts gefunden, die Ports für k3s (6443), Traefik (80, 443), Forgejo (30300) und OpenBao (30820, Tag 7) sind frei.

Tipp: Auf der Labor-VM des Buchs liegen Reste anderer Bücher (ein gestopptes PostgreSQL, ~/debug). Das Buch fasst sie nicht an. Auf deiner VM brauchst du sie nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 2: k3s gepinnt installieren

# auf argo
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.37.2+k3s1 sh -s - \
  --write-kubeconfig-mode 600 --disable metrics-server
sleep 60
sudo k3s kubectl get nodes
sudo k3s kubectl get pods -A

Erwartet (gekürzt):

[INFO]  Using v1.37.2+k3s1 as release
[INFO]  Verifying binary download
[INFO]  Installing k3s to /usr/local/bin/k3s
[INFO]  Creating /usr/local/bin/kubectl symlink to k3s
[INFO]  systemd: Starting k3s
NAME   STATUS   ROLES           AGE   VERSION
argo   Ready    control-plane   61s   v1.37.2+k3s1
NAMESPACE     NAME                                      READY   STATUS      RESTARTS
kube-system   coredns-577d995dff-5q7ss                  1/1     Running     0
kube-system   helm-install-gateway-api-crd-7m484        0/1     Completed   0
kube-system   helm-install-traefik-crd-4p7q8            0/1     Completed   0
kube-system   helm-install-traefik-qxln5                0/1     Completed   2
kube-system   local-path-provisioner-56c6584955-f8nz9   1/1     Running     0
kube-system   svclb-traefik-e9cd5754-h8xwp              2/2     Running     0
kube-system   traefik-68df944ff7-ws7ds                  0/1     Running     0

--write-kubeconfig-mode 600 lässt die Admin-kubeconfig nur für root lesbar – das ist ein Zugang mit vollen Rechten auf alle Secrets im Cluster. metrics-server braucht das Buch nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 3: kubeconfig und Kontext sops-lab

# auf argo
mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown ubuntu: ~/.kube/config
chmod 600 ~/.kube/config
echo 'export KUBECONFIG=$HOME/.kube/config' >> ~/.bashrc
export KUBECONFIG=$HOME/.kube/config
kubectl config rename-context default sops-lab
kubectl config get-contexts
kubectl get nodes

Erwartet:

Context "default" renamed to "sops-lab".
CURRENT   NAME       CLUSTER   AUTHINFO   NAMESPACE
*         sops-lab   default   default
NAME   STATUS   ROLES           AGE   VERSION
argo   Ready    control-plane   78s   v1.37.2+k3s1

Das kubectl von k3s liest ohne KUBECONFIG immer /etc/rancher/k3s/k3s.yaml – und darf das als ubuntu nicht. Mit der Variable lesen kubectl und Helm dieselbe Datei.

Fortschritt speichern? Kostenlos registrieren

Drill 4: sops, age, helm und yq

sops und Helm veröffentlichen Prüfsummen, yq eine Datei mit mehreren Hash-Arten. age liefert keine Prüfsummendatei, sondern Transparenz-Nachweise (.proof, Sigsum) – hier reicht der Download über HTTPS von der offiziellen Release-Seite.

# auf argo
mkdir -p ~/sops/tag00 && cd ~/sops/tag00
ARCH=$(dpkg --print-architecture)
S=https://github.com/getsops/sops/releases/download/v3.13.3
curl -fsSLO $S/sops-v3.13.3.linux.$ARCH
curl -fsSLO $S/sops-v3.13.3.checksums.txt
grep " sops-v3.13.3.linux.$ARCH$" sops-v3.13.3.checksums.txt | sha256sum -c
sudo install -m 0755 sops-v3.13.3.linux.$ARCH /usr/local/bin/sops
A=https://github.com/FiloSottile/age/releases/download/v1.3.2
curl -fsSLO $A/age-v1.3.2-linux-$ARCH.tar.gz
tar -xzf age-v1.3.2-linux-$ARCH.tar.gz
ls age
sudo install -m 0755 age/age age/age-keygen age/age-inspect /usr/local/bin/

Erwartet:

sops-v3.13.3.linux.amd64: OK
LICENSE
age
age-inspect
age-keygen
age-plugin-batchpass
age-plugin-pq
age-plugin-tag
age-plugin-tagpq

age 1.3 bringt neben age und age-keygen ein Werkzeug age-inspect und mehrere Plugins mit. Ubuntu 24.04 hat per apt nur age 1.1.1 – ohne age-inspect und ohne Post-Quanten-Schlüssel (Tag 1).

# auf argo
cd ~/sops/tag00
ARCH=$(dpkg --print-architecture)
H=v4.3.2
curl -fsSLO https://get.helm.sh/helm-$H-linux-$ARCH.tar.gz
curl -fsSLO https://get.helm.sh/helm-$H-linux-$ARCH.tar.gz.sha256sum
sha256sum -c helm-$H-linux-$ARCH.tar.gz.sha256sum
tar -xzf helm-$H-linux-$ARCH.tar.gz
sudo install -m 0755 linux-$ARCH/helm /usr/local/bin/helm
Y=https://github.com/mikefarah/yq/releases/download/v4.54.3
curl -fsSLo yq $Y/yq_linux_$ARCH
curl -fsSLo yq-checksums $Y/checksums
grep "^yq_linux_$ARCH " yq-checksums | grep -c "$(sha256sum yq | cut -d' ' -f1)"
sudo install -m 0755 yq /usr/local/bin/yq
sudo apt-get install -y git jq >/dev/null
sops --version --disable-version-check
age --version
helm version --short
yq --version

Erwartet:

helm-v4.3.2-linux-amd64.tar.gz: OK
1
sops 3.13.3
v1.3.2
v4.3.2+g8346aaa
yq (https://github.com/mikefarah/yq/) version v4.54.3

Die 1 heißt: Die SHA-256-Summe von yq steht in der Zeile für yq_linux_amd64.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Forgejo im Cluster

Forgejo ist ein schlanker Git-Server. Das rootless-Image gibt es für amd64 und arm64; SQLite als Datenbank, Daten auf einem local-path-Volume, die Weboberfläche und Git über HTTP auf NodePort 30300.

# auf argo
cd ~/sops/tag00
cat > forgejo.yaml <<'EOF'
apiVersion: v1
kind: Namespace
metadata: {name: forgejo}
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata: {name: forgejo-data, namespace: forgejo}
spec:
  accessModes: [ReadWriteOnce]
  resources: {requests: {storage: 2Gi}}
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: forgejo, namespace: forgejo}
spec:
  replicas: 1
  strategy: {type: Recreate}
  selector: {matchLabels: {app: forgejo}}
  template:
    metadata: {labels: {app: forgejo}}
    spec:
      securityContext: {fsGroup: 1000}
      containers:
      - name: forgejo
        image: codeberg.org/forgejo/forgejo:17.0.2-rootless
        env:
        - {name: FORGEJO__security__INSTALL_LOCK, value: "true"}
        - {name: FORGEJO__server__ROOT_URL, value: "http://172.16.0.182:30300/"}
        - {name: FORGEJO__database__DB_TYPE, value: sqlite3}
        - {name: FORGEJO__service__DISABLE_REGISTRATION, value: "true"}
        ports: [{containerPort: 3000, name: http}]
        readinessProbe:
          httpGet: {path: /api/healthz, port: http}
        volumeMounts:
        - {name: data, mountPath: /var/lib/gitea}
        - {name: data, mountPath: /etc/gitea, subPath: conf}
      volumes:
      - name: data
        persistentVolumeClaim: {claimName: forgejo-data}
---
apiVersion: v1
kind: Service
metadata: {name: forgejo-http, namespace: forgejo}
spec:
  type: NodePort
  selector: {app: forgejo}
  ports: [{port: 3000, targetPort: http, nodePort: 30300, name: http}]
EOF
kubectl apply -f forgejo.yaml
kubectl -n forgejo rollout status deploy/forgejo --timeout=180s
kubectl -n forgejo get pods,svc

Erwartet:

namespace/forgejo created
persistentvolumeclaim/forgejo-data created
deployment.apps/forgejo created
service/forgejo-http created
Waiting for deployment "forgejo" rollout to finish: 0 of 1 updated replicas are ...
deployment "forgejo" successfully rolled out
NAME                           READY   STATUS    RESTARTS   AGE
pod/forgejo-7478d756d7-l4f7t   1/1     Running   0          32s

NAME                   TYPE       CLUSTER-IP    EXTERNAL-IP   PORT(S)          AGE
service/forgejo-http   NodePort   10.43.52.65   <none>        3000:30300/TCP   32s

INSTALL_LOCK=true überspringt den Einrichtungs-Assistenten im Browser, die FORGEJO__abschnitt__SCHLÜSSEL-Variablen landen in der app.ini. Selbstregistrierung ist aus: Benutzer legt nur der Admin an.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Benutzer und privates Repo

# auf argo
kubectl -n forgejo exec deploy/forgejo -- forgejo admin user create \
  --username lab --password lab-forgejo-123 --email [email protected] --admin \
  --must-change-password=false
curl -s -u lab:lab-forgejo-123 -H 'Content-Type: application/json' \
  -d '{"name":"secrets","private":true,"default_branch":"main"}' \
  http://172.16.0.182:30300/api/v1/user/repos | jq -r '.full_name, .clone_url'

Erwartet:

New user 'lab' has been successfully created!
lab/secrets
http://172.16.0.182:30300/lab/secrets.git

Das Passwort lab-forgejo-123 ist ein Laborwert. Privat heißt: Ohne Anmeldung ist das Repo unsichtbar. Das schützt Secrets trotzdem nicht – jeder mit Leserecht, jeder Fork, jedes Backup und jeder CI-Runner hat die ganze Historie.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Klonen und der erste Push

# auf argo
git config --global user.name "Lab Admin"
git config --global user.email [email protected]
git config --global init.defaultBranch main
git config --global credential.helper store
printf 'http://lab:[email protected]:30300\n' > ~/.git-credentials
chmod 600 ~/.git-credentials
cd ~/sops
git clone http://172.16.0.182:30300/lab/secrets.git repo
cd repo
printf '# lab/secrets\n\nÜbungsrepo für SOPS zum Anfassen.\n' > README.md
git add README.md
git commit -m "tag00: README"
git push -u origin main

Erwartet (gekürzt):

Cloning into 'repo'...
warning: You appear to have cloned an empty repository.
[main (root-commit) cbb84ec] tag00: README
 1 file changed, 3 insertions(+)
 create mode 100644 README.md
To http://172.16.0.182:30300/lab/secrets.git
 * [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

Achtung: credential.helper store legt das Passwort im Klartext in ~/.git-credentials ab. Im Labor mit einem Laborwert in Ordnung, auf deinem Arbeitsrechner nimm einen Credential-Manager oder SSH-Schlüssel – das Problem dieses Buchs beginnt genau hier: Geheimnisse in Klartextdateien.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zähle alle Pods im Cluster. Zeitziel: 15 s
  2. Zeig das Volume von Forgejo mit StorageClass. Zeitziel: 15 s
  3. Zeig die Forgejo-Version aus dem laufenden Pod. Zeitziel: 20 s

Lösung

# auf argo
kubectl get pods -A --no-headers | wc -l
kubectl -n forgejo get pvc -o custom-columns=NAME:.metadata.name,\
STATUS:.status.phase,SC:.spec.storageClassName
kubectl -n forgejo exec deploy/forgejo -- forgejo --version | cut -c1-60

Erwartet:

8
NAME           STATUS   SC
forgejo-data   Bound    local-path
forgejo version 17.0.2+gitea-1.22.0 (release name 17.0.2) bu

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf argo
kubectl get nodes
kubectl -n forgejo get deploy
curl -s -o /dev/null -w '%{http_code}\n' http://172.16.0.182:30300/api/healthz

Erwartet:

NAME   STATUS   ROLES           AGE    VERSION
argo   Ready    control-plane   3m1s   v1.37.2+k3s1
NAME      READY   UP-TO-DATE   AVAILABLE   AGE
forgejo   1/1     1            1           63s
200
# auf argo
cd ~/sops/repo && git status -sb
which sops age age-keygen age-inspect helm yq kubectl

Erwartet:

## main...origin/main
/usr/local/bin/sops
/usr/local/bin/age
/usr/local/bin/age-keygen
/usr/local/bin/age-inspect
/usr/local/bin/helm
/usr/local/bin/yq
/usr/local/bin/kubectl

Challenge

Beweise ohne Browser, dass das Repo wirklich privat ist: ein Git-Zugriff und ein API-Aufruf ohne Anmeldung müssen scheitern, mit Anmeldung meldet die API private: true.

Hinweis: Der Credential-Helper meldet dich sonst still an – schalte ihn für einen Befehl mit git -c ab.

Lösung

# auf argo
GIT_TERMINAL_PROMPT=0 git -c credential.helper= ls-remote \
  http://172.16.0.182:30300/lab/secrets.git 2>&1 | head -1
curl -s -o /dev/null -w '%{http_code}\n' \
  http://172.16.0.182:30300/api/v1/repos/lab/secrets
curl -s -u lab:lab-forgejo-123 \
  http://172.16.0.182:30300/api/v1/repos/lab/secrets | jq .private

Erwartet (Zeile umbrochen):

fatal: could not read Username for 'http://172.16.0.182:30300': terminal prompts
  disabled
404
true

Forgejo antwortet anonym mit 404, nicht 403 – es verrät nicht einmal, dass es das Repo gibt.

Fortschritt speichern? Kostenlos registrieren

Interview-Notiz

  • Warum reicht ein privates Repo nicht für Secrets? Leserechte sind breit verteilt (Team, CI, Forks, Backups, Spiegel), und Git vergisst nichts: Ein einmal committeter Klartext bleibt in der Historie, auch nach dem Löschen.
  • Warum Werkzeuge mit Prüfsumme installieren? Ein Verschlüsselungswerkzeug sieht jeden Klartext – ein manipuliertes Binary wäre der perfekte Angriff.

Enterprise-Notiz

  • Git-Server mit SSO, erzwungener Zwei-Faktor-Anmeldung und Audit-Log; Zugänge für CI und GitOps als Deploy-Keys oder Tokens mit Nur-Lese-Recht pro Repo.
  • Werkzeugversionen zentral pinnen (Container-Image für CI, Paket-Spiegel), damit alle mit derselben sops-Version arbeiten.
  • Die Admin-kubeconfig eines Clusters ist selbst ein Secret: nie ins Repo, nie in Tickets.