Schritt 3: ASM installieren

Aktuell lesen Sie die Version 1.4 der Apigee Hybrid-Dokumentation. Diese Version ist nicht mehr gültig. Führen Sie ein Upgrade auf eine neuere Version durch. Weitere Informationen finden Sie unter Unterstützte Versionen.

Version 1.4 (unsupported)

Unterstützte Versionen:

• V1.12 (aktuellste Version)                        
• v1.11                         
• v1.10                                        
• Liste der unterstützten Versionen

Nicht unterstützte Versionen:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

ASM installieren

Apigee hybrid verwendet die mit Anthos Service Mesh (ASM) bereitgestellte Istio-Distribution. Führen Sie die folgenden Schritte aus, um ASM in Ihrem Cluster zu installieren.

Unterstützte ASM-Versionen

• Installieren Sie bei neuen Installationen der Hybrid-Version 1.4.4 die ASM-Version 1.7.x.
• Installieren Sie für Upgrades von früheren Hybrid-Versionen die ASM-Version 1.6.x.

Einrichtungs- und Konfigurationsschritte für ASM ausführen

Um die ASM-Installation abzuschließen, müssen Sie zuerst die ASM-spezifischen Einrichtungs- und Konfigurationsschritte in der ASM-Dokumentation befolgen. Anschließend müssen Sie hierher zurückkehren, um die Hybrid-Konfiguration abzuschließen, bevor Sie die Konfiguration auf den Cluster anwenden.

Die Anweisungen zur Installation und Konfiguration von ASM sind je nach Plattform unterschiedlich. Wählen Sie unten die Schritte aus, die Ihre Plattform hat.

Bei der folgenden Konfiguration wird davon ausgegangen, dass Clients SNI standardmäßig aktiviert sind. Ist dies nicht der Fall, finden Sie entsprechende Informationen unter Nicht-SNI- und HTTP-Clients aktivieren.

GKE

1. Folgen Sie den Schritten zur Einrichtung und Konfiguration von ASM:
   Wichtig: Wenn Sie die ASM-Dokumentation befolgen, installieren Sie nicht die YAML-Konfigurationsdatei istio-operator.yaml und wenden Sie sie nicht an, wenn Sie dazu aufgefordert werden. Sie müssen zu dieser Seite zurückkehren, um die Datei mit weiteren Hybrid-spezifischen Konfigurationen zu bearbeiten, bevor Sie die Konfiguration installieren oder anwenden.
   • Bei einer neuen Installation von Apigee Hybrid installieren Sie die ASM-Version 1.7.x. Wechseln Sie zu Neue Installation.
   • Verwenden Sie ASM 1.6.x, wenn Sie ein Upgrade von einer früheren Hybrid-Version durchführen. Weitere Informationen finden Sie unter Einführung in die Installation und Migration.

2. Nachdem Sie die Einrichtungs- und Konfigurationsschritte für ASM abgeschlossen haben, fahren Sie mit dem nächsten Abschnitt fort, um die Schritte zur Hybridkonfiguration und ASM-Installation abzuschließen.

Abschließende Hybridkonfiguration ausführen und ASM installieren

Fügen Sie der istio-operator.yaml-Datei anschließend Hybrid-spezifische Konfigurationen hinzu und installieren Sie ASM.

1. Achten Sie darauf, dass Sie sich im Stammverzeichnis der ASM-Installation befinden. Beispiel: 1.7.3-asm.6.
2. Öffnen Sie die Datei istio-operator.yaml in einem Editor.
   • In ASM 1.7.x: ./asm/istio/istio-operator.yaml
   • In ASM 1.6.x: ./asm/cluster/istio-operator.yaml
