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

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

    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 my-eg de virtualhost.
      3. Enregistrez le fichier overrides.yaml.
      4. Appliquez à nouveau le fichier overrides.yaml :
        apigeectl apply --settings virtualhosts

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 l'assistance Apigee :

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