Feature-Statusbedingungen
Hinweis: Kanonische Dienste werden in der Cloud Service Mesh-Version 1.6.8 und höher automatisch unterstützt.
Auf dieser Seite wird beschrieben, wie Sie Bedingungen interpretieren und darauf reagieren, die für Ihren Cloud Service Mesh-Cluster oder Ihre Cloud Service Mesh-Flotte gemeldet werden.
Führen Sie diesen Befehl aus, um nach Bedingungen zu suchen:
gcloud container fleet mesh describe --project FLEET_PROJECT
Die Ausgabe kann conditions in membershipStates für einen Cluster enthalten, z. B.:
...
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: <CONDITION_CODE>
details: ...
documentationLink: ....
severity: ...
Die Werte von code werden auf dieser Seite ausführlicher beschrieben.
NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED
Möglicherweise wird der Fehlercode NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED im Feld Conditions Ihrer Mitgliedschaft angezeigt:
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED
details: One or more node pools have workload identity federation disabled.
documentationLink: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
severity: ERROR
controlPlaneManagement:
details:
- code: REVISION_FAILED_PRECONDITION
details: Required in-cluster components are not ready. This will be retried
within 15 minutes.
implementation: TRAFFIC_DIRECTOR
state: FAILED_PRECONDITION
Dieser Fehler wird angezeigt, wenn die Workload Identity-Föderation nicht für alle Knotenpools des GKE-Cluster aktiviert ist, da dies eine Voraussetzung für die Installation von Cloud Service Mesh ist.
Um diese Fehlermeldung zu beheben, müssen Sie der Anleitung unter Workload Identity-Föderation aktivieren für alle Knotenpools folgen. Beachten Sie, dass die Aktivierung je nach Cluster-Anwendungsfall variieren kann.
Nach der Aktivierung sollte die Fehlermeldung automatisch entfernt werden und der Cluster sollte wieder den Status ACTIVE haben. Wenn das Problem weiterhin besteht und Sie zusätzliche Unterstützung benötigen, lesen Sie den Abschnitt Support erhalten.
MESH_IAM_PERMISSION_DENIED
Dieser Fehler weist darauf hin, dass der Cloud Service Mesh-Dienst-Agent im Flottenprojekt nicht die erforderlichen Berechtigungen für das Clusterprojekt hat. Dies kann passieren, wenn sich der Cluster in einem anderen Projekt als die Flotte befindet oder wenn die Berechtigungen widerrufen wurden.
Gehen Sie zur Fehlerbehebung so vor:
Google Cloud Console
Rufen Sie in der Google Cloud Console IAM und Verwaltung > IAM auf.
Wählen Sie Von Google bereitgestellte Rollenzuweisungen einschließen aus.
Prüfen Sie die Hauptkontoliste.
Wird der Dienst-Agent mit der erforderlichen IAM-Rolle in der Liste angezeigt, so ist er korrekt konfiguriert.
Wenn die Liste den Dienst-Agent und die erforderliche Rolle nicht enthält, fahren Sie mit dem nächsten Schritt fort.
Weisen Sie dem Cloud Service Mesh-Dienst-Agent im Projekt die Rolle „Anthos Service Mesh-Dienst-Agent“ (
roles/anthosservicemesh.serviceAgent) zu. Eine Anleitung finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Google Cloud CLI
Führen Sie in der Google Cloud CLI folgenden Befehl aus, um zu prüfen, ob die erforderliche IAM-Rolle gewährt wurde:
gcloud projects get-iam-policy PROJECT_ID \ --flatten="bindings[].members" \ --filter="bindings.members:serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com AND bindings.role:roles/anthosservicemesh.serviceAgent" \ --format='table(bindings.role)'Sehen Sie sich die
ROLE-Liste an.Wenn in der Liste Rollen angezeigt werden, ist es korrekt konfiguriert.
Werden in der Liste keine Rollen angezeigt, wurde die erforderliche Rolle widerrufen.
Führen Sie den folgenden Befehl aus, um dem Dienst-Agent die erforderliche Rolle zuzuweisen:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role="roles/anthosservicemesh.serviceAgent"
Wenn die Berechtigung bestätigt wurde, das Problem aber weiterhin besteht, wende dich an den Google-Kundensupport.
MESH_IAM_CROSS_PROJECT_PERMISSION_DENIED
Dieser Fehler weist darauf hin, dass das Dienstkonto des Flottenprojekts nicht über ausreichende Berechtigungen für den Zugriff auf ein anderes Projekt (das Clusterprojekt oder das Netzwerkprojekt) verfügt.
Wenn Sie eine gemeinsam genutzte VPC verwenden, müssen Sie allen Dienstkonten der Flottenprojekte die Rolle Anthos Service Mesh Service Agent im Projekt mit dem freigegebene VPC-Netzwerk zuweisen.
Achten Sie bei den Szenarien mit GKE-Flottenprojekt und Clusterprojekt darauf, dem Dienstkonto des Flottenprojekts die Rolle Anthos Service Mesh Service Agent im Clusterprojekt zuzuweisen.
Beispiel für einen Befehl zur Fehlerbehebung:
Prüfen Sie, ob das Dienstkonto Ihres Netzwerkprojekts oder Clusterprojekts dem Dienstkonto des Flottenprojekts die Rolle
Anthos Service Mesh Service Agentzugewiesen hat. Falls nicht, führen Sie Folgendes aus:gcloud projects add-iam-policy-binding NETWORK_OR_CLUSTER_PROJECT_ID \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgentPrüfen Sie außerdem, ob es eine Automatisierung gibt, die diese Bindung entfernen würde.
Wenn die Berechtigung bestätigt wurde, das Problem aber weiterhin besteht, wende dich an den Google-Kundensupport.
CONFIG_VALIDATION_ERROR
Dieser Fehler weist darauf hin, dass eine Mesh-bezogene Konfiguration, die auf eine oder mehrere Mitgliedschaften in der Flotte angewendet wurde, nicht erfolgreich angewendet werden kann. In den Fehlerdetails wird beschrieben, wie der Nutzer das Problem am besten beheben kann.
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: CONFIG_VALIDATION_ERROR
details: 'Unsupported ProxyConfig fields: [proxyconfig.statNameLength]'
severity: ERROR
controlPlaneManagement:
Fehler bei der Konfigurationsvalidierung für eine bestimmte Konfiguration erfordern eine Nutzeraktion. Fehler im Zusammenhang mit der Verwendung nicht unterstützter API-Felder lassen sich beispielsweise am besten beheben, indem die fehlerhafte Konfiguration aus der Mesh API entfernt wird.
Rufen Sie in der Cloud Console „Kubernetes Engine“ > „Secrets und ConfigMaps“ > „istio-asm-managed“ auf. Der Name der ConfigMap hängt davon ab, welche Release-Version Sie verwenden, z. B. „istio-asm-managed-stable“ oder „istio-asm-managed-rapid“. Wählen Sie dann den Tab „YAML“ aus.
Beispielsweise wird „meshConfig.configSources“ nicht mehr unterstützt:
apiVersion: v1
data:
mesh: |
enablePrometheusMerge: true
trustDomain: "foobar.svc.id.goog"
trustDomainAliases:
- cluster.local
configSources:
- address: k8s://
- address: fs:///var/lib/istio/config/data