L'instance ne signale pas l'état du groupe d'environnements

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Symptômes

Les déploiements de proxys d'API ou de flux partagés échouent avec l'erreur Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME dans l'interface utilisateur d'Apigee hybrid.

Messages d'erreur

L'erreur The Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME s'affiche dans le menu Proxys d'API sous l'onglet Présentation lorsque vous passez la souris sur le point d'exclamation rouge dans la colonne État de la section Déploiements :

instance-not-reporting-status

Causes possibles :

Cause Description
Le sélecteur app: apigee-ingressgateway est manquant Lorsque vous utilisez l'entrée Apigee, le fichier overrides.yaml doit comporter le sélecteur app: apigee-ingressgateway sous la section virtualhosts.
ApigeeRoute obsolète ou environnement supprimé uniquement dans le plan de contrôle Un environnement ou un déploiement a été supprimé du plan de contrôle ou du cluster sans que le workflow de suppression complète ait été exécuté, ce qui a laissé des ressources ApigeeRoute ou d'environnement obsolètes dans le cluster.
Sortie réseau bloquée vers les API Google Les nœuds de calcul du cluster ne peuvent pas établir de connexions sortantes vers les API d'authentification Google et du plan de contrôle Apigee sur *.googleapis.com:443.
La passerelle d'entrée ou les pods d'exécution ne sont pas prêts Les pods apigee-ingressgateway ne sont pas en cours d'exécution avec tous les conteneurs prêts (2/2), ou les pods apigee-runtime ne sont pas prêts (0/1) en raison d'un échec de la vérification READINESS:VersionLoadProbe.

Cause : le sélecteur app: apigee-ingressgateway est manquant

Lorsque vous utilisez la passerelle d'entrée Apigee, le fichier overrides.yaml inclut une section pour la configuration virtualhosts dans laquelle le sélecteur app: apigee-ingressgateway doit être configuré.

Diagnostic

Tout d'abord, vérifiez que vous utilisez la passerelle d'entrée Apigee, disponible avec les versions 1.8 et ultérieures d'Apigee hybrid (la configuration suivante ne fonctionne pas pour le service ASM Istio géré par le client). Dans votre fichier overrides.yaml qui inclut le groupe d'environnements mentionné dans l'erreur, recherchez la section virtualhosts et vérifiez si les sélecteurs suivants sont manquants :

  selector:
    app: apigee-ingressgateway
    ingress_name: INGRESS_NAME

Solution

Modifiez le fichier overrides.yaml pour que la section virtualhosts[].selector ressemble à l'exemple suivant :

    virtualhosts:
    - name: my-environment-group
      sslCertPath: my-cert.crt
      sslKeyPath: my-cert.key
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
  

Après avoir modifié le fichier overrides.yaml, appliquez la nouvelle configuration à l'aide de Helm :

Effectuez un dry run :

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE \
--dry-run=server

Veillez à inclure tous les paramètres affichés, y compris --atomic, afin que l'action soit annulée en cas d'échec.

Votre installation peut avoir été configurée ou non à l'aide d'un ENV_GROUP_RELEASE_NAME différent de ENV_GROUP. Pour en savoir plus sur les paramètres, consultez Installer Apigee hybrid à l'aide de Helm.

Installez le chart :

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE

Cause : ApigeeRoute obsolète ou environnement supprimé uniquement dans le plan de contrôle

Lorsqu'un environnement ou un déploiement d'exécution est supprimé du plan de contrôle ou du cluster sans que le workflow de suppression complet soit terminé, des ressources ApigeeRoute ou d'environnement obsolètes peuvent rester dans le cluster. Lorsque apigee-watcher tente de rapprocher le routage pour le groupe d'environnements et rencontre un service, un déploiement ou un environnement de plan de contrôle Kubernetes manquant, il ne peut pas terminer la mise à jour de la route ni signaler l'état du déploiement au plan de contrôle.

Diagnostic

  1. Vérifiez les journaux du pod apigee-watcher pour détecter les erreurs de service ou d'environnement manquants :

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    Recherchez des entrées de journal semblables à celles-ci :

    • Un ApigeeRoute obsolète fait référence à un service ou à un déploiement d'exécution supprimé :

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingressstatus","error":"INTERNAL: NOT_FOUND: failed to get service: services \"apigee-runtime-ORG_ENV_HASH\" not found"}
    • Un environnement a été supprimé dans le plan de contrôle, mais ses ressources d'exécution sont toujours présentes dans le cluster :

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingress","error":"INVALID_ARGUMENT: err fetching environment data: NOT_FOUND: {\n  \"error\": {\n    \"code\": 404,\n    \"message\": \"generic::not_found: resource organizations/ORG_NAME/environments/ENV_NAME not found\",\n    \"status\": \"NOT_FOUND\"\n  }\n}"}
  2. Inspectez les ressources ApigeeRoute de votre espace de noms (apigee par défaut) pour identifier toute route pointant vers un service ou un ApigeeDeployment inexistant :

    kubectl get ApigeeRoute -n APIGEE_NAMESPACE
    kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    

