Betrieb / Admin

Hetzner Kurzanleitung

Profil vorhanden, noch nicht in einem echten Konto erprobt.

25 Min. Lesezeit · Zuletzt aktualisiert:

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:

bash
infra/cloud/hetzner/up.sh --site-env /secure/oap/site.preview.env

Ohne --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.

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

Ergebnis 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.md
  • infra/cloud/README.md
  • infra/cloud/hetzner/up.sh

Deployment / Admin

Hetzner quick start

Profile available; not yet tested in a real account.

25 min read · Last updated:

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:

bash
infra/cloud/hetzner/up.sh --site-env /secure/oap/site.preview.env

Without --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.

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

Results 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.md
  • infra/cloud/README.md
  • infra/cloud/hetzner/up.sh