3. Fügen Sie die spec:components-Stanza in der Datei istio-operator.yaml unterhalb des Abschnitts meshConfig: und unmittelbar übervalues: hinzu oder aktualisieren Sie sie, wobei reserved_static_ip eine IP-Adresse ist, die Ihr Laufzeit-Ingress-Gateway verwenden kann. Wenn Sie keine reservierte statische IP-Adresse haben, können Sie für diesen Schnellstart die Property LoadBalancerIP weglassen.

   Zu kopierender Text

     components:
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: static_ip # If you do not have a reserved static IP, leave this out.
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
   

   Beispiel für eine Platzierung

   Zeilenumbrüche wurden zur besseren Lesbarkeit eingefügt

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   metadata:
     clusterName: "hybrid-example/us-central1/example-cluster" # {"$ref":"#/definitions/io.k8s.cli.substitutions.cluster-name"}
   spec:
     profile: asm
     hub: gcr.io/gke-release/asm # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.hub"}
     tag: 1.5.7-asm.0 # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.tag"}
     meshConfig:
       defaultConfig:
         proxyMetadata:
           GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
             {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}
   
     components:
       pilot:
         k8s:
           hpaSpec:
             maxReplicas: 2
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: 123.234.56.78
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
           hpaSpec:
             maxReplicas: 2
     values:
       .
       .
       .
   

4. Kehren Sie zu der zuvor verwendeten ASM-Dokumentation zurück und schließen Sie die ASM-Installation ab. Installieren oder wenden Sie die Datei istio-operator.yaml auf den Cluster an. Wenn Sie ASM 1.6 verwenden und auswählen können, wählen Sie PERMISSIVE mTLS aus.
   Hinweis: Wenn Sie ASM 1.6 verwenden, empfehlen wir, die Konfiguration und den Zustand der installierten Komponenten mit dem Befehl asmctl validate zu validieren. Dieser Befehl wird in der ASM-Dokumentation im Abschnitt zur Überprüfung der Installation beschrieben. Dieser Befehl ist nur gültig, wenn Sie ASM 1.6 verwenden.

GKE On-Prem

ASM einrichten und herunterladen

Richten Sie mit der ASM-Dokumentation Ihre Umgebung ein, und laden Sie ASM herunter.

1. Lesen Sie die folgenden Schritte sorgfältig durch, bevor Sie beginnen. Sie müssen einige der in der ASM-Dokumentation aufgeführten Schritte ausführen und dann hierher zurückkehren, um die Installation abzuschließen.
2. Gehen Sie zu Anthos Service Mesh lokal installieren und führen Sie alle ASM-Schritte bis einschließlich istio-system-Namespace erstellen aus. Beenden Sie dann den nächsten Abschnitt Manifest anwenden.
   Wichtig: Nachdem Sie die Schritte unter istio-system-Namespace erstellen ausgeführt haben, stoppen Sie hier und fahren Sie mit den im nächsten Abschnitt aufgeführten Schritten fort. Wir empfehlen Ihnen, die Manifestdatei erst dann anzuwenden, wenn Sie dazu aufgefordert werden.

Manifest anwenden

Wenn Sie die ASM-Installationsdatei heruntergeladen und entpackt haben, fahren Sie mit den folgenden Schritten fort:

1. Prüfen Sie, ob Sie sich im Istio-Verzeichnis befinden, das Sie heruntergeladen und entpackt haben. Beispiel: 1.7.3-asm.6.
2. Führen Sie den folgenden Befehl aus, wobei your_static_ip eine statische IP-Adresse ist, die von der Istio-Ingress-Komponente verwendet werden kann. Wenn keine statische IP-Adresse reserviert ist, lassen Sie die Zeile --set values.gateways.istio-ingressgateway.loadBalancerIP weg:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Kehren Sie zu der ASM-Dokumentation zurück, und prüfen Sie die Komponenten der Steuerungsebene, um Ihre Installation zu validieren.

ASM-Installation anpassen

Die soeben durchgeführte ASM-Installation ist eine minimale Installation, die zum Testen und Verwenden von Apigee Hybrid für einfache Anwendungsfälle erforderlich ist. Informationen zur Bearbeitung komplexerer Anwendungsfälle, z. B. zum Hinzufügen, Entfernen oder Ändern von Portnummern für Load-Balancer, finden Sie unter Optionale Features aktivieren.

