Sie sehen die Dokumentation zum Service Mesh für Version 1.21.

Verfügbare Versionen

Cloud Service Mesh
1.22-Archiv
1.21-Archiv
1.20-Archiv
1.19-Archiv
1.18-Archiv

Diese Seite wurde von der Cloud Translation API übersetzt.

Cloud Service Mesh für Kubernetes-Arbeitslasten außerhalb von Google Cloud installieren

Auf dieser Seite wird beschrieben, wie Sie ein nicht verwaltetes Cloud Service Mesh für Kubernetes-Arbeitslasten außerhalb von Google Cloud installieren:

asmcli ausführen, um eine neue Installation von Cloud Service Mesh durchzuführen 1.21.5-asm.12
Stellen Sie optional ein Ingress-Gateway bereit.
Ihre Arbeitslasten bereitstellen oder noch einmal bereitstellen, um Sidecar-Proxys einzufügen

Wenn Sie nicht verwaltetes, clusterinternes Cloud Service Mesh mit einer istiod-Steuerungsebene in GKE installieren möchten, lesen Sie den Hilfeartikel Clusterinternes Cloud Service Mesh in Google Cloud installieren. Für Kubernetes-Arbeitslasten in Google Cloud empfehlen wir die Bereitstellung einer verwalteten Steuerungsebene.

Eine Anleitung zum Vorbereiten einer Offlineinstallation von Cloud Service Mesh finden Sie unter Offlineinstallation von Cloud Service Mesh vorbereiten. Sie müssen die Optionen --offline und --output_dir angeben, wenn Sie asmcli install ausführen.

Beschränkungen

Beachten Sie die folgenden Beschränkungen:

Alle Cloud Service Mesh-Cluster für ein Mesh-Netzwerk müssen immer bei derselben Flotte registriert sein, um Cloud Service Mesh verwenden zu können. Andere Cluster im Projekt eines Cloud Service Mesh-Clusters dürfen nicht in einer anderen Flotte registriert sein.
Das asmcli-Tool muss Zugriff auf den Google Kubernetes Engine-Endpunkt (GKE) haben. Sie können den Zugriff über einen Jumpserver konfigurieren, z. B. eine Compute Engine-VM innerhalb der Virtual Private Cloud (VPC), die bestimmten Zugriff gewährt.

Hinweise

Folgende Voraussetzungen müssen Sie erfüllt haben:

Prüfen Sie die Voraussetzungen.
Lesen Sie die Informationen unter Installation planen.
Installieren Sie die erforderlichen Tools.
Laden Sie asmcli herunter.
Erteilen Sie Clusteradministratorberechtigungen.
Validieren Sie Projekt und Cluster.

Rollen, die zum Installieren von Cloud Service Mesh in einem Cluster erforderlich sind

In der folgenden Tabelle werden die Rollen beschrieben, die zum Installieren von Cloud Service Mesh im Cluster erforderlich sind.

Rollenname	Rollen-ID	Standort erteilen	Beschreibung
GKE-Hub-Administrator	roles/gkehub.admin	Flottenprojekt	Vollständiger Zugriff auf GKE-Hubs und zugehörige Ressourcen.
Kubernetes Engine-Administrator	roles/container.admin	Clusterprojekt. Beachten Sie, dass diese Rolle sowohl für Flotten- als auch für Clusterprojekte für projektübergreifende Bindungen gewährt werden muss.	Berechtigung zur vollständigen Verwaltung von Container-Clustern und den zugehörigen Kubernetes API-Objekten
Mesh-Konfigurationsadministrator	roles/meshconfig.admin	Flotten- und Clusterprojekt	Stellt Berechtigungen zum Initialisieren verwalteter Komponenten von Cloud Service Mesh bereit, z. B. verwaltete Steuerungsebenen, und Backend-Berechtigungen, mit denen Arbeitslasten mit Stackdriver kommunizieren können, ohne dass sie einzeln autorisiert werden (gilt sowohl für verwaltete als auch für clusterinterne Steuerungsebenen).
Projekt-IAM-Administrator	roles/resourcemanager.projectIamAdmin	Clusterprojekt	Berechtigung zum Verwalten von Cloud IAM-Richtlinien für Projekte
Dienstkontoadministrator	roles/iam.serviceAccountAdmin	Flottenprojekt	Authentifizierung als Dienstkonto.
Service Management-Administrator	roles/servicemanagement.admin	Flottenprojekt	Vollständige Kontrolle über Google Service Management-Ressourcen.
Service Usage-Administrator	roles/serviceusage.serviceUsageAdmin	Flottenprojekt	Erlaubnis, Dienststatus zu aktivieren, zu deaktivieren und zu überprüfen, Vorgänge zu überprüfen, sowie Kontingent und Abrechnung für ein Nutzerprojekt zu verarbeiten.^(Hinweis 1)
CA Service-Administrator ^Beta	roles/privateca.admin	Flottenprojekt	Vollständiger Zugriff auf alle CA Service-Ressourcen. ^(Hinweis 2)

Hinweise:

Service Usage-Administrator: Diese Rolle ist erforderlich, um die mesh.googleapis.com API zu aktivieren, wenn Sie ein verwaltetes Cloud Service Mesh zum ersten Mal bereitstellen.
CA-Dienstadministrator: Diese Rolle ist nur erforderlich, wenn Sie eine Einbindung in den CA-Dienst vornehmen.

Cloud Service Mesh installieren.

Im Folgenden wird beschrieben, wie Sie Cloud Service Mesh installieren:

