Résoudre les problèmes liés à l'installation d'Apigee

Cette page s'applique à Apigee, mais pas à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Ce document liste les erreurs courantes et décrit les solutions possibles pour l'installation et la configuration d'Apigee.

Créer une instance

Cette section décrit les erreurs courantes et les solutions possibles après l'envoi d'une requête à Apigee pour créer une instance :

• 401 (UNAUTHENTICATED) indique que vos identifiants ont peut-être expiré. Essayez de renouveler votre jeton d'autorisation, comme illustré dans l'exemple suivant :

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• RANGES_EXHAUSTED indique que la plage d'adresses IP que vous avez demandée à l'origine n'a pas pu être traitée et que vous devez demander une nouvelle plage. Vous avez initialement créé une requête de plage à l'étape 2: Configurer la mise en réseau.
  1. Créez les variables d'environnement suivantes :

  RANGE_NAME_1=YOUR_RANGE_NAME_1
    RANGE_NAME_2=YOUR_RANGE_NAME_2
    NETWORK_NAME=YOUR_NETWORK_NAME

  2. Vérifiez les détails des plages d'adresses existantes et assurez-vous qu'elles ne se chevauchent pas avec la nouvelle plage.

   gcloud compute addresses list --global --project=$PROJECT_ID

   gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 

  3. Pour demander une nouvelle plage à partir de laquelle Apigee choisit une adresse IP pour les connexions de services privés, exécutez la commande gcloud suivante :

   gcloud compute addresses create $RANGE_NAME_2
              --project=$PROJECT_ID --global --prefix-length=16
              --description="additional peering range for Google services" --network=$NETWORK_NAME
              --purpose=VPC_PEERING 

  Cette commande crée une plage nommée $RANGE_NAME_2.

  4. Vérifiez les détails de l'ancienne et de la nouvelle plage d'adresses.

   gcloud compute addresses list --global --project=$PROJECT_ID 

   gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 

   gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID 

  5. Vérifiez les détails de l'appairage de VPC existant :

   gcloud services vpc-peerings list \
              --network=$NETWORK_NAME \
              --service=servicenetworking.googleapis.com \
              --project=$PROJECT_ID 

  6. Exécutez la commande suivante pour mettre à jour votre requête de connexion :

   gcloud services vpc-peerings update
              --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
              --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID 

  Remarque : Vous devez spécifier le nom de la première plage (dans ce cas, RANGE_NAME_1) et le nom de la nouvelle plage demandée (dans ce cas, RANGE_NAME_2). Pour en savoir plus, consultez la page gcloud services vpc-peerings update.
  7. Vérifiez les détails de l'appairage de VPC existant :

   gcloud services vpc-peerings list \
              --network=$NETWORK_NAME \
              --service=servicenetworking.googleapis.com \
              --project=$PROJECT_ID 

Créer une organisation Apigee

L'exemple suivant montre une erreur courante qu'Apigee peut afficher lorsque vous essayez de créer une organisation :

Cela signifie qu'une ou plusieurs des API requises ne sont pas activées. Passez en revue les API répertoriées à l'Étape 1 : Activer les API requises et assurez-vous que toutes les API sont activées avant de continuer.

De plus, vous pouvez obtenir l'une des erreurs HTTP suivantes :

• 401 (UNAUTHENTICATED) indique que vos identifiants ont peut-être expiré. Essayez de renouveler votre jeton d'autorisation, comme illustré dans l'exemple suivant :

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• 404 (Not Found) peut résulter de :
  • Vous avez saisi une URL de point de terminaison ou de requête incorrecte. Vérifiez que vous avez spécifié apigee.googleapis.com pour le domaine de l'appel d'API.
  • Votre projet n'a peut-être pas encore été provisionné. Contactez le service commercial d'Apigee.
