Étape 8 : Déployer et appeler un exemple de proxy

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d'Apigee Edge.

Procédure de cette étape

Suivez les étapes ci-dessous pour créer et déployer un proxy d'API de test. Enfin, testez le proxy d'API en lui envoyant une requête HTTP.

Créer et déployer un proxy d'API

Le processus de provisionnement pour Apigee ne crée et ne déploie pas automatiquement un proxy d'API pour vous. Vous devez créer et déployer un proxy manuellement.

Interface utilisateur d'Apigee dans la console Cloud

Pour créer et déployer votre premier proxy :

  1. Ouvrez l'interface utilisateur d'Apigee dans la console Cloud dans un navigateur.
  2. Assurez-vous que le nom de votre organisation est sélectionné dans le menu déroulant situé dans l'angle supérieur gauche de l'interface utilisateur. Le nom de l'organisation est identique à celui de votre projet Google Cloud.
  3. Dans le volet de navigation de gauche, cliquez sur Développement du proxy > Proxys d'API.
  4. Cliquez sur + Créer.

    La page Créer un proxy s'ouvre.

  5. Dans la zone Modèle de proxy, sélectionnez Proxy inverse (le plus courant).
  6. À l'étape 1 : Détails du proxy, configurez votre proxy avec les valeurs suivantes :
    Nom du paramètre Valeur
    Nom du proxy hello-world
    Chemin de base /hello-world
    Cible (API existante) mocktarget.apigee.net
  7. Cliquez sur Next (Suivant).
  8. À l'étape 2 : Stratégies, sous Sécurité : Autorisation, sélectionnez Accès libre (aucune autorisation).
  9. Cliquez sur Next (Suivant).
  10. À l'étape 3 : Déployer (facultatif), sélectionnez l'environnement dans lequel déployer le proxy, puis cliquez sur OK.
  11. Cliquez sur Créer.

    Votre proxy d'API est créé et déployé dans l'environnement sélectionné.

  12. La page Récapitulatif du proxy correspondant au proxy que vous venez de créer s'affiche. Une coche verte sous État indique que le proxy a bien été déployé. Si le proxy n'est pas déployé, consultez la section Déployer un proxy d'API et suivez les étapes pour le déployer manuellement.
  13. Dans le volet de navigation de gauche, sélectionnez Gestion > Environnements > Groupes d'environnements.
  14. Copiez le nom d'hôte de votre groupe d'environnements. Vous utiliserez ce nom d'hôte pour appeler le proxy d'API lors des étapes suivantes.

Interface utilisateur d'Apigee

Pour créer et déployer votre premier proxy :

  1. Connectez-vous à l'UI Apigee.
  2. Assurez-vous que le nom de votre organisation est sélectionné dans le menu déroulant situé dans l'angle supérieur gauche de l'interface utilisateur. Le nom de l'organisation est identique à celui de votre projet Google Cloud.
  3. Dans la vue principale, cliquez sur Proxys d'API.
  4. Dans la liste déroulante Sélectionner un environnement, sélectionnez un environnement.
  5. Cliquez sur Créer.
  6. Cliquez sur Inverser le proxy (le plus courant).
  7. Sur la page Détails du proxy, configurez votre proxy avec les paramètres suivants :
    Nom du paramètre Valeur
    Nom hello-world
    Chemin de base /hello-world
    Cible (API existante) https://mocktarget.apigee.net
  8. Cliquez sur Next (Suivant).
  9. Sur la page Règles communes, sous Sécurité : Autorisation, sélectionnez Accès libre (aucune autorisation).
  10. Cliquez sur Next (Suivant).
  11. Sur la page Résumé, sous Déploiement facultatif, sélectionnez l'environnement dans lequel déployer le proxy.
  12. Cliquez sur Create and deploy (Créer et déployer).

    Votre proxy d'API est créé et déployé dans l'environnement sélectionné.

  13. Cliquez sur Accéder à la liste des proxys. Une coche verte sous État indique que le proxy a bien été déployé. Si le proxy n'est pas déployé, consultez la section Déployer un proxy d'API et suivez les étapes pour le déployer manuellement.
  14. Dans le volet de navigation de gauche, sélectionnez Administrateur > Environnements > Groupes.
  15. Copiez le nom d'hôte de votre groupe d'environnements. Vous utiliserez ce nom d'hôte pour appeler le proxy d'API lors des étapes suivantes.

Appeler le proxy avec accès interne

Si vous avez autorisé l'accès interne à l'Étape 7 : Configurer le routage des accès, suivez les instructions de la section Appeler un proxy d'API avec un accès interne uniquement.

Appeler le proxy avec un accès externe

Si vous avez autorisé l'accès externe à l'Étape 7 : Configurer le routage des accès, procédez comme suit :

  1. Configurez une entrée DNS pour votre hôte. Pour ce faire, vous deux options s'offrent à vous :
    • Au niveau de votre bureau d'enregistrement, créez un enregistrement A pointant vers le nom d'hôte de votre groupe d'environnements pour l'adresse IP indiquée sur la page de l'assistant sous Configurer les paramètres DNS. Par exemple, si votre nom d'hôte est sales.example.com et que l'adresse IP est 10.23.0.2, faites pointer l'enregistrement pour sales.example.com vers l'adresse 10.23.0.2.
    • Utilisez Cloud DNS pour mapper une URL à une adresse IP.
  2. Testez le proxy d'API en envoyant la requête suivante dans une fenêtre de terminal : 
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
  https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    Où :

    Une requête réussie renvoie la chaîne Hello, Guest!. Si votre requête échoue, consultez la section Dépannage.

Étapes suivantes