1. Ziel

RuntimeClass, Handler und Pod-Referenz werden für Kata/gVisor-ähnliche Isolation modelliert.

Das Beispiel ist als isoliertes Lab oder Modell aufgebaut. Es verändert keine produktive Runtime-Konfiguration und schreibt Laufzeitergebnisse ausschließlich nach work/.

2. Voraussetzungen

• Linux, WSL, VM oder vergleichbare Testumgebung.
• python3 für JSON/TOML/YAML-Validierung.
• Optional containerd, ctr, runc, nerdctl und crictl für zusätzliche Evidence.
• Keine produktiven Nodes, Registries, Credentials oder Pull Secrets verwenden.

3. Dateien

• README.md
• README-EL.md
• docs/de/README.md
• docs/en/README.md
• docs/el/README.md
• run.sh
• kubernetes/pod-sandboxed.yaml
• kubernetes/runtimeclass-sandboxed.yaml

4. Ausführung

cd examples/15-runtimeclass-sandboxed
chmod +x run.sh
./run.sh
find work -maxdepth 3 -type f | sort

5. Erwartetes Ergebnis

• run.sh endet mit Exit-Code 0.
• TOML, JSON und YAML werden syntaktisch geprüft.
• Shell-Skripte werden mit bash -n geprüft.
• Wenn containerd lokal verfügbar ist, werden Version und optional ctr-Evidence gesammelt.
• Alle Laufzeitartefakte entstehen unter work/.

6. Erklärung

containerd-Arbeit muss sauber zwischen mehreren Ebenen unterscheiden: Host, containerd-Daemon, API, Content Store, Snapshotter, Runtime, CRI, CNI und Kubernetes. Dieses Beispiel isoliert genau einen Ausschnitt davon und macht die Reviewfragen nachvollziehbar.

7. Typische Fehler

8. Sicherheitsaspekte

• Keine produktiven Sockets, Registry-Credentials oder Cluster-Endpunkte in Labs eintragen.
• Registry-TLS nicht mit skip_verify = true kaschieren, außer als klar markiertes Negativbeispiel.
• Sandbox-Runtimes, Seccomp und AppArmor sind zusätzliche Kontrollen, kein Ersatz für sichere Images.
• Runtime-Konfigurationsänderungen auf Kubernetes-Nodes brauchen Drain, Rollback und Abnahme.

9. Review und Evidence

Eine vollständige Abgabe enthält mindestens:

work/evidence/
  tooling.txt
  result.txt
  config-review.txt
  risk-note.md
  cleanup.md

Nicht jede Datei entsteht in jedem Beispiel. Entscheidend ist, dass die Evidence zum Lernziel passt und keine Geheimnisse enthält.

10. Erweiterungsmöglichkeiten

• Beispiel mit echter Test-Registry erweitern.
• CRI-Ausgaben aus einem Lab-Node ergänzen.
• RuntimeClass-Variante für Kata oder gVisor hinzufügen.
• Image-Verifikation mit Cosign oder Notation als separates Lab ergänzen.
• Evidence in CI gegen TOML/JSON/YAML validieren.

Beispielanhang: Evidence, Betrieb und Transfer

Dieser Zusatzteil macht das Beispiel als Trainingsbaustein vollständig. Er beschreibt, wie aus einem lokalen Modell eine belastbare Runtime-Analyse entsteht, ohne produktive Nodes oder Zugangsdaten zu berühren.

B.1 Scope bestimmen

Scope bestimmen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.2 Artefakte validieren

Artefakte validieren ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.3 Runtime-Schicht benennen

Runtime-Schicht benennen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.4 Kubernetes-Bezug prüfen

Kubernetes-Bezug prüfen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.5 Security-Grenzen festhalten

Security-Grenzen festhalten ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.6 Rollback formulieren

Rollback formulieren ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.7 Evidence bereinigen

Evidence bereinigen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.8 Transfer begrenzen

Transfer begrenzen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.9 Review abschließen

Review abschließen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.10 Cleanup durchführen

Cleanup durchführen ist für dieses Beispiel notwendig, weil containerd-Labs sonst leicht von einem sicheren Modell zu einer unkontrollierten Node-Änderung werden. Die Bewertung muss klar sagen, ob ein Artefakt nur erklärt, lokal prüft oder auf einem echten Node angewendet würde.

Reviewpunkte:

• keine produktiven Secrets
• keine ungeprüften Socket- oder Systemd-Änderungen
• keine Registry-Ausnahmen ohne Begründung
• keine Verwechslung von ctr, crictl und nerdctl
• Cleanup durch Entfernen von work/ möglich

B.11 Abschluss

Ein Beispiel gilt als fertig, wenn das Skript erfolgreich läuft, alle Modellartefakte syntaktisch gültig sind, die betroffene Runtime-Schicht benannt ist und die Evidence keine vertraulichen Daten enthält.