Falta el grupo de entornos del host virtual

Estás consultando la documentación de Apigee y Apigee hybrid.
No hay documentación equivalente de Apigee Edge para este tema.

Síntoma

Se muestra un ApigeeIssue con Reason AIS_VIRTUALHOST_MISSING_ENVGROUP cuando se ven recursos en el espacio de nombres apigee.

Mensajes de error

Después de ejecutar kubectl -n apigee get apigeeissues, se muestra el siguiente error: 

NAME                     SEVERITY   REASON                             DOCUMENTATION                                                                                  AGE
vhost-missing-eg-my-eg   ERROR      AIS_VIRTUALHOST_MISSING_ENVGROUP   https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group   5h18m

Causa: falta el grupo del entorno del host virtual

Falta el EnvironmentGroup correspondiente a uno de los virtualhosts definidos en overrides.yaml.

Diagnóstico

Ejecuta el siguiente comando: 

kubectl -n apigee describe apigeeissue ISSUE_NAME

Donde ISSUE_NAME es el nombre del problema. Por ejemplo, vhost-missing-eg-my-eg.

Se devuelve algo similar a lo siguiente: 

Name:         vhost-missing-eg-my-eg
Namespace:    apigee
Labels:       ais-reason=AIS_VIRTUALHOST_MISSING_ENVGROUP
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2023-04-05T14:29:38Z
  Generation:          1
  Managed Fields:
    API Version:  apigee.cloud.google.com/v1alpha1
    Fields Type:  FieldsV1
    fieldsV1:
      f:spec:
        .:
        f:details:
        f:documentation:
        f:reason:
        f:severity:
    Manager:         apigeewatcher
    Operation:       Update
    Time:            2023-04-05T14:29:38Z
  Resource Version:  28195
  UID:               f7b62eb3-3f84-4a37-9ba8-9a0e1e9c3454
Spec:
  Details:        Expected EnvironmentGroup "my-eg" in ApigeeOrganization "my-org" for ApigeeRouteConfig "my-org-my-eg"
  Documentation:  https://cloud.google.com/apigee/docs/api-platform/troubleshoot/playbooks/vh-missing-env-group
  Reason:         AIS_VIRTUALHOST_MISSING_ENVGROUP
  Severity:       ERROR
Events:           <none>
 
Spec:
  Details:        Expected EnvironmentGroup "my-eg" in ApigeeOrganization "my-org" for ApigeeRouteConfig "my-org-my-eg"

El contenido de Spec.Details explica el nombre del EnvironmentGroup que se espera que exista.

Resolución

  1. Usa el comando describe ApigeeIssue para mostrar el nombre del EnvironmentGroup que se espera que exista: 
    kubectl -n apigee describe apigeeissues ISSUE_NAME

    Donde ISSUE_NAME es el nombre del problema. Por ejemplo, vhost-missing-eg-my-eg.

    En este ejemplo, se espera que el grupo de entornos my-eg esté en la organización de Apigee my-org.

  2. Utilice uno de los siguientes métodos para corregir el problema:
    1. Crea el grupo del entorno:
      1. Crea un grupo de entornos.
      2. Añade un entorno.
      3. Crea un proxy.
      4. Despliega un proxy en ese entorno.
    2. Elimina el grupo del entorno:
      1. Abre overrides.yaml en un editor de texto.
      2. Elimina el grupo de entornos quitado de virtualhosts.
      3. Guarda el archivo overrides.yaml.
      4. Vuelve a aplicar el archivo overrides.yaml con el comando Helm:

        Prueba de funcionamiento:

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

        Asegúrate de incluir todos los ajustes que se muestran, incluido --atomic para que la acción se revierta si falla.

        Es posible que tu instalación se haya configurado con un ENV_GROUP_RELEASE_NAME diferente de ENV_GROUP. Para obtener información sobre los ajustes, consulta Instalar 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.yaml

        Vuelve a intentarlo y comprueba que el mensaje de error ya no se devuelva.

Debe recoger información de diagnóstico

Si el problema persiste incluso después de seguir las instrucciones anteriores, recoge la siguiente información de diagnóstico y ponte en contacto con el equipo de Asistencia de Google Cloud:

  1. El Google Cloud ID del proyecto.
  2. Nombre de la organización de Apigee Hybrid.
  3. El campo Spec.Details de ApigeeIssue.