Procédure recommandée

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 Suivant.
  8. Dans Étape 2 : Déployer (facultatif) :
    • Environnements de déploiement : facultatif. Cochez les cases correspondant aux environnements dans lesquels déployer votre proxy. Si vous préférez ne pas déployer le proxy à ce stade, laissez le champ Environnements de déploiement vide. Vous pourrez toujours déployer le proxy ultérieurement.
    • Compte de service : facultatif. Associez un compte de service à votre déploiement pour permettre à votre proxy d'accéder aux services Google Cloud, comme spécifié dans le rôle et les autorisations du compte de service.
  9. Cliquez sur Créer.

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

  10. 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.
  11. Dans le volet de navigation de gauche, sélectionnez Gestion > Environnements > Groupes d'environnements.
  12. 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 Suivant.
  9. Sur la page Règles communes, sous Sécurité : Autorisation, sélectionnez Accès libre (aucune autorisation).
  10. Cliquez sur 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. Cliquez sur Afficher dans la console Google Cloud.
  16. 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.
  17. Fermez la console Google Cloud.

Appeler le proxy avec accès interne

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

Appeler le proxy avec un accès externe

Si vous avez autorisé l'accès externe à l'étape 4 : Personnaliser le routage d'accès, procédez comme suit :

  1. Configurez une entrée DNS pour votre hôte. Pour ce faire, 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ù :

    • La valeur de l'en-tête Host (YOUR_ENV_GROUP_HOSTNAME) est le nom d'hôte de la page Environnements > Groupes d'environnements.

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

Étapes suivantes