Fazit

Sie haben nun cert-manager und ASM installiert und können jetzt das Apigee Hybrid-Befehlszeilentool auf Ihrem lokalen Computer installieren.

AKS

ASM einrichten und herunterladen

Richten Sie mit der ASM-Dokumentation Ihre Umgebung ein, und laden Sie ASM herunter.

1. Lesen Sie die folgenden Schritte sorgfältig durch, bevor Sie beginnen. Sie müssen einige der in der ASM-Dokumentation aufgeführten Schritte ausführen und dann hierher zurückkehren, um die Installation abzuschließen.
2. Gehen Sie zu Anthos Service Mesh auf angehängten Clustern installieren und führen Sie alle ASM-Schritte bis einschließlich istio-system-Namespace erstellen aus. Beenden Sie dann den nächsten Abschnitt Manifest anwenden.
   Wichtig: Nachdem Sie die Schritte unter istio-system-Namespace erstellen ausgeführt haben, stoppen Sie hier und fahren Sie mit den im nächsten Abschnitt aufgeführten Schritten fort. Wir empfehlen Ihnen, die Manifestdatei erst dann anzuwenden, wenn Sie dazu aufgefordert werden.

Manifest anwenden

Wenn Sie die ASM-Installationsdatei heruntergeladen und entpackt haben, fahren Sie mit den folgenden Schritten fort:

1. Prüfen Sie, ob Sie sich im Istio-Verzeichnis befinden, das Sie heruntergeladen und entpackt haben. Beispiel: 1.7.3-asm.6.
2. Führen Sie den folgenden Befehl aus, wobei your_static_ip eine statische IP-Adresse ist, die von der Istio-Ingress-Komponente verwendet werden kann. Wenn keine statische IP-Adresse reserviert ist, lassen Sie die Zeile --set values.gateways.istio-ingressgateway.loadBalancerIP weg:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Kehren Sie zu der ASM-Dokumentation zurück, und prüfen Sie die Komponenten der Steuerungsebene, um Ihre Installation zu validieren.

ASM-Installation anpassen

Die soeben durchgeführte ASM-Installation ist eine minimale Installation, die zum Testen und Verwenden von Apigee Hybrid für einfache Anwendungsfälle erforderlich ist. Informationen zur Bearbeitung komplexerer Anwendungsfälle, z. B. zum Hinzufügen, Entfernen oder Ändern von Portnummern für Load-Balancer, finden Sie unter Optionale Features aktivieren.

Fazit

Sie haben nun cert-manager und ASM installiert und können jetzt das Apigee Hybrid-Befehlszeilentool auf Ihrem lokalen Computer installieren.

GKE on AWS

ASM einrichten und herunterladen

Richten Sie mit der ASM-Dokumentation Ihre Umgebung ein, und laden Sie ASM herunter.

1. Lesen Sie die folgenden Schritte sorgfältig durch, bevor Sie beginnen. Sie müssen einige der in der ASM-Dokumentation aufgeführten Schritte ausführen und dann hierher zurückkehren, um die Installation abzuschließen.
2. Gehen Sie zu Anthos Service Mesh in GKE in AWS installieren und führen Sie alle ASM-Schritte bis einschließlich Installationsdatei herunterladen aus und gehen Sie zum nächsten Abschnitt Manifest anwenden.
   Wichtig: Nachdem Sie die Schritte im Abschnitt Installationsdatei herunterladen ausgeführt haben, fahren Sie mit dem nächsten Schritt fort. Wir empfehlen Ihnen, die Manifestdatei erst dann anzuwenden, wenn Sie dazu aufgefordert werden.

Manifest anwenden

Wenn Sie die ASM-Installationsdatei heruntergeladen und entpackt haben, fahren Sie mit den folgenden Schritten fort:

