Betrieb / Admin

GCP Kurzanleitung

Profil vorhanden, noch nicht in einem echten Konto erprobt.

25 Min. Lesezeit · Zuletzt aktualisiert:

Status dieser Funktion

Google Cloud In Entwicklung

Profil und Automatisierung vorhanden, noch keine Installation in einem echten Konto

1. Konto und Standort vorbereiten

Lies im Repository docs/platform/deploy-gcp.md. Prüfe Kontozuordnung, Region, Quoten, Zugriffsrechte und das Kostenmodell. Kopiere infra/cloud/gcp/terraform.tfvars.example in eine private Standortkonfiguration und ersetze Beispielwerte. Zugangsdaten gehören in die vorgesehene Anbieteranmeldung, nicht in tfvars.

GKE mit Workload Identity, standard-rwo, internem L4-Load-Balancer und Secret Manager. Prüfe GCS-Rechte für Datenbankbackups. Der gemeinsame Installer stellt keinen öffentlichen Zugriff zum privaten Cluster her.

2. Vorschau lesen

Starte aus dem Repository die Vorschau des Wrappers:

bash
infra/cloud/gcp/up.sh

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

Deployment / Admin

GCP quick start

Profile available; not yet tested in a real account.

25 min read · Last updated:

Feature status

Google Cloud In development

Profile and automation available, no installation in a real account yet

1. Prepare the account and site

Read docs/platform/deploy-gcp.md in the repository. Check the account assignment, region, quotas, access permissions and cost model. Copy infra/cloud/gcp/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.

GKE uses Workload Identity, standard-rwo, an internal L4 load balancer and Secret Manager. Check GCS permissions for database backups. The shared installer does not provide public access to the private cluster.

2. Review the preview

Run the wrapper's preview from the repository:

bash
infra/cloud/gcp/up.sh

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