Groupe d'environnements d'hôte virtuel manquant

Vous consultez la documentation d'Apigee et d'Apigee hybrid.
Il n'existe pas de documentation Apigee Edge équivalente pour ce sujet.

Symptôme

Un ApigeeIssue avec Reason AIS_VIRTUALHOST_MISSING_ENVGROUP s'affiche lorsque vous consultez les ressources de l'espace de noms apigee.

Messages d'erreur

L'erreur suivante s'affiche après l'exécution de kubectl -n apigee get apigeeissues : 

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

Cause : groupe d'environnements Virtualhost manquant

L'un des virtualhosts définis dans overrides.yaml n'a pas de EnvironmentGroup correspondant.

Diagnostic

Exécutez la commande suivante : 

kubectl -n apigee describe apigeeissue ISSUE_NAME

Où ISSUE_NAME est le nom du problème. Exemple : vhost-missing-eg-my-eg.

Un résultat semblable au suivant s'affiche : 

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"

Le contenu de Spec.Details explique le nom du EnvironmentGroup censé exister.

Solution

  1. Utilisez la commande describe ApigeeIssue pour afficher le nom du EnvironmentGroup censé exister : 
    kubectl -n apigee describe apigeeissues ISSUE_NAME

    Où ISSUE_NAME est le nom du problème. Exemple : vhost-missing-eg-my-eg.

    Dans cet exemple, le groupe d'environnement my-eg est censé exister dans l'organisation Apigee my-org.

  2. Utilisez l'une des méthodes suivantes pour corriger le problème :
    1. Créer le groupe d'environnements :
      1. Créez un groupe d'environnements.
      2. Ajoutez un environnement.
      3. Créez un proxy.
      4. Déployez un proxy dans cet environnement.
    2. Supprimer le groupe d'environnements :
      1. Ouvrez overrides.yaml dans un éditeur de texte.
      2. Supprimez le groupe d'environnements supprimé de virtualhosts.
      3. Enregistrez le fichier overrides.yaml.
      4. Réappliquez le fichier overrides.yaml à l'aide de la commande Helm:

        Effectuez un dry run :

        helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  --set envgroup=ENV_GROUP \
  -f overrides.yaml \
  --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 a peut-être été configurée à l'aide d'un ENV_GROUP_RELEASE_NAME différent de ENV_GROUP. Pour en savoir plus sur les paramètres, consultez la section 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.yaml

        Réessayez et vérifiez que le message d'erreur n'est plus renvoyé.

Vous devez collecter des informations de diagnostic

Si le problème persiste, même après avoir suivi les instructions ci-dessus, rassemblez les informations de diagnostic suivantes, puis contactez Google Cloud Customer Care :

  1. Google Cloud ID du projet.
  2. Nom de l'organisation Apigee Hybrid
  3. Champ Spec.Details de ApigeeIssue