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 :
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_NAMESolution
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
-
Vérifiez les journaux du pod
apigee-watcherpour 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
ApigeeRouteobsolè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}"}
-
-
Inspectez les ressources
ApigeeRoutede votre espace de noms (apigeepar défaut) pour identifier toute route pointant vers un service ou unApigeeDeploymentinexistant :kubectl get ApigeeRoute -n APIGEE_NAMESPACE kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
Solution
-
Supprimez la ressource
ApigeeRoutenon valide :kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
-
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
-
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 fichieroverrides.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
-
Vérifiez les journaux du pod
apigee-synchronizerpour 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
GoogleAuthExceptionlors 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"
-
Vérifiez les journaux du pod
apigee-watcherpour 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 failedavec un délai avant expiration TCP sur le port443:{"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
-
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-ingressgatewaysont à l'étatRunningavec les conteneurs2/2prêts. Si les pods de la passerelle d'entrée n'exécutent pas2/2,apigee-watcherne peut pas récupérer le vidage de configuration Envoy nécessaire pour vérifier le déploiement. -
Vérifiez l'état des pods
apigee-runtime:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
Si les pods
apigee-runtimesontRunning, 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 erreursREADINESS:VersionLoadProbeindiquant 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
- Mapper des hôtes virtuels aux déploiements d'une passerelle d'entrée Apigee
- Supprimer des environnements
- URL Google Cloud à autoriser pour les environnements hybrides
- Guide de dépannage du processeur de messages