Betriebshandbuch

Dieses Handbuch ist für die Menschen, die Labtagon AI OS betreiben. Sie installieren es mit seinem Helm-Chart (deploy/helm/ai-os) auf einem Kubernetes-Cluster, halten es am Laufen, sichern es und spielen Upgrades ein. Was Administratoren in der Konsole einstellen, steht im Handbuch Administration.

Was du brauchst


Kubernetes	1.30 oder neuer. Das Chart verlangt es in `kubeVersion`.
Anmeldung	Einen OpenID-Connect-Provider. Das Chart ist auf Keycloak eingestellt; jeder OIDC-Provider geht.
Einen Eingang	Eine Gateway-API-Implementierung (HTTPRoutes) oder einen Ingress-Controller, mit DNS und TLS für deinen Host.
Postgres	Den CloudNativePG-Operator oder ein eigenes Postgres mit der Erweiterung `vector` (pgvector 0.8 oder neuer), angelegt von einem Superuser.
Schlüssel	Ein Secret mit den Schlüsseln der Plattform, einmal angelegt, zum Beispiel aus OpenBao über External Secrets.
Objektspeicher	Standardmäßig nichts zusätzlich: Das Chart betreibt Garage. Stattdessen geht jedes S3.

AI OS betreibt keine eigene Image-Registry und keinen eigenen Secrets-Speicher. Seine Komponenten-Images kommen aus der Registry, die du in global.imageRegistry nennst; Images von Dritten werden dort geholt, wo sie veröffentlicht sind, oder über einen Mirror (global.mirror).

Die Kapitel

Aufbau und KomponentenWas wo läuft, wer mit wem spricht und was jede Komponente tut.

DimensionierungRequests, Limits, Replikas und Quotas des Charts, und was womit wächst.

Installation mit HelmDie Pflichtwerte, die Schlüssel, Keycloak und der erste Start.

App-HostDie Konsole auf einem eigenen Host (ADR 0097).

Netz und EgressAlles verboten, die Wege, die das Chart öffnet, und der eine Weg hinaus.

Backups und WiederherstellungPostgres, die Dateien und die Schlüssel, die du nie verlieren darfst.

Upgrades und MigrationenWie ein neues Release ausgerollt wird und wie die Datenbank folgt.