Betrieb / Admin

AWS Kurzanleitung

Profil vorhanden, noch nicht in einem echten Konto erprobt.

25 Min. Lesezeit · Zuletzt aktualisiert:

Status dieser Funktion

AWS In Entwicklung

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

1. Konto und Standort vorbereiten

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

EKS mit expliziten Admin-Principals und engen API-CIDRs. Prüfe gp3, EBS CSI, IRSA und Zugriff auf Secrets Manager, DNS und S3-Backups. Das Infrastrukturpaket lässt den Load Balancer Controller standardmäßig aus, während das gemeinsame Cloud-Profil ihn voraussetzt. Gleiche Controller, NLB-Annotationen und Zieltyp vor der Installation ausdrücklich ab.

2. Vorschau lesen

Starte aus dem Repository die Vorschau des Wrappers:

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

Deployment / Admin

AWS quick start

Profile available; not yet tested in a real account.

25 min read · Last updated:

Feature status

AWS In development

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

1. Prepare the account and site

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

EKS requires explicit admin principals and restricted API CIDRs. Check gp3, EBS CSI, IRSA and access to Secrets Manager, DNS and S3 backups. The infrastructure package leaves the Load Balancer Controller disabled by default, while the shared cloud profile expects it. Explicitly reconcile the controller, NLB annotations and target type before installation.

2. Review the preview

Run the wrapper's preview from the repository:

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