Solution

  1. Supprimez la ressource ApigeeRoute non valide :

    kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    
  2. Recréez la configuration de la route en réappliquant le chart Helm apigee-virtualhost :

    helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
      -n APIGEE_NAMESPACE \
      --atomic \
      --set envgroup=ENV_GROUP \
      -f OVERRIDES_FILE
    
  3. Si un environnement a été supprimé uniquement dans le plan de contrôle (ce qui entraîne l'erreur err fetching environment data: NOT_FOUND), désinstallez la version Helm de l'environnement (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) et supprimez l'environnement de votre fichier overrides.yaml, comme décrit dans Supprimer des environnements.

Cause : Sortie réseau bloquée vers les API Google

Le composant apigee-synchronizer interroge le plan de contrôle Apigee pour télécharger les contrats de configuration d'exécution pour les pods apigee-runtime, et apigee-watcher se connecte au plan de contrôle pour récupérer la configuration d'entrée et signaler l'état du déploiement. Si le trafic sortant des nœuds de calcul du cluster vers les API Google est bloqué, ces composants ne peuvent pas s'authentifier ni communiquer avec le plan de contrôle.

Diagnostic

  1. Vérifiez les journaux du pod apigee-synchronizer pour détecter les erreurs d'authentification et de délai avant expiration de la connexion :

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
    

    Recherchez les erreurs de délai d'expiration GoogleAuthException lors de la récupération d'un jeton d'accès :

    "logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
  2. Vérifiez les journaux du pod apigee-watcher pour détecter les échecs de connectivité du plan de contrôle :

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    Recherchez les erreurs control-plane connectivity test failed avec un délai avant expiration TCP sur le port 443 :

    {"level":"error","caller":"issuescan/cp_connectivity_scanner.go:68","msg":"control-plane connectivity test failed","organization":"ORG_NAME","error":"Get \"https://apigee.googleapis.com/v1/organizations/ORG_NAME\": oauth2: cannot fetch token: Post \"https://oauth2.googleapis.com/token\": dial tcp IP_ADDRESS:443: i/o timeout"}

Solution

Vérifiez que vos règles de pare-feu sortantes, vos passerelles NAT, vos LCA réseau et vos configurations de proxy de transfert HTTP ou HTTPS permettent aux nœuds de calcul du cluster d'atteindre *.googleapis.com:443 (y compris apigee.googleapis.com et oauth2.googleapis.com). Pour obtenir la liste complète des domaines requis et des étapes de dépannage de la connectivité, consultez les pages URL Google Cloud à autoriser pour Hybrid et Aucune connectivité réseau entre le plan d'exécution et le plan de contrôle.

Cause : Les pods de passerelle d'Ingress ou d'exécution ne sont pas prêts

Pour vérifier et signaler l'état du déploiement, apigee-watcher récupère les vidages de configuration de routage à partir des pods apigee-ingressgateway et vérifie l'état de préparation des pods apigee-runtime. Si les pods de la passerelle d'entrée ne sont pas en cours d'exécution et prêts, ou si les pods d'exécution n'ont pas chargé le contrat d'environnement, le reporting de l'état du déploiement échoue.

Diagnostic

  1. Vérifiez l'état des pods apigee-ingressgateway :

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
    

    Vérifiez que tous les pods apigee-ingressgateway sont à l'état Running avec les conteneurs 2/2 prêts. Si les pods de la passerelle d'entrée n'exécutent pas 2/2, apigee-watcher ne peut pas récupérer le vidage de configuration Envoy nécessaire pour vérifier le déploiement.

  2. Vérifiez l'état des pods apigee-runtime :

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
    

    Si les pods apigee-runtime sont Running, mais pas prêts (0/1), inspectez les événements et les journaux des pods :

    kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    

    Recherchez les échecs de vérification d'aptitude (Readiness probe failed: HTTP probe failed with statuscode: 500) et les erreurs READINESS:VersionLoadProbe indiquant que le contrat d'exécution n'est pas chargé :

    {"level":"SEVERE","className":"com.apigee.probe.ProbeServiceImpl","severity":"SEVERE","message":"probe \"READINESS:VersionLoadProbe\" execution failed due to Version not loaded by Message Processor","logger":"ProbeServiceImpl"}

Solution

Résolvez les échecs de démarrage des pods, les contraintes de ressources du cluster (limites de processeur ou de mémoire) ou les problèmes de téléchargement du contrat du synchronisateur afin que les pods apigee-ingressgateway atteignent l'état prêt 2/2 et que les pods apigee-runtime atteignent l'état prêt 1/1 avant de redéployer. Pour connaître les étapes supplémentaires permettant de résoudre les échecs d'aptitude apigee-runtime, consultez le guide de dépannage du processeur de messages.

Références