• 409 (Conflict) indique généralement que le nom d'organisation donné existe déjà. Les noms d'organisations doivent être uniques. Choisissez un autre nom pour l'organisation et relancez la commande. (Vous devez spécifier le nom dans la charge utile de la requête si vous créez une organisation sur la ligne de commande. Gardez à l'esprit que vous devez créer une organisation portant le même nom que votre projet. Cette erreur ne devrait donc pas se produire tant qu'il n'y a pas de faute de frappe.)

Voici une erreur possible qu'Apigee peut renvoyer lorsque vous vérifiez l'état d'une nouvelle requête d'organisation :

• 403 (Permission Denied) pourrait indiquer que l'organisation n'a pas encore été créée. Veuillez patienter une minute et réessayez. Si Apigee renvoie un résultat 403 lorsque vous essayez de créer la nouvelle organisation, cela peut signifier qu'une ou plusieurs de vos API n'ont pas été activées. Assurez-vous d'avoir activé toutes les API comme décrit à l'étape 1: Activez les API requises.

Déployer des exemples

Équilibreur de charge non opérationnel

Lors du déploiement d'un exemple de proxy, Apigee peut renvoyer une erreur HTTP 502 (Bad Gateway). Dans ce cas, essayez les solutions suivantes :

1. Ouvrez Cloud Console.
2. Vérifiez l'état de l'équilibreur de charge. Dans la console Cloud, sélectionnez Services réseau > Équilibrage de charge. L'onglet Équilibreur de charge affiche tous les équilibreurs de charge du projet et leur état. Un triangle jaune indique que le service de backend de l'équilibreur de charge n'est pas opérationnel.
3. Après avoir confirmé un problème avec l'équilibreur de charge, vérifiez les VM dans votre instance d'exécution pour vous assurer qu'elles sont opérationnelles.
4. Examinez les fichiers journaux pour voir si vous trouvez une erreur ou un autre type de problème qui pourrait avoir entraîné un dysfonctionnement. Pour en savoir plus sur l'activation et l'affichage des journaux, consultez la page Afficher les journaux.
5. Essayez d'effectuer un redémarrage progressif sur le groupe d'instances dans Cloud Console :
   1. Sélectionnez Compute Engine > Groupes d'instances.
   2. Dans la liste des groupes d'instances, cliquez sur celui qui ne répond pas dans la colonne Nom.
   3. Cliquez sur Redémarrer/Remplacer progressivement, comme illustré dans l'exemple suivant :

      

   4. Sur l'écran suivant, cliquez sur Redémarrer.

      Cela redémarre l'instance Envoy.

Adresse IP d'instance incorrecte

Si vous supprimez et recréez votre instance Apigee à un quelconque moment, l'adresse IP de l'instance Apigee change et peut ne plus être synchronisée avec l'adresse IP du point de terminaison du modèle de groupe d'instances géré (MIG). Par exemple, le modèle de MIG contiendra toujours l'ancienne adresse IP de l'instance supprimée. Le modèle de MIG a été créé pendant le processus de provisionnement d'Apigee. Dans cette situation, essayez d'appliquer la procédure suivante pour mettre à jour le modèle de MIG avec l'adresse IP Apigee correcte :

1. Ouvrez l'interface utilisateur Apigee.

   Accéder à l'interface utilisateur Apigee

2. Accédez à Admin > Instances (Administration > Instances).
3. Notez l'adresse IP de l'instance. Vous en aurez besoin lors d'une prochaine étape. Exemple : 10.117.200.2.

4. Dans Google Cloud Console, accédez à la page Modèles d'instances.

   Accéder à la page "Modèles d'instances"

5. Ouvrez le modèle d'instance. Vous devez ouvrir le modèle d'instance utilisé par le backend mappé à votre équilibreur de charge.
6. Faites défiler la page vers le bas pour trouver l'adresse IP ENDPOINT dans la section Custom Metadata (Métadonnées personnalisées).
7. Si l'adresse IP du point de terminaison diffère de celle que vous avez notée dans l'UI Apigee, vous devez modifier l'adresse IP du modèle d'instance pour qu'elle corresponde à l'adresse IP de l'instance Apigee. Consultez la section Modifier des adresses IP d'instance.