Déployer des proxys à partir de la ligne de commande

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Cet article explique comment déployer un proxy à partir de la ligne de commande. Apigee Edge propose deux de déploiement à partir de la ligne de commande. La première consiste à utiliser un outil de déploiement Apigee Edge est écrit en Python. La seconde consiste à configurer et à exécuter un script shell.

Utilisez les techniques de déploiement en ligne de commande lorsque vous travaillez directement avec une source de proxy de fichiers sur votre système. Plusieurs raisons peuvent expliquer pourquoi vous travaillez hors connexion. Vous pouvez utiliser votre éditeur XML favori, ou si vous développez des règles qui nécessitent du codage Java et que vous travaillant principalement dans un IDE. Les techniques décrites dans cette section vous permettent d'importer et de déployer vos fichiers sources dans l'environnement des services d'API de votre choix.

Si vous travaillez principalement dans l'interface utilisateur de gestion, consultez la section Déployer des proxys dans l'interface utilisateur.

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

Exécuter l'outil de déploiement Python d'Apigee Edge

L'outil de déploiement Python d'Apigee Edge fonctionne avec l'API de gestion Edge pour importer et déployer l'API proxys. L'outil est disponible avec la distribution d'exemples de plate-forme d'API sur GitHub. Voir Utiliser les exemples de proxys d'API

Utilisez l'outil Python d'Apigee Edge pour importer (importer) et déployer votre API processus.

L'outil de déploiement doit être exécuté à partir du répertoire de base dans la distribution de la plate-forme d'API Une distribution d'exemples, où le répertoire de base est le répertoire parent de setup et tools.

Dans la commande suivante, remplacez le nom du proxy, votre nom d'utilisateur et votre mot de passe Edge, le nom du proxy l'organisation et l'environnement, ainsi que le chemin d'accès au répertoire qui contient le Répertoire apiproxy":

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Exemple :

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Cette commande compresse vos fichiers, les transfère vers votre organisation sur Apigee Edge et les déploie à l'environnement spécifié.

L'outil de déploiement détecte automatiquement la révision actuelle de votre API annule le déploiement de la révision existante et déploie une révision incrémentée de l'API. proxy.

En cas de réussite, le résultat se présente sous la forme suivante:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

Par défaut, l'outil importe le proxy d'API dans https://api.enterprise.apigee.com. correspondant à Edge dans le cloud. Vous pouvez également utiliser cet outil pour télécharger le proxy d'API vers la version sur site d'Edge en spécifiant l'indicateur -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

Dans cet exemple, vous spécifiez l'adresse IP du serveur de gestion Edge. Si vous avez créé un enregistrement DNS pour le serveur de gestion, vous pouvez spécifier une URL au format suivant:

https://ms_URL:8080

Voici la liste complète des indicateurs de la commande:

  • -n: nom de votre proxy d'API.
  • -u: nom d'utilisateur et mot de passe de votre compte dans une organisation dans Apigee Périphérie.
  • -o: nom de l'organisation dans laquelle vous possédez un compte.
  • -e: environnement dans lequel le proxy d'API doit être déployé (test ou prod).
  • -d: chemin d'accès au répertoire contenant vos fichiers de proxy d'API. Votre proxy d'API doivent être stockés dans un répertoire nommé "apiproxy". Cette valeur correspond au chemin d'accès avec le répertoire "apiproxy", et non au chemin d'accès "apiproxy", lui-même.
  • -p: chemin d'URI utilisé comme correspondance de modèle pour acheminer le message entrant vers cette API déploiement du proxy. Dans la plupart des cas, vous pouvez définir cette valeur sur "/", sauf si vous avez défini des paramètres avancés de déploiement et de routage. Le chemin principal utilisé pour le routage du proxy API est défini dans le fichier de configuration ProxyEndpoint du proxy d'API.
  • -h: URL Edge. Par défaut, l'URL est https://api.enterprise.apigee.com. correspondant à Edge dans le cloud. Pour un déploiement sur site, utilisez l'URL de la passerelle serveur de gestion de projet et le port 8080, comme dans: 
    https://ms_URL:8080

    Vous pouvez également utiliser l'adresse IP du serveur de gestion, comme dans https://192.168.11.111:8080.

Configurer et exécuter une interface système de déploiement script

L'approche la plus simple consiste à exécuter le script de déploiement fourni avec l'exemple de proxy d'API. Le shell encapsulent l'outil de déploiement Python d'Apigee Edge.

Dans le répertoire /simplyProxy, exécutez la commande suivante:

$ sh deploy.sh

Vous devriez obtenir le résultat suivant :

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

Saisissez votre mot de passe et appuyez sur ENTRÉE.

Vous devriez alors obtenir le résultat suivant:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Si vous voyez ce qui suit:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

cela signifie que vous devez modifier le fichier /setup/setenv.sh dans la distribution des échantillons de plate-forme. Pour obtenir des instructions, consultez le fichier README ou les API Apigee Edge.

En cas de réussite, l'outil de déploiement compresse les fichiers sous /apiproxy, importations. le package dans votre organisation sur Apigee Edge, puis déploie le proxy d'API sur le environnement.

Votre proxy d'API est prêt à être appelé.