Führen Sie asmcli install aus, um die clusterinterne Steuerungsebene in einem einzelnen Cluster zu installieren. In den folgenden Abschnitten finden Sie Beispiele für Befehlszeilen. Die Beispiele enthalten sowohl erforderliche Argumente als auch optionale Argumente, die für Sie nützlich sein könnten. Wir empfehlen, immer das Argument output_dir anzugeben, damit Sie Beispielgateways und -tools wie istioctl leicht finden können. In der Navigationsleiste auf der rechten Seite finden Sie eine Liste der Beispiele.
Optional können Sie ein Ingress-Gateway installieren. Standardmäßig installiert asmcli nicht das istio-ingressgateway. Wir empfehlen, die Steuerungsebene und die Gateways separat bereitzustellen und zu verwalten. Wenn Sie das standardmäßige istio-ingressgateway für die clusterinterne Steuerungsebene installieren möchten, fügen Sie das Argument --option legacy-default-ingressgateway ein.
Damit die Einrichtung von Cloud Service Mesh abgeschlossen werden kann, müssen Sie die automatische Sidecar-Injektion aktivieren und die Arbeitslasten (noch einmal) bereitstellen.
Wenn Sie Cloud Service Mesh auf mehreren Clustern installieren, führen Sie in jedem Cluster asmcli install aus. Achten Sie beim Ausführen von asmcli install darauf, für jeden Cluster dieselbe FLEET_PROJECT_ID zu verwenden. Nachdem Cloud Service Mesh installiert ist, lesen Sie die Anweisungen zum Einrichten eines Multi-Cluster-Meshs außerhalb von Google Cloud.
Wenn sich Ihre Cluster in verschiedenen Netzwerken befinden (weil sie im Inselmodus sind), sollten Sie mithilfe des Flags --network_id einen eindeutigen Netzwerknamen an asmcli übergeben.

Standardfeatures und Mesh-CA installieren

In diesem Abschnitt wird beschrieben, wie Sie asmcli ausführen, um Cloud Service Mesh mit den unterstützten Standardfeatures für Ihre Plattform zu installieren und die Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle zu aktivieren.

Lokal

Führen Sie die folgenden Befehle in der Google Distributed Cloud (nur Software) für VMware oder der Google Distributed Cloud (nur Software) für Bare Metal aus, um die Steuerungsebene mit Standardfeatures und der Cloud Service Mesh-Zertifizierungsstelle zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. asmcli konfiguriert die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte.

Wenn Sie SLOs und Infrastrukturmesswerte in der Cloud Service Mesh-UI aufrufen möchten, müssen Sie auch die ersten drei Schritte unter Logging und Monitoring für Anwendungen aktivieren ausführen. Wenn Logging und Monitoring nicht aktiviert sind und keine benutzerdefinierten Logs und Messwerte erhalten, zeigt das Cloud Service Mesh-Dashboard keine SLOs, Fehlerlogs oder CPU- und Speichermesswerte an.

AWS

Führen Sie die folgenden Befehle in GKE in AWS aus, um die Steuerungsebene mit Standardfeatures und der Cloud Service Mesh-Zertifizierungsstelle zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. asmcli konfiguriert die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte.

Azure

Führen Sie die folgenden Befehle in GKE on Azure aus, um die Steuerungsebene mit Standardfeatures und der Cloud Service Mesh-Zertifizierungsstelle zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca mesh_ca
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. asmcli konfiguriert die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte.

Amazon EKS

Führen Sie die folgenden Befehle in Amazon EKS aus, um die Steuerungsebene mit Standardfeatures und der Cloud Service Mesh-Zertifizierungsstelle zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --option attached-cluster \
  --network_id default \
  --ca mesh_ca
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --option attached-cluster Das Standardsignaturtool wird in „istiod“ geändert.
- --network_id Wenn Sie ein Multi-Netzwerk-Mesh einrichten, legen Sie für jeden Cluster im Mesh einen eindeutigen Wert für --network_id fest.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. asmcli konfiguriert die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte.

Wenn Sie SLOs und Infrastrukturmesswerte in der Cloud Service Mesh-Benutzeroberfläche aufrufen möchten, müssen Sie auch die ersten drei Schritte unter Logging und Monitoring für Anwendungen aktivieren ausführen. Wenn Logging und Monitoring nicht aktiviert sind und keine benutzerdefinierten Logs und Messwerte erhalten, zeigt das Cloud Service Mesh-Dashboard keine SLOs, Fehlerlogs oder CPU- und Speichermesswerte an.

Microsoft AKS

Führen Sie die folgenden Befehle in Microsoft AKS aus, um die Steuerungsebene mit Standardfeatures und der Cloud Service Mesh-Zertifizierungsstelle zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --option attached-cluster \
  --network_id default \
  --ca mesh_ca
