Optionale Features auf einer clusterinternen Steuerungsebene aktivieren

Auf dieser Seite wird beschrieben, wie Sie optionale Features in Cloud Service Mesh mit einer clusterinternen Steuerungsebene aktivieren.

Wenn Sie Cloud Service Mesh im Cluster installieren, Funktionen, die standardmäßig aktiviert sind, unterscheiden sich je nach Plattform. Sie können die Standardkonfiguration überschreiben und ein optionales Feature aktivieren, indem Sie beim Installieren oder Upgraden von Cloud Service Mesh eine Overlay-Datei einfügen. Eine Overlay-Datei ist eine YAML-Datei, die eine benutzerdefinierte IstioOperator-Ressource (Custom Resource, CR) enthält, mit der Sie die Steuerungsebene konfigurieren. Geben Sie pro Overlay-Datei ein Feature an. Sie können mehrere Overlays ebenenweise platzieren. Jede Overlay-Datei überschreibt die Konfiguration auf den vorherigen Ebenen.

Achtung: Mit asmcli install wird die vorhandene Konfiguration der Steuerungsebene überschrieben. Wenn Sie optionale Funktionen für eine vorhandene Installation aktivieren, geben Sie alle Dateien an, die Sie im Original behalten möchten. sowie die Overlay-Dateien für die Funktionen, die Sie aktivieren. Wir empfehlen, die für die Installation verwendeten Overlay-Dateien in der Versionsverwaltung zu speichern, damit Sie bei Upgrades oder beim Aktivieren zusätzlicher optionaler Funktionen dieselben Konfigurationen auf Ihre Steuerungsebene anwenden können. So wird sichergestellt, dass es beim Aktivieren optionaler Funktionen keine Ausfallzeiten gibt.

Informationen zu Overlay-Dateien

Die Overlay-Dateien auf dieser Seite befinden sich im anthos-service-mesh -Paket in GitHub. Diese Dateien enthalten gängige Anpassungen der Standardkonfiguration. Sie können diese Dateien unverändert anwenden oder weitere Änderungen daran vornehmen.

Wenn Sie Cloud Service Mesh mit dem Skript asmcli installieren, geschieht Folgendes: kann eine oder mehrere Overlay-Dateien mit der --option oder der --custom_overlay Optionen. Falls Sie an der Einstellung im Repository anthos-service-mesh haben, können Sie --option verwenden. ruft das Skript die Datei von GitHub ab. Andernfalls können Sie Änderungen an der Overlay-Datei fest und verwenden Sie dann die Option --custom_overlay, übergeben Sie ihn an asmcli.

Wichtig: Geben Sie in der Overlay-Datei nicht mehr als eine IstioOperator-CR an, da istioctl install nur die erste CR anwendet, die in der Datei gefunden wird.

Fügen Sie nicht mehrere CRs in eine Overlay-Datei ein.	Separate Overlay-Dateien für jede CR erstellen

So aktivieren Sie optionale Features

Die folgenden Beispiele sind vereinfacht, damit nur die benutzerdefinierten Overlays zur Aktivierung optionaler Features angezeigt werden. Ersetzen Sie OTHER_FLAGS durch die erforderlichen Installationsflags.

Wichtig: Die Reihenfolge der Dateien in der Befehlszeile spielt eine wichtige Rolle. Geben Sie unbedingt erst die für die Standardfunktionen erforderliche Konfiguration und danach die Overlay-Dateien an.

Der Befehl asmcli install bietet zwei Möglichkeiten zum Aktivieren eines optionalen Features. Welche Methode Sie verwenden, hängt davon ab, ob Sie Änderungen an der Overlay-Datei vornehmen müssen.

• Verwenden Sie --option, wenn Sie keine Änderungen an der Overlay-Datei vornehmen müssen. Mit --option ruft asmcli die Datei aus dem GitHub-Repository für Sie ab. Dazu benötigen Sie eine Internetverbindung.

  ./asmcli install \
    OTHER_FLAGS \
    --option OPTION_NAME
  

  Ersetzen Sie OPTION_NAME durch die Option, die Sie aktivieren möchten. Lassen Sie die Erweiterung „.yaml“ weg und geben Sie nur den Namen des Overlays an. z. B. iap-operator und attached-cluster. Eine Liste der Optionen finden Sie im Paket anthos-service-mesh.

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

  ./asmcli install \
    OTHER_FLAGS \
    --custom_overlay PATH_TO_FILE
  

  Ersetzen Sie PATH_TO_FILE durch den Pfad zur Overlay-Datei, die Sie verwenden möchten.

YAML für optionale Features

Die folgenden Abschnitte enthalten die YAML-Datei, um optionale und unterstützte Funktionen zu aktivieren.

mTLS-STRICT-Modus

Die Konfiguration global.mtls.enabled wurde aus der IstioOperator-CR entfernt, um Probleme mit Upgrades zu vermeiden und eine flexiblere Installation zu ermöglichen. Konfigurieren Sie zum Aktivieren von STRICT mTLS stattdessen eine Peer-Authentifizierungsrichtlinie.

