d9ed1bc2ff
Die Geraeteschicht — Abbild, zwei Wurzeln, Selbstprueflauf, Ruecksprung — verlaesst die Ablage der ersten Appliance und wird ein eigenes Erzeugnis mit eigenem Takt und eigenem Nachweis. Drei Gruende, nach Gewicht: Der Cyber Resilience Act verpflichtet fuer das gesamte Produkt einschliesslich der Betriebssystemschicht — vier gewachsene Basissysteme waeren vier Stuecklisten und vier Schwachstellenprozesse, eine gemeinsame Basis ist ein Dossier. Der Ruecksprung wird nur einmal richtig gebaut, weil er nur geprueft wird wenn ihn jemand braucht. Und eine abgegrenzte Aufgabe laesst sich ausschreiben, was unmittelbar auf das groesste benannte Risiko des Hauses einzahlt. Der Einwand der Vertraeglichkeitsmatrix wird durch den Nutzlast-Vertrag entkraeftet statt weggeredet: Die Nutzlast liegt in der Wurzel und wird mit ihr getauscht. Eine Fassung, ein Rueckweg, keine Matrix. Das OS kennt kein Produkt — Regel 1. Alle Namen sind entkoppelt, die Statusseite ist auf die Standardbibliothek umgestellt, weil jede Abhaengigkeit im Grund-OS eine Verpflichtung ueber die Produktlebensdauer ist. Nichts davon ist gelaufen. Der Inhalt gilt als Bauplan. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
3.3 KiB
Briefing — XinionOS
Für die Entwicklungsumgebung und für einen neu hinzukommenden Entwickler. Erst lesen, dann anfangen.
Was dieses Erzeugnis ist
Das Betriebssystem der Xinion-Appliances. Ein Gerät, das startet, sich selbst prüft, sich sicher aktualisieren lässt und im Fehlerfall von allein auf die vorherige Fassung zurückkehrt.
Es weiß nicht, was auf ihm läuft. Alles Fachliche kommt über den Nutzlast-Vertrag.
Rollenverteilung
| Wer | Was |
|---|---|
| Architektur (CIO und Entwurf) | entscheidet, was gebaut wird und warum |
| Entwicklung | baut es, bringt es zum Laufen, misst und legt den Nachweis ab |
Begegnet der Bauplan der Wirklichkeit und verliert, ist das ein Befund und kein Auftrag zum Umplanen. Melde zurück, entwirf nicht neu. Faustregel: Musst Du eine Architekturentscheidung anfassen, um weiterzukommen, ist es eine Entscheidung und keine Reparatur.
Was zuerst zu bauen ist
Das Abbild baut reproduzierbar, und der Rücksprung greift nachweislich.
Fällt der Selbstprüflauf auf einer Wurzel durch, kehrt das Gerät nach drei Startversuchen von selbst auf die andere zurück — und man kann hinterher nachlesen, warum.
Der Nachweis, Schritt für Schritt
abbild/bauen.sh <ubuntu-server.iso>— Abbild bauen, in einer virtuellen Maschine installieren. Das Gerät startet in Wurzel A.- Statusseite auf Anschluss 8080 aufrufen: Wurzel A, Fassung, Selbstprüflauf bestanden.
- Wurzel B befüllen, Starteintrag mit drei Versuchen anlegen.
- In Wurzel B
/etc/xinionos/selbstpruefung-scheitertanlegen — der Prüfschalter. - Auf B umschalten, neu starten.
- Beobachten: dreimal Fehlschlag, danach startet das Gerät ohne Zutun wieder in A.
- Die Statusseite zeigt unter Verlauf drei durchgefallene Läufe auf B und darunter den bestandenen auf A.
Schritt 6 ist der Nachweis. Ergebnis nach docs/nachweise/.
Wo der erste Lauf voraussichtlich scheitert
Beim Anhängen von autoinstall ds=nocloud;s=/cdrom/xinionos/ an die Startzeile — die Pfade zu
grub.cfg unterscheiden sich zwischen Ubuntu-Fassungen. Startet das Medium und fragt trotzdem
nach der Sprache, liegt es dort und sonst nirgends. Schnappschuss der VM vor dem ersten Versuch.
Der Stand: nichts davon ist gelaufen
Der gesamte Inhalt ist auf einem Mac geschrieben worden, auf dem weder ein Ubuntu-Abbild gebaut noch eine Unit gestartet werden kann. Behandle ihn als Bauplan, nicht als Zustand.
Was Du nicht tust
- Keine Architekturentscheidung treffen, keine ADR schreiben. Melde zurück.
- Keinen Produktnamen aufnehmen. Weder NEXTgenIT noch OLYMPUS noch sonst einen — siehe Regel 1
in
CLAUDE.md. - Keine Abhängigkeit ohne Begründung im Commit-Text. Jede steht fünf Jahre in der Stückliste.
- Keine Zahl erfinden und keine glätten.
- Kein
git add -A.
Wo alles steht
| Was | Wo |
|---|---|
| Regeln | CLAUDE.md |
| Vertrag zur Nutzlast | nutzlast/VERTRAG.md |
| Startverfahren und Rücksprung | docs/decisions/ADR-0002-startverfahren-und-ruecksprung.md |
| Gemessene Ergebnisse | docs/nachweise/ |
Bei Widerspruch gilt: ADR schlägt Dokumentation, Messung schlägt ADR. Eine Messung, die einer Entscheidung widerspricht, ist der wertvollste Fund überhaupt — melde ihn, bevor Du weiterbaust.