Comprendre les conditions d'état des fonctionnalités
Remarque : Les services canoniques sont automatiquement acceptés dans les versions 1.6.8 et ultérieures de Cloud Service Mesh.
Cette page explique comment interpréter les conditions signalées sur votre cluster ou parc Cloud Service Mesh, et comment agir en conséquence.
Pour vérifier les conditions, exécutez la commande suivante :
gcloud container fleet mesh describe --project FLEET_PROJECT
Le résultat peut inclure conditions dans membershipStates pour un cluster, par exemple :
...
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: <CONDITION_CODE>
details: ...
documentationLink: ....
severity: ...
Les valeurs de code sont décrites plus en détail sur cette page.
NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED
Le code d'erreur NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED peut s'afficher dans le champ Conditions de votre abonnement :
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
Cette erreur s'affiche si la fédération d'identité de charge de travail n'est pas activée sur tous les pools de nœuds du cluster GKE, car il s'agit d'un prérequis pour l'installation de Cloud Service Mesh.
Pour résoudre ce message d'erreur, vous devez suivre les instructions permettant d'activer la fédération d'identité de charge de travail sur tous les pools de nœuds. Notez que l'activation peut varier en fonction de votre cas de cluster spécifique.
Une fois l'activation effectuée, le message d'erreur devrait être automatiquement supprimé et votre cluster devrait revenir à l'état ACTIVE. Si le problème persiste et que vous avez besoin d'une aide supplémentaire, consultez la page Assistance.
MESH_IAM_PERMISSION_DENIED
Cette erreur indique que l'agent de service Cloud Service Mesh du projet de parc ne dispose pas des autorisations requises sur le projet de cluster. Cela peut se produire si le cluster se trouve dans un projet différent de celui du parc ou si les autorisations ont été révoquées.
Pour résoudre le problème, suivez l'une des méthodes suivantes :
Console Google Cloud
Dans la console Google Cloud , accédez à IAM et administration > IAM.
Sélectionnez Inclure les attributions de rôles fournies par Google.
Examinez la liste Compte principal.
Si l'agent de service s'affiche avec le rôle IAM requis dans la liste, il est correctement configuré.
Si la liste n'inclut pas l'agent de service et le rôle requis, passez à l'étape suivante.
Attribuez le rôle d'agent de service Anthos Service Mesh (
roles/anthosservicemesh.serviceAgent) à l'agent de service Cloud Service Mesh sur le projet. Pour obtenir des instructions, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Google Cloud CLI
Dans la Google Cloud CLI, exécutez la commande suivante pour vérifier si le rôle IAM requis a été attribué :
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)'Examinez la liste
ROLE.Si des rôles apparaissent dans la liste, cela signifie qu'ils sont correctement configurés.
Si vous ne voyez aucun rôle dans la liste, cela signifie que le rôle requis a été révoqué.
Pour attribuer le rôle requis à l'agent de service, exécutez la commande suivante :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role="roles/anthosservicemesh.serviceAgent"
Si l'autorisation est validée, mais que le problème persiste, contactez le service client Google pour obtenir de l'aide.
MESH_IAM_CROSS_PROJECT_PERMISSION_DENIED
Cette erreur indique que le compte de service du projet de parc ne dispose pas des autorisations suffisantes pour accéder à un autre projet (le projet de cluster ou le projet de réseau).
Pour le VPC partagé, veillez à attribuer le rôle Anthos Service Mesh Service Agent au compte de service de tous les projets de parc dans le projet de réseau VPC partagé.
Pour les scénarios de projet de parc GKE et de projet de cluster, veillez à attribuer au compte de service du projet de parc le rôle Anthos Service Mesh Service Agent dans le projet de cluster.
Exemple de commande de dépannage :
Vérifiez si le compte de service de votre projet de réseau ou de votre projet de cluster a attribué le rôle
Anthos Service Mesh Service Agentau compte de service du projet de parc. Si ce n'est pas le cas, exécutez la commande suivante :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.serviceAgentVérifiez également que vous ne disposez pas d'une automatisation qui supprimerait cette liaison.
Si l'autorisation est validée, mais que le problème persiste, contactez le service client Google pour obtenir de l'aide.
CONFIG_VALIDATION_ERROR
Cette erreur indique que certaines configurations liées au maillage appliquées à un ou plusieurs membres du parc ne peuvent pas être appliquées. Les détails de l'erreur décrivent la meilleure façon de résoudre ce problème.
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:
Les erreurs de validation de la configuration pour une configuration spécifique nécessitent une action de l'utilisateur. Par exemple, pour résoudre les erreurs liées à l'utilisation de champs d'API non compatibles, il est préférable de supprimer la configuration incriminée de l'API Mesh.
Dans la console Cloud, accédez à Kubernetes Engine > Secrets et ConfigMaps > istio-asm-managed (le nom de la ConfigMap dépend du version disponible que vous utilisez, par exemple istio-asm-managed-stable ou istio-asm-managed-rapid), puis sélectionnez l'onglet "YAML".
Par exemple, meshConfig.configSources n'est plus compatible :
apiVersion: v1
data:
mesh: |
enablePrometheusMerge: true
trustDomain: "foobar.svc.id.goog"
trustDomainAliases:
- cluster.local
configSources:
- address: k8s://
- address: fs:///var/lib/istio/config/data