```
- HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Ermöglicht die Registrierung bei GKE Hub.
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --option attached-cluster Das Standardsignaturtool wird in „istiod“ geändert.
- --network_id Wenn Sie ein Multi-Netzwerk-Mesh einrichten, legen Sie für jeden Cluster im Mesh einen eindeutigen Wert für --network_id fest.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. asmcli konfiguriert die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte.

Standardfeatures und Certificate Authority (CA) Service installieren

In diesem Abschnitt wird beschrieben, wie Sie asmcli ausführen, um Cloud Service Mesh mit den unterstützten Standardfeatures für Ihre Plattform zu installieren und CA Service als Zertifizierungsstelle zu aktivieren.

Plattformhinweis: CA Service wird nur auf den folgenden Plattformen unterstützt: GKE-Cluster in Google Cloud, Google Distributed Cloud (nur Software) für VMware und Distributed Cloud. Wenn Sie asmcli install ausführen und --ca gcp_cas auf anderen Plattformen angeben, wird die Installation als erfolgreich angezeigt. Ihre Arbeitslasten können jedoch nicht gestartet werden.

Neben der Cloud Service Mesh-Zertifizierungsstelle können Sie Cloud Service Mesh auch für die Verwendung des Certificate Authority Service konfigurieren. Dieser Leitfaden bietet eine Möglichkeit zur Integration in CA Service, die für die folgenden Anwendungsfälle empfohlen wird:

Wenn Sie unterschiedliche CAs benötigen, um Arbeitslastzertifikate auf unterschiedlichen Clustern zu signieren.
Wenn Sie Ihre Signaturschlüssel in einem verwalteten HSM sichern müssen.
Wenn Sie in einer stark regulierten Branche tätig sind und der Compliance unterliegen.
Wenn Sie Ihre Cloud Service Mesh-Zertifizierungsstelle mit einem benutzerdefinierten Unternehmensstammzertifikat verketten möchten, um Arbeitslast-Zertifikate zu signieren.

Die Kosten für die Cloud Service Mesh-Zertifizierungsstelle sind im Preis für Cloud Service Mesh inbegriffen. CA Service ist nicht im Basispreis für Cloud Service Mesh enthalten und wird separat in Rechnung gestellt. Darüber hinaus enthält CA Service ein explizites SLA, die Cloud Service Mesh-Zertifizierungsstelle jedoch nicht.

CA Service konfigurieren

Achten Sie darauf, dass sich der CA-Pool in der Stufe DevOps und in derselben Region wie der Cluster befindet, den er bedient, um übermäßige Latenzprobleme oder potenzielle regionenübergreifende Ausfälle zu vermeiden. Weitere Informationen finden Sie unter Arbeitslastoptimierte Stufen.
Erstellen Sie den CA-Pool, um mindestens eine aktive Zertifizierungsstelle in diesem CA-Pool zu erhalten, die sich im selben Projekt wie der GKE-Cluster befindet. Verwenden Sie untergeordnete CAs, um Cloud Service Mesh-Arbeitslastzertifikate zu signieren. Notieren Sie sich den CA-Pool, der der untergeordneten Zertifizierungsstelle entspricht.

Wenn nur Zertifikate für Cloud Service Mesh-Arbeitslasten signiert werden sollen, richten Sie die folgende Ausstellungsrichtlinie für den CA-Pool ein:

policy.yaml

baselineValues:
  keyUsage:
    baseKeyUsage:
      digitalSignature: true
      keyEncipherment: true
    extendedKeyUsage:
      serverAuth: true
      clientAuth: true
  caOptions:
    isCa: false
identityConstraints:
  allowSubjectPassthrough: false
  allowSubjectAltNamesPassthrough: true
  celExpression:
    expression: subject_alt_names.all(san, san.type == URI && san.value.startsWith("spiffe://PROJECT_ID.svc.id.goog/ns/") )

Mit dem folgenden Befehl können Sie die Ausstellungsrichtlinie des CA-Pools aktualisieren:
```
gcloud privateca pools update CA_POOL --location ca_region --issuance-policy policy.yaml
```
Informationen zum Festlegen einer Richtlinie für einen Pool finden Sie unter Zertifikatsausstellungsrichtlinie verwenden.
Wenn Sie eine Zertifikatsvorlage verwenden, konfigurieren Sie diese jetzt. Weitere Informationen finden Sie im CA Service-Leitfaden für Workload Identity-Zertifikate. Die Zertifikatvorlage muss in derselben Region wie der CA-Pool erstellt werden. Wenn es mehrere Regionen für CA-Pools gibt, erstellen Sie eine Zertifikatvorlage pro Region.

Cloud Service Mesh für die Verwendung von CA Service konfigurieren

Führen Sie die folgenden Befehle in der Google Distributed Cloud (nur Software) für VMware oder der Google Distributed Cloud (nur Software) für Bare Metal aus, um die Steuerungsebene mit Standardfeatures und Certificate Authority Service zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --kubeconfig KUBECONFIG_FILE \
  --fleet_id FLEET_PROJECT_ID \
  --output_dir DIR_PATH \
  --enable_all \
  --ca gcp_cas \
  --platform multicloud \
  --ca_pool  projects/CA_POOL_PROJECT_ID/locations/ca_region/caPools/CA_POOL
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --ca gcp_casVerwenden Sie Certificate Authority Service als Zertifizierungsstelle. Das Ändern von Zertifizierungsstellen während eines Upgrades führt zu Ausfallzeiten. asmcli konfiguriert Certificate Authority Service für die Verwendung der Workload Identity der Flotte.
- --ca_pool Die vollständige Kennung für den CA-Pool des Certificate Authority Service. Wenn Sie eine Zertifikatsvorlage verwenden, hängen Sie die Vorlagen-ID durch : getrennt an. Beispiel:
```
  --ca_pool projects/CA_POOL_PROJECT_ID/locations/ca_region/caPools/CA_POOL:projects/CA_POOL_PROJECT_ID/locations/ca_region/certificateTemplates/CERT_TEMPLATE_ID
  
