Betrieb / Admin

Installation auf eigenem Kubernetes

Den gemeinsamen Cloud-Installer mit expliziter kubeconfig vorbereiten.

30 Min. Lesezeit · Zuletzt aktualisiert:

Status dieser Funktion

Betrieb: On-prem-Profil für Kundeninfrastruktur Vorschau

Status 2026-10-01 auf preview gesetzt: nur auf k3d erprobt, noch nicht auf einem echten Kundenhost. Auf k3d erprobt; install-k3s auf echtem Host noch nicht durchgespielt. Der Upgrade-Test nutzt denselben Build unter neuem Tag (prüft den Upgrade-Ablauf, keine Schemaänderung zwischen zwei Releases); Air-Gap-Import und echte lokale Inferenz noch nicht durchgespielt; eine Replika; Release-Images für db-migrate und same-origin web müssen gebaut werden.

1. Installationsweg wählen

infra/cloud/lib/install.sh installiert die Anwendung und ihre Operatoren auf einem bestehenden Cluster. Es erstellt weder Cluster noch Netzwerk, DNS-Zone, StorageClass oder Cloud-Identitäten. Für eigene Kubernetes-Infrastruktur ist eu-k8s das generische Ziel. Für einen neuen Linux-Host nutze On-Prem mit k3s.

2. Standort konfigurieren

Kopiere infra/cloud/site.env.example an einen privaten Ort und infra/cloud/profiles/examples/eu-k8s.yaml in die Datei, die OAP_CLOUD_VALUES bezeichnet. Ersetze alle Beispielwerte. Setze Hostname, Images, Modellendpunkte, StorageClass, TLS und Backupziel passend zur Installation. Die env-Datei wird als vertrauenswürdiger Shell-Code gelesen.

Die Beispiele enthalten Platzhalter und sind nicht direkt einsatzbereit. Prüfe Identitäten, Egress-Regeln und privaten Zugang zum Ingress. Ohne passende Anbieterintegration keine verwaltete Datenbank versprechen.

3. Installation ausführen

Der Betreiber führt nach Prüfung der Werte folgenden Aufruf mit absoluten Pfaden aus. Die angegebene kubeconfig bestimmt das Ziel; der Installer fällt nicht auf einen anderen Kontext zurück.

bash
infra/cloud/lib/install.sh --target eu-k8s   --kubeconfig /secure/oap/kubeconfig   --env /secure/oap/site.env

4. Ergebnis prüfen

Prüfe den Abschluss der gemeinsamen Verifikation, Pods, ExternalSecrets, Datenbank, Migrationen, Anmeldung und API-Bereitschaft. Teste danach einen freigegebenen Agenten mit synthetischen Daten und einen Backup-/Restore-Ablauf. Sichere das State-Verzeichnis mit den generierten Schlüsseln.

Die lokale Rendering-Prüfung belegt keine Installation im eigenen Konto. Abweichende Storage-, Identitäts- und Ingress-Konfigurationen benötigen eine eigene Abnahme.

Grundlage im Repository
  • infra/cloud/README.md
  • infra/cloud/lib/install.sh
  • docs/platform/install.md

Deployment / Admin

Installation on your own Kubernetes cluster

Prepare the shared cloud installer with an explicit kubeconfig.

30 min read · Last updated:

Feature status

Deployment: on-prem customer-infrastructure profile Preview

Status set to preview on 2026-10-01: proven on k3d only, not yet on a real customer host. Proven on k3d; real-host install-k3s not yet exercised. The upgrade smoke re-tags the same build (proves the upgrade mechanics, not a schema change between two releases); the air-gap import and real local inference not yet exercised; single replica; release images for db-migrate and same-origin web must be built.

1. Choose the installation path

infra/cloud/lib/install.sh installs the application and its operators on an existing cluster. It does not create a cluster, network, DNS zone, StorageClass or cloud identities. For your own Kubernetes infrastructure, eu-k8s is the generic target. For a new Linux host, use on-premises deployment with k3s.

2. Configure the site

Copy infra/cloud/site.env.example to a private location and copy infra/cloud/profiles/examples/eu-k8s.yaml to the file specified by OAP_CLOUD_VALUES. Replace every example value. Set the hostname, images, model endpoints, StorageClass, TLS and backup destination to match the installation. The env file is read as trusted shell code.

The examples contain placeholders and are not ready to use unchanged. Check identities, egress rules and private access to the ingress. Do not promise a managed database without the appropriate provider integration.

3. Run the installation

After reviewing the values, the operator runs the following command with absolute paths. The specified kubeconfig determines the target; the installer does not fall back to another context.

bash
infra/cloud/lib/install.sh --target eu-k8s   --kubeconfig /secure/oap/kubeconfig   --env /secure/oap/site.env

4. Check the result

Check that the shared verification completes, and check pods, ExternalSecrets, the database, migrations, sign-in and API readiness. Then test an approved agent with synthetic data and a backup/restore procedure. Back up the state directory containing the generated keys.

Local rendering checks do not demonstrate an installation in your own account. Different storage, identity and ingress configurations require their own acceptance testing.

Repository sources
  • infra/cloud/README.md
  • infra/cloud/lib/install.sh
  • docs/platform/install.md