Résoudre les problèmes de configuration

Cette section explique les problèmes courants liés à Cloud Service Mesh et indique comment les résoudre. Si vous avez besoin d'une aide supplémentaire, consultez la page Assistance.

Vérifier MembershipState

Vous pouvez vérifier l'état le plus récent du réseau maillé à tout moment en exécutant la commande suivante:

gcloud container fleet mesh describe

Le résultat est semblable à :

...
membershipSpecs:
  projects/project_id/locations/global/memberships/cluster:
    mesh:
      management: MANAGEMENT_AUTOMATIC
membershipStates:
  projects/project_id/locations/global/memberships/cluster:
    servicemesh:
      ...
      conditions:
        - code: CONFIG_VALIDATION_WARNING
          documentationLink: https://cloud.google.com/...
          details: Application of one or more configs has failed. Error details are shown on individual config resources. See documentation link for more detail.
          severity: WARNING
...

Codes d'erreur MembershipState

Si Cloud Service Mesh signale des conditions à MembershipState pour un cluster, cela peut signifier que les configurations de maillage (telles que les ressources personnalisées Istio) n'ont pas pu être appliquées. Les descriptions des codes d'erreur suivantes vous donnent plus d'informations sur la façon de les résoudre.

Code d'erreur	Cause	Résolution
CONFIG_APPLY_INTERNAL_ERROR	L'application d'une ou de plusieurs configurations a échoué en raison d'une erreur interne.	Contactez le service client.
QUOTA_EXCEEDED_*	L'application d'une ou de plusieurs configurations a échoué, car les ressources ont atteint une limite de quota.	Pour en savoir plus sur les quotas spécifiques et comment les augmenter, consultez la page Quotas.
CONFIG_VALIDATION_ERROR	L'application d'une ou de plusieurs configurations a échoué en raison d'une configuration non valide.	Des erreurs spécifiques sont écrites dans les configurations qui les ont causées. Pour en savoir plus sur la façon de les diagnostiquer, consultez la section Erreurs de validation de la configuration.
CONFIG_VALIDATION_WARNING	Nous avons détecté des problèmes potentiels dans une ou plusieurs configurations. Il est possible qu'ils n'aient pas été appliqués, et s'ils l'ont été, un comportement inattendu peut se produire.	Pour en savoir plus sur la façon de les diagnostiquer, consultez la section Erreurs de validation de la configuration.
MULTICLUSTER_SECRET_WARNING	Le cluster utilise un secret multicluster Istio créé manuellement au lieu d'utiliser l'API multicluster déclarative pour la découverte des points de terminaison.	Déplacer la configuration de la découverte des points de terminaison multicluster vers l'implémentation déclarative. Pour en savoir plus, consultez la page Secrets multiclusters.
WORKLOAD_IDENTITY_REQUIRED	Workload Identity n'est pas activé pour le cluster ou au moins l'un des pools de nœuds.	Activez Workload Identity au niveau du cluster et du pool de nœuds. Pour savoir comment procéder, consultez la page Activer Workload Identity.
MANAGED_CNI_NOT_ENABLED	Le CNI géré n'est pas activé pour ce cluster.	Activez le CNI géré pour respecter les bonnes pratiques dans votre réseau maillé. Pour en savoir plus, consultez la page Activer le CNI géré.
NON_STANDARD_SIDECAR_BINARY_USAGE	Une ou plusieurs commandes dans les conteneurs Istio utilisent des binaires autres que "envoy", "pilot_agent" ou "iptables".	Supprimez la dépendance vis-à-vis des binaires non compatibles. Pour en savoir plus, consultez la page Utilisation de binaires non compatibles.
UNSUPPORTED_GATEWAY_CLASS_USAGE	Le cluster est configuré avec des classes de passerelle (Istio et Anthos Service Mesh) qui nécessitent une migration vers la passerelle d'entrée Istio pour respecter les bonnes pratiques.	Pour obtenir des instructions détaillées, consultez la documentation.

Erreurs de validation de la configuration

Les codes CONFIG_VALIDATION_WARNING et CONFIG_VALIDATION_ERROR indiquent que des problèmes ont été détectés dans les configurations de maillage (ressources personnalisées Istio ou Kubernetes) et qu'un sous-ensemble de configurations n'a peut-être pas été correctement appliqué.

De nombreux détails d'erreur par ressource sont écrits dans la ressource applicable. La commande suivante permet de localiser les configurations non valides et d'afficher les messages d'erreur spécifiques. (Remarque: il s'agit spécifiquement de ressources Istio, et toutes les erreurs de validation ne sont pas susceptibles d'être affichées ici.)

for resource in serviceentries destinationrules virtualservices gateways peerauthentications authorizationpolicies requestauthentications sidecars telemetries envoyfilters;
  do kubectl get $resource --all-namespaces --output=json | \
   jq  '.items[] | select(.status.conditions != null and any(.status.conditions[]; .type == "Accepted" and .status == "False")) | {"name": .metadata.name, "namespace": .metadata.namespace, "kind": .kind, "conditions": .status.conditions}';
done

Le résultat est semblable à :

{
  "name": "demo-envoy-filter",
  "namespace": "default",
  "kind": "EnvoyFilter",
  "conditions": [
    {
      "lastTransitionTime": "2024-04-04T21:10:18.046975988Z",
      "message": "This API is not supported",
      "reason": "Invalid",
      "status": "False",
      "type": "Accepted"
    }
  ]
}