Schritt 11: Apigee Hybrid über Helm-Diagramme installieren

Apigee Hybrid-Laufzeitkomponenten installieren

In diesem Schritt verwenden Sie Helm, um folgende Apigee Hybrid-Komponenten zu installieren:

Apigee-Operator
Apigee-Datenspeicher
Apigee-Telemetrie
Apigee Redis
Apigee-Ingress-Manager
Apigee-Organisation
Ihre Apigee-Umgebung(en)

Sie installieren die Diagramme für die einzelnen Umgebungen nacheinander. Die Reihenfolge, in der Sie die Komponenten installieren, spielt eine wichtige Rolle.

Hinweise zur Installation

Wenn Sie Helm v3.10+ noch nicht installiert haben, folgen Sie der Anleitung unter Helm installieren.
Apigee Hybrid verwendet Helm-Schutzmaßnahmen, um die Konfiguration zu prüfen, bevor ein Diagramm installiert oder aktualisiert wird. In der Ausgabe der einzelnen Befehle in diesem Abschnitt werden möglicherweise Schutzmaßnahmen-spezifische Informationen angezeigt, zum Beispiel:
```
# Source: apigee-operator/templates/apigee-operators-guardrails.yaml
apiVersion: v1
kind: Pod
metadata:
  name: apigee-hybrid-helm-guardrail-operator
  namespace: apigee-system
  annotations:
    helm.sh/hook: pre-install,pre-upgrade
    helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded
  labels:
    app: apigee-hybrid-helm-guardrail
```
Wenn einer der helm upgrade-Befehle fehlschlägt, können Sie anhand der Ausgabe der Schutzmaßnahmen die Ursache ermitteln. Weitere Informationen finden Sie unter Probleme mit Schutzmaßnahmen diagnostizieren.
Verwenden Sie vor dem Ausführen eines der Helm-Upgrade-/-Installationsbefehle das Helm-Probelauf-Feature, indem Sie --dry-run am Ende des Befehl hinzufügen. Mit helm install --h können Sie unterstützte Befehle, Optionen und die Nutzung auflisten.
Wenn Sie die Diagramme auf einem Cluster installieren, den Sie mit dem Apigee Helm-Migrationstool von der apigeectl-Verwaltung zur Helm-Verwaltung migriert haben, lassen Sie das --atomic-Flag in allen folgenden Befehlen weg.

Installationsschritte

Prüfen Sie, ob Sie eine geeignete Version von Helm haben.
```
helm version
```
Die für diese Installation erforderliche Version von Helm ist Version 3.10 oder höher. Wenn die angezeigte Version nicht zufriedenstellend ist, führen Sie mit den folgenden Befehlen ein Upgrade von Helm aus. Das Skript get_helm.sh ruft die neueste Version ab und installiert sie.
```
curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
chmod 700 get_helm.sh
./get_helm.sh
```
Prüfen Sie dann die Version von Helm noch einmal.
```
helm version
```
Wechseln Sie zu Ihrem APIGEE_HELM_CHARTS_HOME-Verzeichnis. Führen Sie die folgenden Befehle in diesem Verzeichnis aus.

Installieren Sie Apigee Operator/Controller:

Hinweis: Für diesen Schritt sind höhere Clusterberechtigungen erforderlich. Führen Sie helm -h oder helm install -h aus, um Details zu erfahren.

Probelauf:

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --atomic \
  -f overrides.yaml

Prüfen Sie die Installation des Apigee-Operators:

helm ls -n apigee-system

NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                                       APP VERSION
operator   apigee-system   3          2023-06-26 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.12.2   1.12.2

Prüfen Sie, ob er aktiv ist, indem Sie die Verfügbarkeit prüfen:

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

Installieren Sie den Apigee-Datenspeicher:

Probelauf:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

Prüfen Sie, ob apigeedatastore ausgeführt wird. Prüfen Sie dazu dessen Status, bevor Sie mit dem nächsten Schritt fortfahren:

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Installieren Sie die Apigee-Telemetrie:

Probelauf:

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

Prüfen Sie den Status, um sicherzustellen, dass dieses Element aktiv ist:

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

Installieren Sie Apigee Redis:

Probelauf:

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

Prüfen Sie den Status, um sicherzustellen, dass dieses Element aktiv ist:

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

Installieren Sie den Apigee-Ingress-Manager:

Probelauf:

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

Prüfen Sie, ob er aktiv ist, indem Sie die Verfügbarkeit prüfen:

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

Installieren Sie die Apigee-Organisation: Wenn Sie die Umgebungsvariable $ORG_NAME in Ihrer Shell festgelegt haben, können Sie diese in den folgenden Befehlen verwenden:

Probelauf:

helm upgrade $ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade $ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml

Prüfen Sie den Status der entsprechenden Organisation, um sicherzustellen, dass sie aktiv ist:

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

Installieren Sie die Umgebung:

Sie dürfen jeweils nur eine Umgebung installieren. Geben Sie die Umgebung mit --set env=ENV_NAME an: Wenn Sie die Umgebungsvariable $ENV_NAME in Ihrer Shell festgelegt haben, können Sie diese in den folgenden Befehlen verwenden:

Probelauf:

helm upgrade $ENV_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=$ENV_NAME \
  -f overrides.yaml \
  --dry-run

Installation des Diagramms:

helm upgrade $ENV_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=$ENV_NAME \
  -f overrides.yaml

Prüfen Sie, ob sie aktiv ist, indem Sie den Status der entsprechenden Umgebung prüfen:

kubectl -n apigee get apigeeenv

NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d

Installieren Sie die Umgebungsgruppen (virtualhosts).
1. Sie dürfen jeweils nur eine Umgebungsgruppe (virtualhost) installieren. Geben Sie die Umgebungsgruppe mit --set envgroup=ENV_GROUP an: Wenn Sie die Umgebungsvariable $ENV_GROUP in Ihrer Shell festgelegt haben, können Sie diese in den folgenden Befehlen verwenden. Wiederholen Sie folgende Befehle für alle Umgebungsgruppen, die in der Datei overrides.yaml erwähnt werden:
  Probelauf:
```
helm upgrade $ENV_GROUP apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f overrides.yaml \
  --dry-run
```
  Installation des Diagramms:
```
helm upgrade $ENV_GROUP apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=$ENV_GROUP \
  -f overrides.yaml
```
  Hinweis: ENV_GROUP darf im Namespace apigee nur einmal vorkommen. Wenn Sie beispielsweise eine prod-Umgebung und -Umgebungsgruppe haben, sollten Sie diesen Namen auf prod-envgroup setzen. Der spätere Umgebungsgruppenname sollte weiterhin prod sein.
2. Prüfen Sie den Status der ApigeeRoute (AR).
  Durch die Installation von virtualhosts wird ApigeeRouteConfig (ARC) erstellt. Dieses Element erstellt intern ApigeeRoute (ARC), nachdem der Apigee-Watcher die Umgebungsgruppendetails aus der Steuerungsebene abgerufen hat. Prüfen Sie daher, ob die entsprechende AR ausgeführt wird:
```
kubectl -n apigee get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n apigee get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```

Nächster Schritt

Installationen mit Workload Identity

Wenn Sie Apigee Hybrid in GKE installieren und Workload Identity für die Authentifizierung von Dienstkonten konfigurieren, werden Sie im nächsten Schritt die Verknüpfungen zwischen den Kubernetes-Dienstkonten und den Google-Dienstkonten für Ihren Cluster konfigurieren.

1 2 3 4 5 6 7 8 9 10 11 (WEITER) Schritt 12: Workload Identity einrichten

Alle anderen Installationen

Im nächsten Schritt konfigurieren Sie das Apigee Ingress-Gateway und stellen einen Proxy zum Testen der Installation bereit.

(WEITER) Schritt 1: Apigee-Ingress verfügbar machen 2