DocsDocs

Betrieb

Betrieb

Installation, Exoscale SKS, Multi-Cloud, Backup, Restore, Upgrades und Sicherheitsnotizen für Betreiber.

Status

Installation

Das Umbrella-Chart installiert die Plattform auf einem vorhandenen Kubernetes-Cluster. Es spiegelt die Service-Charts, External Secrets, CNPG, NATS Streams, optionale Gateway-Komponenten und optionale Modellserver. Drittanbieter-Operatoren wie cert-manager, ingress-nginx, External Secrets Operator, CloudNativePG, NATS, Redis und Qdrant müssen passend vorbereitet sein.

bash
helm dependency build charts/oap
helm install oap charts/oap -n oap-platform -f my-values.yaml

Cloud-Profile und On-Prem

infra/cloud/lib/install.sh ist der gemeinsame Installer für vorhandene Cluster. Targets sind aws, azure, gcp und eu-k8s. Er erwartet eine explizite Kubeconfig und eine private site.env. INSTALL_K3S=yes wird abgelehnt.

On-Prem-Werte bleiben die Basis. Cloud-Profile wählen StorageClass, Ingress-Annotationen, DNS-01, Secret-Provider und CNPG-Backup-Ziele, ohne Anwendungscode für Cloud-Dateisysteme zu erfinden.

Exoscale SKS

Der Exoscale-SKS-Guide beschreibt einen neuen SKS-Cluster in at-vie-2, Budgetannahmen, Storage, SOS-Buckets, Registry-Entscheidungen und Ingress-Prüfungen. Live-Findings vom 2026-10-02 nennen insbesondere Instance-Pool-IDs für NLB-Backends und HTTP-Healthchecks bei externalTrafficPolicy: Local.

Multi-Cloud

AWS, Azure, GCP und EU-Kubernetes-Profile sind Installer-Ziele. Die EU-Kubernetes-Dokumentation beschreibt Anbieter wie IONOS, OVHcloud, Scaleway, Open Telekom Cloud, plusserver und Exoscale als Kandidaten, mit klar markierten Vendor-Fakten, die vor dem Betrieb erneut geprüft werden müssen.

Upgrades, Backup und Restore

CNPG-Backups brauchen ein echtes Objektziel, Credentials und eine Restore-Probe. Ein site.env Eintrag allein aktiviert keine belastbare Wiederherstellung. Restore-Drills sollen in einem separaten Namespace oder Cluster laufen und Produktionsverkehr unverändert lassen.

Tenant Export und Tenant Lifecycle sind Vorschau. Nutze sie nicht als alleinige Disaster-Recovery-Zusage, solange ihre Einschränkungen in features.yaml gelten.

Sicherheit und Verify

Betreiber sollen kurze Identitäten, eingeschränkten Kubernetes-API-Zugriff, NetworkPolicies, TLS, getrennte Backup-Credentials und private Cloud-APIs verwenden. Nach der Installation müssen Login, Chat, Streaming, PVC-Binding, Ingress, TLS und Restore geprüft werden.

bash
infra/cloud/lib/install.sh --target eu-k8s \
  --kubeconfig /secure/oap/kubeconfig \
  --env /secure/oap/site.env --check-env
Grundlage im Repository
  • charts/oap/README.md
  • infra/cloud/README.md
  • docs/platform/deploy-exoscale-sks.md
  • docs/platform/deploy-eu-k8s.md
  • infra/onprem/README.md

Operations

Operations

Installation, Exoscale SKS, multi-cloud, backup, restore, upgrades and security notes for operators.

Status

Installation

The umbrella chart installs the platform on an existing Kubernetes cluster. It mirrors service charts, External Secrets, CNPG, NATS Streams, optional gateway components and optional model servers. Third-party operators such as cert-manager, ingress-nginx, External Secrets Operator, CloudNativePG, NATS, Redis and Qdrant must be prepared appropriately.

bash
helm dependency build charts/oap
helm install oap charts/oap -n oap-platform -f my-values.yaml

Cloud profiles and on-prem

infra/cloud/lib/install.sh is the shared installer for existing clusters. Targets are aws, azure, gcp and eu-k8s. It expects an explicit kubeconfig and private site.env. INSTALL_K3S=yes is rejected.

On-prem values remain the base. Cloud profiles select StorageClass, ingress annotations, DNS-01, secret provider and CNPG backup targets without inventing application code for cloud file systems.

Exoscale SKS

The Exoscale SKS guide describes a new SKS cluster in at-vie-2, budget assumptions, storage, SOS buckets, registry decisions and ingress checks. Live findings from 2026-10-02 call out instance pool ids for NLB backends and HTTP health checks with externalTrafficPolicy: Local.

Multi-cloud

AWS, Azure, GCP and EU Kubernetes profiles are installer targets. The EU Kubernetes document describes providers such as IONOS, OVHcloud, Scaleway, Open Telekom Cloud, plusserver and Exoscale as candidates, with vendor facts clearly marked for recheck before operation.

Upgrades, backup and restore

CNPG backups need a real object target, credentials and a restore probe. A site.env entry alone does not create reliable recovery. Restore drills should run in a separate namespace or cluster and leave production traffic unchanged.

Tenant Export and Tenant Lifecycle are preview. Do not use them as the only disaster recovery promise while their limitations remain in features.yaml.

Security and verify

Operators should use short-lived identities, restricted Kubernetes API access, NetworkPolicies, TLS, separate backup credentials and private cloud APIs. After installation, verify login, chat, streaming, PVC binding, ingress, TLS and restore.

bash
infra/cloud/lib/install.sh --target eu-k8s \
  --kubeconfig /secure/oap/kubeconfig \
  --env /secure/oap/site.env --check-env
Repository sources
  • charts/oap/README.md
  • infra/cloud/README.md
  • docs/platform/deploy-exoscale-sks.md
  • docs/platform/deploy-eu-k8s.md
  • infra/onprem/README.md