La instancia no informa el estado del grupo de entornos

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:

instance-not-reporting-status

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_NAME

Solució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

  1. Verifica los registros del Pod apigee-watcher para 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 ApigeeRoute inactivo 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}"}
  2. Inspecciona los recursos ApigeeRoute en tu espacio de nombres (apigee de forma predeterminada) para identificar cualquier ruta que apunte a un ApigeeDeployment o servicio inexistente:

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

Solución

  1. Borra el recurso ApigeeRoute no válido:

    kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    
  2. 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
    
  3. 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 archivo overrides.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

  1. Verifica los registros del Pod de apigee-synchronizer para 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 GoogleAuthException cuando 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"
  2. Verifica los registros del Pod apigee-watcher para 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 failed con un tiempo de espera de TCP para el puerto 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"}

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

  1. 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-ingressgateway estén en el estado Running con los contenedores de 2/2 listos. Si los Pods de la puerta de enlace de entrada no se están ejecutando 2/2, apigee-watcher no puede recuperar el volcado de configuración de Envoy necesario para verificar la implementación.

  2. Verifica el estado de los Pods de apigee-runtime:

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

    Si los Pods de apigee-runtime están en estado Running, 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 errores READINESS:VersionLoadProbe que 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