Proxy-Image löschen

Als Best Practice sollten Sie den Inhalt einer Containerlaufzeit auf die erforderlichen Pakete beschränken. Dieser Ansatz verbessert die Sicherheit und das Signal-Rausch-Verhältnis von CVE-Scannen (Common Vulnerabilities and Exposures). Istio stellt Proxy-Images bereit, die auf Distroless-Basis-Images basieren.

Die folgende Konfiguration aktiviert Distributions-Images für das gesamte Cloud Service Mesh. Bei einer Änderung des Image-Typs muss jeder Pod neu gestartet und neu eingefügt werden, um wirksam zu werden.

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    defaultConfig:
      image:
        imageType: distroless

Das Distroless-Image enthält keine anderen Binärdateien als den Proxy. Daher ist es nicht möglich, eine Shell mit exec zu versehen oder curl, ping oder andere Fehlerbehebungsfunktionen im Container zu verwenden.

Wenn Sie einen curl-Befehl ausführen, wird der folgende Fehler angezeigt:

error: Internal error occurred: error executing command in container: failed to exec in container: failed to start exec  "<container-id>"
OCI runtime exec failed: exec failed: unable to start container process: exec: "curl": executable file not found in $PATH: unknown

Wenn Sie einen Shell-Befehl ausführen, wird der folgende Fehler angezeigt:

error: Internal error occurred: error executing command in container: failed to exec in container: failed to start exec "<container-id>"
OCI runtime exec failed: exec failed: container_linux.go:380: starting container process caused: exec: "sh": executable file not found in $PATH: unknown

Wenn Sie für bestimmte Pods Zugriff auf diese Tools benötigen, können Sie imageType mit der folgenden Pod-Annotation überschreiben.

sidecar.istio.io/proxyImageType: debug

Nachdem Sie den Image-Typ einer Bereitstellung über die Annotation geändert haben, sollte die Bereitstellung neu gestartet werden.

kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

Für die meisten Arten von Proxy-Debugging sollte istioctl proxy-cmd verwendet werden, für das kein Debug-Basis-Image erforderlich ist.

Benutzerdefiniertes Overlay für eine benutzerdefinierte Registry verwenden

Sie können ein benutzerdefiniertes Overlay für benutzerdefinierte Registrys verwenden, z. B. wenn Sie Cloud Service Mesh aus einer benutzerdefinierten Container Registry installieren Beispiel:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  hub: {private_registry_url}

Im Folgenden finden Sie eine Liste von Images für Cloud Service Mesh, die Sie in die benutzerdefinierte Container Registry spiegeln müssen:

• Install-cni - gke.gcr.io/asm/install-cni:1.22.5-asm.1
• Verwaltete Datenebene - gke.gcr.io/asm/mdp:1.22.5-asm.1
• Pilot - gke.gcr.io/asm/pilot:1.22.5-asm.1
• Proxyv2 - gke.gcr.io/asm/proxyv2:1.22.5-asm.1

Hinweis: Wenn Sie einen Kanonischen Dienst verwenden, müssen Sie auch die benutzerdefinierten Containerregistries gcr.io/kubebuilder/kube-rbac-proxy:v0.13.1 und gke.gcr.io/asm/canonical-service-controller:1.10.3-asm.16 spiegeln.

Images zu einer privaten Registry hinzufügen

Führen Sie die folgenden Schritte aus, um Cloud Service Mesh-Images in eine private Registry zu übertragen.

Hinweis: Verwenden Sie einen Client, von dem Sie Daten aus gcr.io abrufen und in Ihre private Registry senden können.

1. Rufen Sie die Cloud Service Mesh-Images ab:

   docker pull gke.gcr.io/asm/install-cni:1.22.5-asm.1
   docker pull gke.gcr.io/asm/mdp:1.22.5-asm.1
   docker pull gke.gcr.io/asm/pilot:1.22.5-asm.1
   docker pull gke.gcr.io/asm/proxyv2:1.22.5-asm.1
   

2. Erstellen Sie eine Variable für Ihre private Registry-URL:

   export PRIVATE_REGISTRY_URL=PRIVATE_REGISTRY_URL
   

   Ersetzen Sie PRIVATE_REGISTRY_URL durch Ihre private Registry-URL.
3. Taggen Sie die Images mit Ihrer privaten Registry-URL:

   docker tag gke.gcr.io/asm/install-cni:1.22.5-asm.1 \
    ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/install-cni:1.22.5-asm.1
   docker tag gke.gcr.io/asm/mdp:1.22.5-asm.1 \
    ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/mdp:1.22.5-asm.1
   docker tag gke.gcr.io/asm/pilot:1.22.5-asm.1 \
    ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/pilot:1.22.5-asm.1
   docker tag gke.gcr.io/asm/proxyv2:1.22.5-asm.1 \
    ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/proxyv2:1.22.5-asm.1
   