```
Wenn Sie SLOs und Infrastrukturmesswerte in der Cloud Service Mesh-UI aufrufen möchten, müssen Sie auch die ersten drei Schritte unter Logging und Monitoring für Anwendungen aktivieren ausführen. Wenn Logging und Monitoring nicht aktiviert sind und keine benutzerdefinierten Logs und Messwerte erhalten, zeigt das Cloud Service Mesh-Dashboard keine SLOs, Fehlerlogs oder CPU- und Speichermesswerte an.

Standardfeatures mit Istio-CA installieren

In diesem Abschnitt wird Folgendes erläutert:

Zertifikate und Schlüssel für die Istio-Zertifizierungsstelle generieren, die Cloud Service Mesh zum Signieren Ihrer Arbeitslasten verwendet
asmcli ausführen, um Cloud Service Mesh mit Standardfeatures zu installieren und Istio-CA zu aktivieren

Standardmäßig Umgebungen, die Cloud Service Mesh mit Istio-CA-Messwerten auf Prometheus installieren. Wenn Sie die Cloud Service Mesh-Dashboards verwenden möchten, müssen Sie Stackdriver aktivieren. Weitere Informationen finden Sie unter Mit optionalen Funktionen installieren.

Für eine optimale Sicherheit empfehlen wir dringend, eine Offline-Stamm-CA zu behalten und die untergeordneten Zertifizierungsstellen einzusetzen, um für jeden Cluster Zertifikate auszugeben. Weitere Informationen finden Sie unter CA-Zertifikate anschließen. In dieser Konfiguration verwenden alle Arbeitslasten im Service Mesh dieselbe Stammzertifizierungsstelle (Certificate Authority, CA). Jede Cloud Service Mesh CA verwendet einen Zwischen-CA-Signaturschlüssel und ein Zertifikat, das von der Stamm-CA signiert wird. Wenn es in einem Mesh mehrere CAs gibt, wird eine Hierarchie des Vertrauens zwischen den CAs eingerichtet. Sie können diese Schritte wiederholen, um Zertifikate und Schlüssel für eine beliebige Anzahl von Zertifizierungsstellen bereitzustellen.

Das Makefile zum Generieren der Zertifikate befindet sich im Unterverzeichnis istio-1.21.5-asm.12 im Verzeichnis --output_dir, das Sie im Befehl asmcli validate angegeben haben. Wenn Sie asmcli validate nicht ausgeführt haben oder das heruntergeladene Verzeichnis nicht lokal haben, können Sie das Makefile erhalten, indem Sie die Cloud Service Mesh-Installationsdatei herunterladen und den Inhalt extrahieren.

Wechseln Sie zum Verzeichnis istio-1.21.5-asm.12.
Erstellen Sie ein Verzeichnis für die Zertifikate und Schlüssel:
```
mkdir -p certs && \
pushd certs
```
Generieren Sie ein Root-Zertifikat und einen Root-Schlüssel:
```
make -f ../tools/certs/Makefile.selfsigned.mk root-ca
```
Dadurch werden diese Dateien generiert:
- root-cert.pem: Root-Zertifikat
- root-key.pem: Root-Schlüssel
- root-ca.conf: Konfiguration für openssl, um das Root-Zertifikat zu generieren
- root-cert.csr: CSR für das Root-Zertifikat
Generieren Sie ein Zwischenzertifikat und einen Zwischenschlüssel:
```
make -f ../tools/certs/Makefile.selfsigned.mk cluster1-cacerts
```
Dadurch werden diese Dateien in einem Verzeichnis namens cluster1 generiert:
- ca-cert.pem: Zwischenzertifikate
- ca-key.pem: Zwischenschlüssel
- cert-chain.pem: Die von istiod verwendete Zertifikatskette
- root-cert.pem: Root-Zertifikat
Hinweis: Sie können cluster1 durch einen anderen Namen ersetzen. Beispiel: make mycluster-cacerts erstellt ein Verzeichnis mit dem Namen mycluster.

Wenn Sie diese Schritte mit einem Offline-Computer ausführen, kopieren Sie das generierte Verzeichnis auf einen Computer mit Zugriff auf die Cluster.
Kehren Sie zum vorherigen Verzeichnis zurück:
```
popd
```
Führen Sie asmcli aus, um ein Mesh-Netzwerk mit Istio-CA zu installieren:
Lokal
Führen Sie die folgenden Befehle in Google Distributed Cloud (nur Software) für VMware oder Google Distributed Cloud (nur Software) für Bare Metal aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.
1. Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
  kubectl config use-context CLUSTER_NAME
2. Führen Sie asmcli install aus.
  ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH
  - --fleet_id: Projekt-ID des Hostprojekts der Flotte.
  - --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
  - --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
  - --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
  - --enable_all: Ermöglicht dem Skript Folgendes:
    
    Erforderliche IAM-Berechtigungen gewähren.
    
    Erforderliche Google APIs aktivieren.
    
    Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
    
    Cluster bei der Flotte registrieren, falls noch nicht geschehen.
  - -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
  - --ca_cert: Zwischenzertifikat.
  - --ca_key: Schlüssel für das Zwischenzertifikat.
  - --root_cert: Root-Zertifikat.
  - --cert_chain: Zertifikatskette.
AWS
Führen Sie die folgenden Befehle in GKE auf AWS aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein. Sie können Ingress für das öffentliche oder das private Subnetz aktivieren.
Öffentlich

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:

kubectl config use-context CLUSTER_NAME

Führen Sie asmcli install aus.

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH

--fleet_id: Projekt-ID des Hostprojekts der Flotte.

--kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
--output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.

--platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
--enable_all: Ermöglicht dem Skript Folgendes:

Erforderliche IAM-Berechtigungen gewähren.

Erforderliche Google APIs aktivieren.

Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.

Cluster bei der Flotte registrieren, falls noch nicht geschehen.

-ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.

--ca_cert: Zwischenzertifikat.

--ca_key: Schlüssel für das Zwischenzertifikat.

--root_cert: Root-Zertifikat.

--cert_chain Zertifikatskette.
Privat

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:

kubectl config use-context CLUSTER_NAME

Speichern Sie die folgende YAML-Datei in einer Datei mit dem Namen istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1 kind: IstioOperator spec: components: ingressGateways: - enabled: true k8s: serviceAnnotations: service.beta.kubernetes.io/aws-load-balancer-internal: "true" name: istio-ingressgateway

Führen Sie asmcli install aus.

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert FILE_PATH \ --ca_key FILE_PATH \ --root_cert FILE_PATH \ --cert_chain FILE_PATH \ --custom_overlay istio-operator-internal-lb.yaml

--fleet_id: Projekt-ID des Hostprojekts der Flotte.

--kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
--output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.

--platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
--enable_all: Ermöglicht dem Skript Folgendes:

Erforderliche IAM-Berechtigungen gewähren.

Erforderliche Google APIs aktivieren.

Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.

Cluster bei der Flotte registrieren, falls noch nicht geschehen.

-ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.

--ca_cert: Zwischenzertifikat.

--ca_key: Schlüssel für das Zwischenzertifikat.

--root_cert: Root-Zertifikat.

--cert_chain Zertifikatskette.

--custom_overlay: der Name der erstellten Overlay-Datei Weitere Informationen zu Overlay-Dateien finden Sie unter Optionale Funktionen auf der Steuerungsebene im Cluster aktivieren.
Azure
Führen Sie die folgenden Befehle in GKE on Azure aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein. Sie können Ingress für das öffentliche oder das private Subnetz aktivieren.
Öffentlich

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:

kubectl config use-context CLUSTER_NAME

Führen Sie asmcli install aus.

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH

--fleet_id: Projekt-ID des Hostprojekts der Flotte.

--kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
--output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.

--platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
--enable_all: Ermöglicht dem Skript Folgendes:

Erforderliche IAM-Berechtigungen gewähren.

Erforderliche Google APIs aktivieren.

Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.

Cluster bei der Flotte registrieren, falls noch nicht geschehen.

-ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.

--ca_cert: Zwischenzertifikat.

--ca_key: Schlüssel für das Zwischenzertifikat.

--root_cert: Root-Zertifikat.

--cert_chain Zertifikatskette.
Privat

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:

kubectl config use-context CLUSTER_NAME

Speichern Sie die folgende YAML-Datei in einer Datei mit dem Namen istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1 kind: IstioOperator spec: components: ingressGateways: - enabled: true k8s: serviceAnnotations: service.beta.kubernetes.io/aws-load-balancer-internal: "true" name: istio-ingressgateway

Führen Sie asmcli install aus.

./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --ca citadel \ --ca_cert FILE_PATH \ --ca_key FILE_PATH \ --root_cert FILE_PATH \ --cert_chain FILE_PATH \ --custom_overlay istio-operator-internal-lb.yaml

--fleet_id: Projekt-ID des Hostprojekts der Flotte.

--kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
--output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.

--platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
--enable_all: Ermöglicht dem Skript Folgendes:

Erforderliche IAM-Berechtigungen gewähren.

Erforderliche Google APIs aktivieren.

Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.

Cluster bei der Flotte registrieren, falls noch nicht geschehen.

-ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.

--ca_cert: Zwischenzertifikat.

--ca_key: Schlüssel für das Zwischenzertifikat.

--root_cert: Root-Zertifikat.

--cert_chain Zertifikatskette.

--custom_overlay: der Name der erstellten Overlay-Datei Weitere Informationen zu Overlay-Dateien finden Sie unter Optionale Funktionen auf der Steuerungsebene im Cluster aktivieren.
Amazon EKS
Führen Sie die folgenden Befehle in Amazon EKS aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.
1. Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
  kubectl config use-context CLUSTER_NAME
2. Führen Sie asmcli install aus.
  ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --option attached-cluster \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH \ --network_id default
  - --fleet_id: Projekt-ID des Hostprojekts der Flotte.
  - --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
  - --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
  - --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
  - --enable_all: Ermöglicht dem Skript Folgendes:
    
    Erforderliche IAM-Berechtigungen gewähren.
    
    Erforderliche Google APIs aktivieren.
    
    Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
    
    Cluster bei der Flotte registrieren, falls noch nicht geschehen.
  - --option attached-cluster Das Standardsignaturtool wird in „istiod“ geändert.
  - -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
  - --ca_cert: Zwischenzertifikat.
  - --ca_key: Schlüssel für das Zwischenzertifikat.
  - --root_cert: Root-Zertifikat.
  - --cert_chain: Zertifikatskette.
  - --network_id Wenn Sie ein Mesh-Netzwerk mit mehreren Netzwerken einrichten, legen Sie für jeden Cluster im Mesh einen eindeutigen Wert für --network_id fest.
Microsoft AKS
Führen Sie die folgenden Befehle in Microsoft AKS aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.
1. Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
  kubectl config use-context CLUSTER_NAME
2. Führen Sie asmcli install aus.
  HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \ --fleet_id FLEET_PROJECT_ID \ --kubeconfig KUBECONFIG_FILE \ --output_dir DIR_PATH \ --platform multicloud \ --enable_all \ --option attached-cluster \ --ca citadel \ --ca_cert CA_CERT_FILE_PATH \ --ca_key CA_KEY_FILE_PATH \ --root_cert ROOT_CERT_FILE_PATH \ --cert_chain CERT_CHAIN_FILE_PATH \ --network_id default
  - HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Ermöglicht die Registrierung bei GKE Hub.
  - --fleet_id: Projekt-ID des Hostprojekts der Flotte.
  - --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
  - --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
  - --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
  - --enable_all: Ermöglicht dem Skript Folgendes:
    
    Erforderliche IAM-Berechtigungen gewähren.
    
    Erforderliche Google APIs aktivieren.
    
    Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
    
    Cluster bei der Flotte registrieren, falls noch nicht geschehen.
  - --option attached-cluster Das Standardsignaturtool wird in „istiod“ geändert.
  - -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
  - --ca_cert: Zwischenzertifikat.
  - --ca_key: Schlüssel für das Zwischenzertifikat.
  - --root_cert: Root-Zertifikat.
  - --cert_chain: Zertifikatskette.
  - --network_id Wenn Sie ein Mesh-Netzwerk mit mehreren Netzwerken einrichten, legen Sie für jeden Cluster im Mesh einen eindeutigen Wert für --network_id fest.

Installation mit Istio-Zertifizierungsstelle mit aktivierter Google Cloud Observability

Wenn Sie Cloud Service Mesh-Dashboards verwenden möchten, müssen Sie Stackdriver aktivieren.

Lokal

Führen Sie die folgenden Befehle in der Google Distributed Cloud (nur Software) für VMware oder in der Google Distributed Cloud (nur Software) für Bare Metal aus, um die Steuerungsebene mit Stackdriver und anderen optionalen Features und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
   --fleet_id FLEET_PROJECT_ID \
   --kubeconfig KUBECONFIG_FILE \
   --output_dir DIR_PATH \
   --platform multicloud \
   --enable_all \
   --ca citadel \
   --ca_cert CA_CERT_FILE_PATH \
   --ca_key CA_KEY_FILE_PATH \
   --root_cert ROOT_CERT_FILE_PATH \
   --cert_chain CERT_CHAIN_FILE_PATH
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain: Zertifikatskette.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren.
Wenn Sie SLOs und Infrastrukturmesswerte in der Cloud Service Mesh-Benutzeroberfläche aufrufen möchten, müssen Sie auch die ersten drei Schritte unter Logging und Monitoring für Anwendungen aktivieren ausführen. Wenn Logging und Monitoring nicht aktiviert sind und keine benutzerdefinierten Logs und Messwerte erhalten, zeigt das Cloud Service Mesh-Dashboard keine SLOs, Fehlerlogs oder CPU- und Speichermesswerte an.

AWS

Führen Sie die folgenden Befehle in GKE auf AWS aus, um die Steuerungsebene mit Stackdriver und anderen optionalen Features und Istio CA zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein. Sie können Ingress für das öffentliche oder das private Subnetz aktivieren.

Öffentlich

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain Zertifikatskette.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren.

Privat

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```

