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

Cette section répertorie les erreurs courantes et décrit les solutions possibles pour l'installation et la configuration d'Apigee.

Le problème le plus courant que vous pouvez rencontrer est l'erreur HTTP suivante :

  • 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)"

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 dans l'Étape 4 : Configurer la mise en réseau des services.

    Pour demander une nouvelle plage à partir de laquelle Apigee choisit une adresse IP pour les connexions de services privés, procédez comme suit :

    1. Exécutez la commande gcloud suivante :
      gcloud compute addresses create google-svcs-2
        --project=$PROJECT_ID --global --prefix-length=16
        --description="additional peering range for Google services" --network=default
        --purpose=VPC_PEERING

      Cette commande crée une nouvelle requête de plage.

      Notez que vous devez spécifier le nom de la première plage (dans le cas présent, "google-svcs"), ainsi que le nom de la plage nouvellement demandée (dans le cas présent, "google-svcs-2").

    2. Exécutez la commande suivante pour mettre à jour votre requête de connexion :
      gcloud services vpc-peerings update
        --service=servicenetworking.googleapis.com --network=default
        --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

      Notez que la commande vpc-peerings update spécifie également les anciennes et les nouvelles plages d'adresses IP.

      Pour plus d'informations, consultez la section mise à jour d'appairages VPC des services gcloud.

Créer une organisation Apigee

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

Erreur lors de la création de l'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 2 : Activer les API Apigee 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 que vous avez activé toutes les API comme décrit dans l'Étape 2 : Activez les API Apigee.

Déployer des exemples

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 Cloud Console, 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 problème.
  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 :

      Redémarrage progressif de Compute Engine

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

      Cela redémarre l'instance Envoy.