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

Maintenant que vous avez configuré Google Cloud et l'UI Apigee hybrid, et que vous avez installé et configuré l'environnement d'exécution, vous êtes prêt à voir comment ils fonctionnent ensemble.

Cette section vous guide au cours des procédures suivantes :

  1. Créez un proxy d'API dans l'interface utilisateur d'Apigee à l'aide de l'assistant de proxy d'API.
  2. Déployer votre nouveau proxy sur votre cluster via l'interface utilisateur

1. Créer un proxy d'API à l'aide de l'interface utilisateur hybride

Cette section explique comment créer un proxy d'API dans l'interface utilisateur à l'aide de l'assistant de création de proxy d'API.

Pour créer un proxy d'API simple à l'aide de l'assistant de proxy d'API :

  1. Ouvrez l'interface utilisateur Apigee dans un navigateur.
  2. Sélectionnez Développer > Proxys d'API dans la vue principale.
  3. Dans la liste déroulante Environnement, sélectionnez l'environnement dans lequel vous souhaitez créer un proxy d'API. Dans cette section, nous partons du principe que le nom de l'environnement est "test". Vous avez créé au moins un environnement à l'étape 5 : Ajouter un environnement.

    L'interface utilisateur hybride affiche la liste des proxys d'API pour cet environnement. Si vous n'avez pas encore créé de proxy, la liste est vide.

  4. Cliquez sur +Proxy en haut à droite.

    L'assistant de création de proxy d'API démarre :

  5. Sélectionnez Proxy inverse (le plus courant), puis cliquez sur Suivant.

    La vue Informations sur le proxy s'affiche.

  6. Configurez votre proxy avec les paramètres suivants :
    • Nom du proxy : saisissez "myproxy". Dans les étapes suivantes de cette section, nous partons du principe qu'il s'agit de l'ID de votre proxy.
    • Chemin de base du proxy : défini automatiquement sur "/myproxy". Le chemin de base du proxy fait partie de l'URL utilisée pour envoyer des requêtes à votre API. Edge utilise l'URL pour mettre en correspondance et acheminer les requêtes entrantes vers le proxy d'API approprié.
    • (Facultatif) Description : saisissez une description de votre nouveau proxy d'API, par exemple "Test Apigee hybride avec un simple proxy".
    • Cible (API existante) : saisissez "https://mocktarget.apigee.net". Cela définit l'URL cible qu'Apigee appelle pour une requête adressée au proxy d'API. Le service "mocktarget" est hébergé sur Apigee et renvoie des données simples. Il ne nécessite aucune clé d'API ni jeton d'accès.

    Les détails de votre proxy API doivent se présenter comme suit :

  7. Cliquez sur Suivant.
  8. Sur l'écran Règles, sélectionnez Pass through (aucune) comme option de sécurité.
  9. Cliquez sur Suivant.
  10. Sur l'écran Résumé, cliquez sur Créer.

    Le mode hybride génère le proxy (parfois appelé groupe de proxy) :

  11. Cliquez sur Quitter.

    Apigee hybrid affiche la vue Proxys, qui comporte la liste des proxys d'API. Le nouveau proxy doit se trouver en haut de la liste, avec un indicateur d'état gris, ce qui signifie qu'il n'a pas encore été déployé.

2. Déployez votre proxy sur le cluster à l'aide de l'interface utilisateur hybride

Après avoir créé un proxy, vous devez le déployer pour pouvoir l'essayer. Cette section explique comment déployer votre nouveau proxy à l'aide de l'UI hybride.

Pour déployer un proxy d'API dans l'interface utilisateur hybride, procédez comme suit :

  1. Dans l'interface utilisateur hybride, sélectionnez Développer > Proxys d'API.

    Assurez-vous que l'environnement "test" est sélectionné.

    L'UI affiche votre nouveau proxy dans la liste des proxys :

  2. Cliquez sur le proxy "myproxy".

    L'interface utilisateur affiche l'onglet Présentation des proxys d'API pour ce proxy.

    Notez que, sous Déploiements, la colonne Révision affiche la mention "Non déployé".

  3. Dans la colonne Révision, développez le sélecteur déroulant pour choisir la révision à déployer.

    La liste déroulante n'affiche que les valeurs "1" et "Annuler le déploiement" :

  4. Dans la liste déroulante, sélectionnez "1", qui est la révision que vous souhaitez déployer.

    L'UI vous invite à confirmer le déploiement :

  5. Cliquez sur Déployer.

    L'UI démarre le processus de déploiement de la révision 1 de votre nouveau proxy sur le cluster.

    Notez que le déploiement n'est pas un processus instantané. Le modèle de déploiement "cohérent à terme" de hybride signifie qu'un nouveau déploiement sera déployé sur le cluster sur une courte période, et pas immédiatement.

Bien qu'il existe plusieurs façons de vérifier l'état de déploiement d'un proxy dans l'interface utilisateur, les deux étapes suivantes expliquent comment appeler le proxy d'API que vous venez de déployer et comment vérifier l'état du déploiement via un appel à l'API Apigee.

3. Appeler le proxy d'API

Lorsque l'interface indique que votre proxy est déployé, vous pouvez essayer de l'appeler à l'aide de cURL ou du client REST de votre choix :

curl -v -k https://your_host_alias/myproxy

Où your_host_alias est un domaine public utilisé pour accéder à vos API, tel que configuré dans la propriété virtualhosts.hostAliases de votre fichier de remplacement. Consultez la section Configurer le cluster.

Exemple : 

curl -v -k https://apitest.acme.com/myproxy

Si l'appel aboutit, vous obtenez le résultat suivant :

Hello, Guest!