Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de Apigee Edge.
Síntomas
Las implementaciones de proxies de API o flujos compartidos fallan con el error Instance INSTANCE_NAME
is not reporting status for environment group ENV_GROUP_NAME
en la IU de Apigee Hybrid.
Mensajes de error
El error The Instance INSTANCE_NAME is not reporting status for environment group
ENV_GROUP_NAME se muestra en el menú Proxies de API en la pestaña Descripción general cuando se coloca el cursor sobre el signo de exclamación rojo que aparece en la columna Estado de la sección Implementaciones:
Causas posibles
| Causa | Descripción |
|---|---|
Falta el selector app: apigee-ingressgateway |
Cuando se usa la entrada de Apigee, el archivo overrides.yaml debe tener el
selector app: apigee-ingressgateway en la sección virtualhosts. |
ApigeeRoute inactivo o entorno borrado solo en el plano de control |
Se quitó un entorno o una implementación del plano de control o del clúster sin
completar el flujo de trabajo de Full Delete, lo que dejó recursos de ApigeeRoute o
entorno inactivos en el clúster. |
| Salida de red bloqueada a las APIs de Google | Los nodos trabajadores del clúster no pueden establecer conexiones salientes con las APIs de autenticación de Google y
del plano de control de Apigee en *.googleapis.com:443. |
| La puerta de enlace de entrada o los Pods del entorno de ejecución no están listos | Los Pods de apigee-ingressgateway no se ejecutan con todos los contenedores listos
(2/2) o los Pods de apigee-runtime no están listos (0/1)
debido a una verificación de READINESS:VersionLoadProbe con errores. |
Causa: falta el selector app: apigee-ingressgateway
Cuando usas la puerta de enlace de entrada de Apigee, el archivo overrides.yaml incluye una sección para la configuración de virtualhosts en la que se debe configurar el selector app: apigee-ingressgateway.
Diagnóstico
Primero, confirma que usas la puerta de enlace de entrada de Apigee que está disponible con Hybrid versión 1.8 y posteriores (la siguiente configuración no funciona para ASM administrado por Istio). En tu archivo overrides.yaml, que incluye el grupo de entornos mencionado en el error, busca la sección virtualhosts y verifica si faltan los siguientes selectores:
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAMESolución
Edita el archivo overrides.yaml para que la sección virtualhosts[].selector sea similar al siguiente ejemplo:
virtualhosts:
- name: my-environment-group
sslCertPath: my-cert.crt
sslKeyPath: my-cert.key
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAME
Después de editar el archivo overrides.yaml, aplica la configuración nueva con
Helm:
Prueba de validación:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE \ --dry-run=server
Asegúrate de incluir todos los parámetros de configuración que se muestran, incluido --atomic,
para que la acción se revierta en caso de error.
Es posible que tu instalación se haya configurado o no con un ENV_GROUP_RELEASE_NAME que difiere de ENV_GROUP. Para obtener información sobre la configuración, consulta Instala Apigee Hybrid con Helm.
Instala el gráfico:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
Causa: ApigeeRoute inactivo o entorno borrado solo en el plano de control
Cuando se quita una implementación de entorno o de entorno de ejecución del plano de control o del clúster sin
completar el flujo de trabajo de eliminación completo, los recursos de ApigeeRoute o del entorno obsoletos pueden
permanecer en el clúster. Cuando apigee-watcher intenta conciliar el enrutamiento para el
grupo de entornos y encuentra un servicio, una implementación o un entorno del plano de control de Kubernetes
faltante, no puede completar la actualización de la ruta ni informar el estado de la implementación al plano de control.
Diagnóstico
-
Verifica los registros del Pod
apigee-watcherpara ver si faltan errores de servicio o de entorno:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
Busca entradas de registro similares a las siguientes:
-
Un
ApigeeRouteinactivo hace referencia a un servicio o una implementación de entorno de ejecución borrados:{"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"}
-
Se borró un entorno en el plano de control, mientras que sus recursos de entorno de ejecución permanecen en el clúster:
{"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}"}
-
-
Inspecciona los recursos
ApigeeRouteen tu espacio de nombres (apigeede forma predeterminada) para identificar cualquier ruta que apunte a unApigeeDeploymento servicio inexistente:kubectl get ApigeeRoute -n APIGEE_NAMESPACE kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
Solución
-
Borra el recurso
ApigeeRouteno válido:kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
-
Vuelve a crear la configuración de la ruta aplicando de nuevo el gráfico de Helm
apigee-virtualhost:helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ -n APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
-
Si un entorno se borró solo en el plano de control (lo que causa
err fetching environment data: NOT_FOUND), desinstala la versión de Helm del entorno (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) y quítalo del archivooverrides.yaml, como se describe en Borra entornos.
Causa: Se bloqueó la salida de red a las APIs de Google
El componente apigee-synchronizer sondea el plano de control de Apigee para descargar contratos de configuración del entorno de ejecución para los Pods de apigee-runtime, y apigee-watcher se conecta al plano de control para recuperar la configuración de entrada y, también, informar el estado de la implementación. Si
se bloquea el tráfico saliente de los nodos trabajadores del clúster a las APIs de Google, estos componentes no podrán
autenticarse ni comunicarse con el plano de control.
Diagnóstico
-
Verifica los registros del Pod de
apigee-synchronizerpara ver si hay errores de autenticación y de tiempo de espera de la conexión:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
Busca errores de tiempo de espera de
GoogleAuthExceptioncuando recuperes un token de acceso:"logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
-
Verifica los registros del Pod
apigee-watcherpara ver si hay fallas de conectividad del plano de control:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
Busca errores
control-plane connectivity test failedcon un tiempo de espera de TCP para el puerto443:{"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"}
Solución
Verifica que las reglas de firewall de salida, las puertas de enlace de NAT, las ACL de red y las configuraciones de proxy de reenvío HTTP o HTTPS permitan que los nodos trabajadores del clúster lleguen a *.googleapis.com:443 (incluidos apigee.googleapis.com y oauth2.googleapis.com). Para obtener la lista completa de los dominios requeridos y los pasos para solucionar problemas de conectividad, consulta URLs de Google Cloud que se deben permitir para Hybrid y No hay conectividad de red entre el plano del entorno de ejecución y el plano de control.
Causa: La puerta de enlace de entrada o los Pods del entorno de ejecución no están listos
Para verificar y, luego, informar el estado de la implementación, apigee-watcher recupera los volcados de configuración de enrutamiento de los Pods de apigee-ingressgateway y verifica la preparación de los Pods de apigee-runtime. Si los Pods de la puerta de enlace de entrada no se están ejecutando ni están listos, o si
los Pods del entorno de ejecución no cargaron el contrato del entorno, los informes de estado de la implementación fallarán.
Diagnóstico
-
Verifica el estado de los Pods de
apigee-ingressgateway:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
Verifica que todos los Pods de
apigee-ingressgatewayestén en el estadoRunningcon los contenedores de2/2listos. Si los Pods de la puerta de enlace de entrada no se están ejecutando2/2,apigee-watcherno puede recuperar el volcado de configuración de Envoy necesario para verificar la implementación. -
Verifica el estado de los Pods de
apigee-runtime:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
Si los Pods de
apigee-runtimeestán en estadoRunning, pero no están listos (0/1), inspecciona los eventos y registros de los Pods:kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
Busca fallas en el sondeo de preparación (
Readiness probe failed: HTTP probe failed with statuscode: 500) y erroresREADINESS:VersionLoadProbeque indiquen que el contrato del entorno de ejecución no está cargado:{"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"}
Solución
Resuelve cualquier falla de inicio de Pods, restricciones de recursos del clúster (límites de CPU o memoria) o
problemas de descarga de contratos del sincronizador para que los Pods de apigee-ingressgateway alcancen
2/2 listos y los Pods de apigee-runtime alcancen 1/1 listos antes de
volver a implementar. Para conocer pasos adicionales que te permitan solucionar problemas de fallas de preparación de apigee-runtime,
consulta la Guía de solución de problemas del procesador de
mensajes.
Referencias
- Asigna hosts virtuales a implementaciones de puerta de enlace de entrada de Apigee
- Borra entornos
- URLs de Google Cloud para habilitar la nube híbrida
- Guía de solución de problemas del procesador de mensajes