4. Übertragen Sie die getaggten Images in Ihre private Registry:

   docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/install-cni:1.22.5-asm.1
   docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/mdp:1.22.5-asm.1
   docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/pilot:1.22.5-asm.1
   docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/proxyv2:1.22.5-asm.1
   

5. Optional: Wenn Sie einen kanonischen Dienst verwenden, fügen Sie die Images des kanonischen Dienstes Ihrer privaten Registry hinzu.
   1. Rufen Sie die kanonischen Dienst-Images von Cloud Service Mesh ab:

              docker pull gcr.io/kubebuilder/kube-rbac-proxy:v0.13.1
              docker pull gke.gcr.io/asm/canonical-service-controller:1.10.3-asm.16
              

   2. Taggen Sie die Images mit Ihrer privaten Registry-URL:

              docker tag gcr.io/kubebuilder/kube-rbac-proxy:v0.13.1 \
              ${PRIVATE_REGISTRY_URL}/gcr.io/kubebuilder/kube-rbac-proxy:v0.13.1
              docker tag gke.gcr.io/asm/canonical-service-controller:1.10.3-asm.16 \
              ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/canonical-service-controller:1.10.3-asm.16
              

   3. Übertragen Sie die getaggten Images in Ihre private Registry:

              docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/kube-rbac-proxy:v0.13.1
              docker push ${PRIVATE_REGISTRY_URL}/gke.gcr.io/asm/canonical-service-controller:1.10.3-asm.16
              

Wenn Sie die getaggten Images aus Ihrer privaten Registry abrufen können, war der Vorgang erfolgreich.

Dauer der Beendigungs-Entladung erhöhen

Standardmäßig wartet Envoy fünf Sekunden (5s) auf den Abschluss bestehender Verbindungen, wenn ein Pod beendet wird.

Der Pod terminationGracePeriodSeconds muss größer als der Wert terminationDrainDuration sein.

Weitere Informationen finden Sie unter Globale Mesh-Optionen.

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    defaultConfig:
      terminationDrainDuration: 30s

Zugriffslogs aktivieren

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    accessLogFile: "/dev/stdout"

Weitere Informationen finden Sie unter Zugriffs-Logging von Envoy aktivieren.

Cloud Trace

Cloud Trace ist für Cloud Service Mesh-Installationen auf den folgenden Plattformen verfügbar: Plattformen:

• GKE in Google Cloud
• GKE Enterprise-Cluster lokal, wenn Sie mit Cloud Service Mesh-Zertifizierungsstelle

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    enableTracing: true
  values:
    global:
      proxy:
        tracer: stackdriver

Weitere Informationen finden Sie unter Auf Traces zugreifen.

Ausgehender Traffic über Egress-Gateways

Wir empfehlen, ein injiziertes Gateway zu installieren, wie unter Gateways installieren und aktualisieren beschrieben.

Container-Netzwerkschnittstelle von Istio

Wie Sie das Container Network Interface (CNI) von Istio aktivieren, hängt davon ab, der Umgebung, in der Cloud Service Mesh installiert ist.

1. Netzwerkrichtlinien aktivieren

2. Wählen Sie die Overlay-Datei aus, die Ihrer Plattform entspricht.

CNI in GKE aktivieren

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    cni:
      enabled: true
      namespace: kube-system
  values:
    cni:
      cniBinDir: /home/kubernetes/bin
      excludeNamespaces:
        - istio-system
        - kube-system

CNI lokal aktivieren

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  components:
    cni:
      enabled: true
      namespace: kube-system
  values:
    cni:
      cniBinDir: /opt/cni/bin
      excludeNamespaces:
        - istio-system
        - kube-system
        - gke-system

Traffic-Logs außerhalb von Google Cloud aktivieren

Die Installation von Cloud Service Mesh mit Istio-Zertifizierungsstelle außerhalb von Google Cloud meldet Messwerte standardmäßig an Prometheus. Verwenden Sie diese Option, um die Berichterstellung für Zugriffe zu aktivieren oder sowohl in Prometheus als auch in Stackdriver. Cloud Service Mesh-Dashboards.

Nur Stackdriver

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  values:
    telemetry:
      enabled: true
      v2:
        enabled: true
        prometheus:
          enabled: false
        stackdriver:
          enabled: true

Stackdriver und Prometheus

---
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  values:
    telemetry:
      enabled: true
      v2:
        enabled: true
        prometheus:
          enabled: true
        stackdriver:
          enabled: true

Internen Load-Balancer aktivieren

Wir empfehlen, ein injiziertes Gateway zu installieren, wie unter Gateways installieren und aktualisierenbeschrieben, um einen internen Load-Balancer in GKE einzurichten. Beim Konfigurieren des Gateway-Dienstes geben Sie die Annotation networking.gke.io/load-balancer-type: "Internal" an.

Externe Zertifikatsverwaltung auf dem Ingress-Gateway

Informationen zum Aktivieren der externen Zertifikatsverwaltung auf dem Ingress-Gateway mit Envoy SDS finden Sie unter Sichere Gateways.