Speichern Sie die folgende YAML-Datei in einer Datei mit dem Namen istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    ingressGateways:
    - enabled: true
      k8s:
        serviceAnnotations:
          service.beta.kubernetes.io/aws-load-balancer-internal: "true"
      name: istio-ingressgateway

Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert FILE_PATH \
  --ca_key FILE_PATH \
  --root_cert FILE_PATH \
  --cert_chain FILE_PATH
  --custom_overlay istio-operator-internal-lb.yaml \
  --option stackdriver
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain Zertifikatskette.
- --custom_overlay: der Name der erstellten Overlay-Datei Weitere Informationen zu Overlay-Dateien finden Sie unter Optionale Funktionen auf der Steuerungsebene im Cluster aktivieren.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren. Alternativ können Sie Stackdriver mit --custom_overlay stackdriver.yaml aktivieren. Sie müssen entweder anthos-service-mesh-package herunterladen oder stackdriver.yaml aus dem bereitgestellten Manifest erstellen.

Azure

Führen Sie die folgenden Befehle in GKE on Azure aus, um die Steuerungsebene mit Stackdriver und anderen optionalen Features und Istio CA zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein. Sie können Ingress für das öffentliche oder das private Subnetz aktivieren.

Öffentlich

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain Zertifikatskette.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren.

