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), Benutzerubuntu. Sie ist Arbeitsplatz und Cluster zugleich. Arbeitsordner:~/sops/tagNN/. - Das Git-Repo
lab/secretsliegt 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 | shaus 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 -AErwartet (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 nodesErwartet:
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 --versionErwartet:
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,svcErwartet:
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 mainErwartet (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 storelegt das Passwort im Klartext in~/.git-credentialsab. 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
- Zähle alle Pods im Cluster. Zeitziel: 15 s
- Zeig das Volume von Forgejo mit StorageClass. Zeitziel: 15 s
- 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-60Erwartet:
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/healthzErwartet:
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 kubectlErwartet:
## 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 .privateErwartet (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.