1. Prüfen Sie, ob Sie sich im Istio-Verzeichnis befinden, das Sie heruntergeladen und entpackt haben. Beispiel: 1.7.3-asm.6.
2. Führen Sie den folgenden Befehl aus, wobei your_static_ip eine statische IP-Adresse ist, die von der Istio-Ingress-Komponente verwendet werden kann. Wenn keine statische IP-Adresse reserviert ist, lassen Sie die Zeile --set values.gateways.istio-ingressgateway.loadBalancerIP weg:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Kehren Sie zu der ASM-Dokumentation zurück, und prüfen Sie die Komponenten der Steuerungsebene, um Ihre Installation zu validieren.

ASM-Installation anpassen

Die soeben durchgeführte ASM-Installation ist eine minimale Installation, die zum Testen und Verwenden von Apigee Hybrid für einfache Anwendungsfälle erforderlich ist. Informationen zur Bearbeitung komplexerer Anwendungsfälle, z. B. zum Hinzufügen, Entfernen oder Ändern von Portnummern für Load-Balancer, finden Sie unter Optionale Features aktivieren.

Fazit

Sie haben nun cert-manager und ASM installiert und können jetzt das Apigee Hybrid-Befehlszeilentool auf Ihrem lokalen Computer installieren.

EKS

ASM einrichten und herunterladen

Richten Sie mit der ASM-Dokumentation Ihre Umgebung ein, und laden Sie ASM herunter.

1. Lesen Sie die folgenden Schritte sorgfältig durch, bevor Sie beginnen. Sie müssen einige der in der ASM-Dokumentation aufgeführten Schritte ausführen und dann hierher zurückkehren, um die Installation abzuschließen.
2. Gehen Sie zu Anthos Service Mesh auf angehängten Clustern installieren und führen Sie alle ASM-Schritte bis einschließlich istio-system-Namespace erstellen aus. Beenden Sie dann den nächsten Abschnitt Manifest anwenden.
   Wichtig: Nachdem Sie die Schritte unter istio-system-Namespace erstellen ausgeführt haben, stoppen Sie hier und fahren Sie mit den im nächsten Abschnitt aufgeführten Schritten fort. Wir empfehlen Ihnen, die Manifestdatei erst dann anzuwenden, wenn Sie dazu aufgefordert werden.

Manifest anwenden

Wenn Sie die ASM-Installationsdatei heruntergeladen und entpackt haben, fahren Sie mit den folgenden Schritten fort:

1. Prüfen Sie, ob Sie sich im Istio-Verzeichnis befinden, das Sie heruntergeladen und entpackt haben. Beispiel: 1.7.3-asm.6.
2. Führen Sie den folgenden Befehl aus, wobei your_static_ip eine statische IP-Adresse ist, die von der Istio-Ingress-Komponente verwendet werden kann. Wenn keine statische IP-Adresse reserviert ist, lassen Sie die Zeile --set values.gateways.istio-ingressgateway.loadBalancerIP weg:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Kehren Sie zu der ASM-Dokumentation zurück, und prüfen Sie die Komponenten der Steuerungsebene, um Ihre Installation zu validieren.

ASM-Installation anpassen

Die soeben durchgeführte ASM-Installation ist eine minimale Installation, die zum Testen und Verwenden von Apigee Hybrid für einfache Anwendungsfälle erforderlich ist. Informationen zur Bearbeitung komplexerer Anwendungsfälle, z. B. zum Hinzufügen, Entfernen oder Ändern von Portnummern für Load-Balancer, finden Sie unter Optionale Features aktivieren.

Fazit

Sie haben nun cert-manager und ASM installiert und können jetzt das Apigee Hybrid-Befehlszeilentool auf Ihrem lokalen Computer installieren.

Fazit

Sie haben nun cert-manager und ASM installiert und können jetzt das Apigee Hybrid-Befehlszeilentool auf Ihrem lokalen Computer installieren.

1 2 3 (NÄCHSTES) Schritt 4: apigeectl installieren 5 6 7