Privat

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```

Speichern Sie die folgende YAML-Datei in einer Datei mit dem Namen istio-operator-internal-lb.yaml:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    ingressGateways:
    - enabled: true
      k8s:
        serviceAnnotations:
          service.beta.kubernetes.io/aws-load-balancer-internal: "true"
      name: istio-ingressgateway

Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert FILE_PATH \
  --ca_key FILE_PATH \
  --root_cert FILE_PATH \
  --cert_chain FILE_PATH
  --custom_overlay istio-operator-internal-lb.yaml \
  --option stackdriver
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain Zertifikatskette.
- --custom_overlay: der Name der erstellten Overlay-Datei Weitere Informationen zu Overlay-Dateien finden Sie unter Optionale Funktionen auf der Steuerungsebene im Cluster aktivieren.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren. Alternativ können Sie Stackdriver mit --custom_overlay stackdriver.yaml aktivieren. Sie müssen entweder anthos-service-mesh-package herunterladen oder stackdriver.yaml aus dem bereitgestellten Manifest erstellen.

Amazon EKS

Führen Sie die folgenden Befehle in Amazon EKS aus, um die Steuerungsebene mit Stackdriver und anderen optionalen Features und Istio CA zu installieren. Geben Sie Ihre Werte in die angegebenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver \
  --option attached-cluster
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain: Zertifikatskette.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren.
- --option stackdriver Ändert das Standardsignatur-Dienstprogramm in istiod.

Microsoft AKS

Führen Sie die folgenden Befehle in Microsoft AKS aus, um die Steuerungsebene mit Standardfeatures und Istio CA zu installieren. Geben Sie Ihre Werte in die vorhandenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus.
```
HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer ./asmcli install \
  --fleet_id FLEET_PROJECT_ID \
  --kubeconfig KUBECONFIG_FILE \
  --output_dir DIR_PATH \
  --platform multicloud \
  --enable_all \
  --ca citadel \
  --ca_cert CA_CERT_FILE_PATH \
  --ca_key CA_KEY_FILE_PATH \
  --root_cert ROOT_CERT_FILE_PATH \
  --cert_chain CERT_CHAIN_FILE_PATH \
  --option stackdriver \
  --option attached-cluster
