Betrieb / Admin
Hetzner Kurzanleitung
Profil vorhanden, noch nicht in einem echten Konto erprobt.
Status dieser Funktion
Hetzner In Entwicklung
Profil und Automatisierung vorhanden, noch keine Installation in einem echten Konto
1. Konto und Standort vorbereiten
Lies im Repository docs/platform/deploy-hetzner.md. Prüfe Kontozuordnung, Region, Quoten, Zugriffsrechte und das Kostenmodell. Kopiere infra/cloud/hetzner/terraform.tfvars.example in eine private Standortkonfiguration und ersetze Beispielwerte. Zugangsdaten gehören in die vorgesehene Anbieteranmeldung, nicht in tfvars.
Das Infrastrukturpaket bereitet k3s auf Servern vor. Der Bootstrap und das Abrufen der kubeconfig sind separate Schritte. Prüfe CSI, privaten API-Zugang und den NodePort-Ingress hinter dem Load Balancer. Ein stabiler hochverfügbarer API-Endpunkt bleibt Betreiberaufgabe.
2. Vorschau lesen
Starte aus dem Repository die Vorschau des Wrappers:
infra/cloud/hetzner/up.sh --site-env /secure/oap/site.preview.envOhne --apply wird keine Infrastruktur angelegt. Eine ausgegebene Anleitung oder eine Vorschau-env-Datei enthält noch keinen Installationsnachweis. Initialisierung, Validierung und Planprüfung folgen dem Anbieter-Runbook. State und Pläne geschützt speichern.
3. Infrastruktur bewusst bereitstellen
Erst ein verantwortlicher Betreiber darf nach Kosten- und Planprüfung den interaktiven Apply-Pfad aus dem Runbook ausführen. Danach tatsächliche Outputs und eine eigene kubeconfig übernehmen. Vorschauwerte nicht als echte Outputs weiterverwenden. DNS, Identitäten, CSI und Ingress vor dem Anwendungsinstaller prüfen.
4. Anwendung installieren
Kopiere die Beispielwerte für das Ziel eu-k8s und passe OAP_CLOUD_VALUES sowie die private site.env an. Der folgende Aufruf verändert den ausgewählten Cluster; beide Dateien müssen die tatsächliche Installation beschreiben.
infra/cloud/lib/install.sh --target eu-k8s --kubeconfig /secure/oap/kubeconfig --env /secure/oap/site.envErgebnis und offene Abnahme
Prüfe Anmeldung, Dienstbereitschaft, Modellaufruf, Backup und Wiederherstellung im eigenen Konto. Prüfe ebenfalls privaten Zugriff und Zertifikate. Lokale Mocks und Helm-Rendering ersetzen diese Abnahme nicht. Anbieterressourcen können unabhängig von der OAP-Nutzung Kosten verursachen.
Die gemeinsamen Voraussetzungen stehen in Installation auf eigenem Kubernetes.
Grundlage im Repository
docs/platform/deploy-hetzner.mdinfra/cloud/README.mdinfra/cloud/hetzner/up.sh
Deployment / Admin
Hetzner quick start
Profile available; not yet tested in a real account.
Feature status
Hetzner In development
Profile and automation available, no installation in a real account yet
1. Prepare the account and site
Read docs/platform/deploy-hetzner.md in the repository. Check the account assignment, region, quotas, access permissions and cost model. Copy infra/cloud/hetzner/terraform.tfvars.example to a private site configuration and replace the example values. Credentials belong in the provider's designated sign-in mechanism, not in tfvars.
The infrastructure package prepares servers for k3s. Bootstrapping and retrieving the kubeconfig are separate steps. Check CSI, private API access and NodePort ingress behind the load balancer. Providing a stable, highly available API endpoint remains the operator's responsibility.
2. Review the preview
Run the wrapper's preview from the repository:
infra/cloud/hetzner/up.sh --site-env /secure/oap/site.preview.envWithout --apply, no infrastructure is created. Printed instructions or a preview env file are not evidence of an installation. Follow the provider runbook for initialisation, validation and plan review. Store state and plans securely.
3. Provision infrastructure deliberately
Only a responsible operator should run the interactive apply procedure from the runbook after reviewing costs and the plan. Then use the actual outputs and a kubeconfig for the installation. Do not reuse preview values as real outputs. Check DNS, identities, CSI and ingress before running the application installer.
4. Install the application
Copy the example values for the eu-k8s target and adjust OAP_CLOUD_VALUES and the private site.env. The following command changes the selected cluster; both files must describe the actual installation.
infra/cloud/lib/install.sh --target eu-k8s --kubeconfig /secure/oap/kubeconfig --env /secure/oap/site.envResults and outstanding acceptance checks
Check sign-in, service readiness, a model call, backup and recovery in your own account. Also check private access and certificates. Local mocks and Helm rendering do not replace these acceptance checks. Provider resources may incur costs independently of OAP usage.
See installation on your own Kubernetes cluster for the shared prerequisites.
Repository sources
docs/platform/deploy-hetzner.mdinfra/cloud/README.mdinfra/cloud/hetzner/up.sh