```
- HUB_REGISTRATION_EXTRA_FLAGS=--has-private-issuer Ermöglicht die Registrierung bei GKE Hub.
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- -ca citadel: Verwenden Sie Istio-CA als Zertifizierungsstelle.
- --ca_cert: Zwischenzertifikat.
- --ca_key: Schlüssel für das Zwischenzertifikat.
- --root_cert: Root-Zertifikat.
- --cert_chain: Zertifikatskette.
- --option stackdriver Aktiviert Stackdriver. Sie können auch Stackdriver und Prometheus mit --option prometheus-and-stackdriver aktivieren.
- --option stackdriver Ändert das Standardsignatur-Dienstprogramm in istiod.

Mit optionalen Features installieren

Eine Overlay-Datei ist eine YAML-Datei mit einer benutzerdefinierten IstioOperator-Ressource, die Sie an asmcli übergeben, um die Steuerungsebene zu konfigurieren. Sie können die Standardkonfiguration der Steuerungsebene überschreiben und eine optionale Funktion aktivieren, indem Sie die YAML-Datei an asmcli übergeben. Sie können mehr Overlays übereinander legen. Jede Overlay-Datei überschreibt die Konfiguration auf den vorherigen Ebenen. Als Best Practice empfehlen wir, dass Sie die Overlay-Dateien in Ihrem Versionsverwaltungssystem speichern.

Es gibt zwei Optionen, um optionale Funktionen zu aktivieren: --option und --custom_overlay.

Verwenden Sie --option, wenn Sie die Overlay-Datei nicht ändern müssen. Mit dieser Methode asmcli wird die Datei aus dem GitHub-Repository abgerufen.

Verwenden Sie --custom_overlay, wenn Sie die Overlay-Datei anpassen müssen.

Weitere Informationen finden Sie unter Optionale Funktionen auf der Steuerungsebene im Cluster aktivieren.

Führen Sie die folgenden Befehle in der Google Distributed Cloud (nur Software) für VMware, der Google Distributed Cloud (nur Software) für Bare Metal, GKE on AWS, GKE on Azure, Amazon EKS oder Microsoft AKS aus. Geben Sie Ihre Werte in die angegebenen Platzhalter ein.

Legen Sie Ihren Nutzercluster als aktuellen Kontext fest:
```
kubectl config use-context CLUSTER_NAME
```
Führen Sie asmcli install aus, um die Steuerungsebene mit einem optionalen Feature zu installieren. Wenn Sie mehrere Dateien hinzufügen möchten, geben Sie --custom_overlay und den Dateinamen ein. Beispiel: --custom_overlayoverlay_file1.yaml --custom_overlay overlay_file2.yaml --custom_overlay overlay_file3.yaml
```
./asmcli install \
--fleet_id FLEET_PROJECT_ID \
--kubeconfig KUBECONFIG_FILE \
--output_dir DIR_PATH \
--platform multicloud \
--enable_all \
--ca mesh_ca \
--custom_overlay OVERLAY_FILE
```
- --fleet_id: Projekt-ID des Hostprojekts der Flotte.
- --kubeconfig Der vollständige Pfad zur kubeconfig-Datei. Die Umgebungsvariable $PWD funktioniert hier nicht. Darüber hinaus funktionieren relative kubeconfig-Dateispeicherorte, die „~“ verwenden, nicht.
- --output_dir: Fügen Sie diese Option hinzu, um ein Verzeichnis anzugeben, in das asmcli das Paket anthos-service-mesh herunterlädt und in dem die Installationsdatei extrahiert wird, die istioctl, Beispiele und Manifeste enthält. Andernfalls lädt asmcli die Dateien in ein tmp-Verzeichnis herunter. Sie können entweder einen relativen Pfad oder einen vollständigen Pfad angeben. Die Umgebungsvariable $PWD funktioniert hier nicht.
- --platform multicloud Gibt an, dass es sich bei der Plattform um etwas anderes als Google Cloud handelt, z. B. eine lokale oder Multi-Cloud-Plattform.
- --enable_all: Ermöglicht dem Skript Folgendes:
  - Erforderliche IAM-Berechtigungen gewähren.
  - Erforderliche Google APIs aktivieren.
  - Im Cluster ein Label festlegen, das das Mesh-Netzwerk identifiziert.
  - Cluster bei der Flotte registrieren, falls noch nicht geschehen.
- --ca mesh_ca Cloud Service Mesh-Zertifizierungsstelle als Zertifizierungsstelle verwenden. Beachten Sie, dass asmcli die Cloud Service Mesh-Zertifizierungsstelle für die Verwendung der Workload Identity der Flotte konfiguriert.
- --custom_overlay: Den Namen der Overlay-Datei angeben.

Gateways installieren

Cloud Service Mesh bietet Ihnen die Möglichkeit, Gateways als Teil Ihres Service Mesh bereitzustellen und zu verwalten. Ein Gateway beschreibt einen Load-Balancer, der am Rand des Mesh-Netzwerks arbeitet und eingehende oder ausgehende HTTP/TCP-Verbindungen empfängt. Gateways sind Envoy-Proxys, die Ihnen eine detaillierte Kontrolle über den in das Mesh-Netzwerk eingehenden und ausgehenden Traffic ermöglichen.

Erstellen Sie einen Namespace für das Ingress-Gateway, falls Sie noch keinen haben. Gateways sind Nutzerarbeitslasten und sollten als Best Practice nicht im Namespace der Steuerungsebene bereitgestellt werden. Ersetzen Sie GATEWAY_NAMESPACE durch den Namen Ihres Namespace.
```
kubectl create namespace GATEWAY_NAMESPACE
```
Erwartete Ausgabe:
```
namespace/GATEWAY_NAMESPACE created
```
Aktivieren Sie die automatische Einfügung auf dem Gateway. Welche Schritte erforderlich sind, hängt davon ab, ob Sie Standardlabels für Einfügungen (Beispiel:istio-injection=enabled) oder die Überarbeitungslabel im Gateway-Namespace verwenden möchten. Das Standard-Überarbeitungs-Tag und das Überarbeitungslabel werden vom Sidecar-Injektor-Webhook dazu verwendet, eingefügte Proxys einer bestimmten Überarbeitung der Steuerungsebene zuzuordnen.
Standard (empfohlen)
1. Wenn Sie eine Standard-Tag-Überarbeitung verwendet haben, um die automatische Injektion auf dem Gateway zu aktivieren, prüfen Sie, ob das Standard-Tag in dem von Ihnen in --output_dir angegebenen Verzeichnis vorhanden ist und auf die neu installierte Überarbeitung verweist.
  DIR_PATH/istioctl tag list
2. Wenden Sie die Standard-Injektionslabels auf den Namespace an.
  kubectl label namespace GATEWAY_NAMESPACE istio-injection=enabled istio.io/rev-
Überarbeitungslabel
1. Verwenden Sie den folgenden Befehl, um das Überarbeitungslabel für istiod zu finden:
  kubectl get deploy -n istio-system -l app=istiod -o \ "jsonpath={.items[*].metadata.labels['istio\.io/rev']}{'\n'}"
  Der Befehl gibt das Überarbeitungslabel aus, das der Cloud Service Mesh-Version entspricht, z. B. asm-1215-12.
2. Wenden Sie das Überarbeitungslabel auf den Namespace an. Im folgenden Befehl ist REVISION der Wert des Überarbeitungslabels istiod, den Sie im vorherigen Schritt notiert haben.
  kubectl label namespace GATEWAY_NAMESPACE \ istio.io/rev=REVISION --overwrite
  Erwartete Ausgabe:
  namespace/GATEWAY_NAMESPACE labeled
Sie können die Nachricht "istio.io/rev" not found in der Ausgabe ignorieren. Das bedeutet, dass der Namespace bisher nicht das Label istio.io/rev hatte, was bei Neuinstallationen von Cloud Service Mesh oder neuen Bereitstellungen zu erwarten wäre. Da die automatische Injektion fehlschlägt, wenn ein Namespace sowohl das Label istio.io/rev als auch das Label istio-injection enthält, werden in allen kubectl label-Befehlen in der Cloud Service Mesh-Dokumentation beide Labels explizit angegeben.

Wenn der Gateway-Namespace nicht gekennzeichnet ist, schlagen die istio-ingressgateway-Pods mit einem ImagePullBackOff-Fehler fehl, wenn das Gateway versucht, das auto-Image abzurufen. Dieses Bild sollte durch den Webhook ersetzt werden.
Laden Sie die Beispiel-YAML-Konfigurationsdatei für das Ingress-Gateway aus dem Repository anthos-service-mesh-packages herunter.

Sie können die Beispiel-YAML-Konfiguration für das Ingress-Gateway unverändert anwenden oder nach Bedarf ändern.

kubectl apply -n GATEWAY_NAMESPACE \
  -f CONFIG_PATH/istio-ingressgateway

Erwartete Ausgabe:

deployment.apps/istio-ingressgateway created
poddisruptionbudget.policy/istio-ingressgateway created
horizontalpodautoscaler.autoscaling/istio-ingressgateway created
role.rbac.authorization.k8s.io/istio-ingressgateway created
rolebinding.rbac.authorization.k8s.io/istio-ingressgateway created
service/istio-ingressgateway created
serviceaccount/istio-ingressgateway created

Best Practices für Gateways

Arbeitslasten bereitstellen und neu bereitstellen

Cloud Service Mesh verwendet Sidecar-Proxys, um die Sicherheit, Zuverlässigkeit und Beobachtbarkeit von Netzwerken zu verbessern. Mit Cloud Service Mesh werden diese Funktionen vom primären Container der Anwendung abstrahiert und in einem gemeinsamen Out-of-Process-Proxy implementiert, der als separater Container im selben Pod bereitgestellt wird.

Die Installation ist erst abgeschlossen, wenn Sie die automatische Sidecar-Proxy-Einfügung (automatische Injektion) aktivieren und die Pods für alle Arbeitslasten neu starten, die auf dem Cluster ausgeführt wurden, bevor Sie Cloud Service Mesh installiert haben.

Um die automatische Injektion zu aktivieren, versehen Sie Ihre Namespaces mit den Standard-Injektionslabels, wenn das Standard-Tag eingerichtet ist, oder mit einem Überarbeitungslabel, das bei der Installation von Cloud Service Mesh auf istiod festgelegt wurde. Das Standard-Überarbeitungs-Tag und das Überarbeitungslabel werden vom Sidecar-Injektor-Webhook verwendet, um eingefügte Sidecars einer istiod-Überarbeitung zuzuordnen. Nachdem Sie das Label hinzugefügt haben, müssen alle im Namespace vorhandenen Pods neu gestartet werden, damit die Sidecars eingefügt werden.

Bevor Sie neue Arbeitslasten in einem neuen Namespace bereitstellen, müssen Sie die automatische Injektion konfigurieren, damit Cloud Service Mesh den Traffic überwachen und sichern kann.

Die Schritte zum Aktivieren der automatischen Injektion hängen davon ab, ob Sie Standard-Injektionslabels oder das Überarbeitungslabel verwenden möchten:
Standard (empfohlen)
1. Wenn Sie eine Standard-Tag-Überarbeitung verwendet haben, um die automatische Injektion auf dem Gateway zu aktivieren, prüfen Sie, ob das Standard-Tag in dem von Ihnen in --output_dir angegebenen Verzeichnis vorhanden ist und auf die neu installierte Überarbeitung verweist.
  DIR_PATH/istioctl tag list
2. Führen Sie den folgenden Befehl aus: NAMESPACE ist der Name des Namespace, in dem Sie die automatische Injektion aktivieren möchten.
  kubectl label namespace NAMESPACE istio-injection=enabled istio.io/rev-
Die Standard-Injektionslabels fügen die Überarbeitung ein, auf die das Standard-Tag verweist.
Überarbeitungslabel
1. Verwenden Sie den folgenden Befehl, um das Überarbeitungslabel für istiod zu finden:
  kubectl -n istio-system get pods -l app=istiod --show-labels
  Die Ausgabe sieht dann ungefähr so aus:
  NAME READY STATUS RESTARTS AGE LABELS istiod-asm-1215-12-5788d57586-bljj4 1/1 Running 0 23h app=istiod,istio.io/rev=asm-1215-12,istio=istiod,pod-template-hash=5788d57586 istiod-asm-1215-12-5788d57586-vsklm 1/1 Running 1 23h app=istiod,istio.io/rev=asm-1215-12,istio=istiod,pod-template-hash=5788d57586
  Notieren Sie sich den Wert des Überarbeitungslabels istiod aus der Ausgabe in der Spalte LABELS, das auf das Präfix istio.io/rev= folgt. In diesem Beispiel ist der Wert asm-1215-12.
2. Wenden Sie das Überarbeitungslabel an und entfernen Sie das Label istio-injection, falls vorhanden. Im folgenden Befehl ist NAMESPACE der Name des Namespace, in dem Sie die automatische Einfügung aktivieren möchten. REVISION ist das Überarbeitungslabel, das Sie im vorherigen Schritt notiert haben.
  kubectl label namespace NAMESPACE istio-injection- istio.io/rev=REVISION --overwrite
  Sie können die Nachricht "istio-injection not found" in der Ausgabe ignorieren. Das bedeutet, dass der Namespace bisher nicht das Label istio-injection hatte, was bei Neuinstallationen von Cloud Service Mesh oder neuen Bereitstellungen zu erwarten wäre. Da das Verhalten der automatischen Injektion nicht definiert ist, wenn ein Namespace sowohl istio-injection als auch das Überarbeitungslabel enthält, wird bei allen kubectl label-Befehlen in der Cloud Service Mesh-Dokumentation ausdrücklich darauf geachtet, dass nur eines davon festgelegt ist.
Wenn vor der Installation von Cloud Service Mesh in Ihrem Cluster Arbeitslasten ausgeführt wurden, starten Sie die Pods neu, um eine erneute Injektion auszulösen.

Wie Sie Pods neu starten, hängt von der Anwendung und der Umgebung ab, in der sich der Cluster befindet. Beispielsweise können Sie in Ihrer Staging-Umgebung einfach alle Pods löschen, wodurch sie neu gestartet werden. Aber in Ihrer Produktionsumgebung haben Sie vielleicht einen Prozess, der ein Blau/Grün-Deployment implementiert, sodass Pods sicher neu gestartet werden können, um Traffic-Unterbrechungen zu vermeiden.

Sie können kubectl verwenden, um einen rollierenden Neustart durchzuführen:
```
kubectl rollout restart deployment -n NAMESPACE
```

Nächste Schritte

Wenn Ihr Mesh aus Clustern außerhalb von Google Cloud besteht, lesen Sie Multi-Cluster-Mesh-Netzwerk außerhalb von Google Cloud einrichten.
Externe IP-Adresse lokal konfigurieren
Stellen Sie die Online Boutique-Beispielanwendung bereit.

Cloud Service Mesh für Kubernetes-Arbeitslasten außerhalb von Google Cloud installieren

Beschränkungen

Hinweise

Rollen, die zum Installieren von Cloud Service Mesh in einem Cluster erforderlich sind

Cloud Service Mesh installieren.

Standardfeatures und Mesh-CA installieren

Lokal

AWS

Azure

Amazon EKS

Microsoft AKS

Standardfeatures und Certificate Authority (CA) Service installieren

CA Service konfigurieren

policy.yaml

Cloud Service Mesh für die Verwendung von CA Service konfigurieren

Standardfeatures mit Istio-CA installieren

Lokal

AWS

Öffentlich

Privat

Azure

Öffentlich

Privat

Amazon EKS

Microsoft AKS

Installation mit Istio-Zertifizierungsstelle mit aktivierter Google Cloud Observability

Lokal

AWS

Öffentlich

Privat

Azure

Öffentlich

Privat

Amazon EKS

Microsoft AKS

Mit optionalen Features installieren

Gateways installieren

Standard (empfohlen)

Überarbeitungslabel

Arbeitslasten bereitstellen und neu bereitstellen

Standard (empfohlen)

Überarbeitungslabel

Nächste Schritte