Présentation du déploiement

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Cet article offre un aperçu rapide du déploiement du proxy. Vous pouvez déployer des proxys à l'aide de l'interface utilisateur de gestion, de scripts de ligne de commande ou à l'aide d'API.

Vidéo:Regardez une courte vidéo pour en savoir plus sur les bonnes pratiques pour zéro temps d'arrêt lors du déploiement du proxy d'API.

Quand déployer un proxy ?

Un proxy doit être déployé avant de pouvoir être appelé. En règle générale, c'est vous qui décidez du déploiement. Lorsque vous travaillez dans un environnement de test, vous pouvez effectuer des déploiements de manière itérative. En revanche, la décision de déployer un proxy de l'environnement de test vers un environnement de production dépend généralement des règles de cycle de vie établies par votre équipe de développement.

Déployez ou redéployez un proxy lorsque vous:

  • Créer un proxy (le déploiement est automatique)
  • Modifier un proxy existant
  • Créer une révision d'un proxy
  • Créer une version de proxy
  • Transférez un proxy d'un environnement à un autre, par exemple d'un environnement de test vers un environnement de production.
  • Supprimez et recréez un keystore.

Où déployer un proxy

Vous déployez un proxy dans un environnement. Toutes les organisations d'Apigee Edge disposent par défaut de deux environnements appelés test et prod. Ces environnements sont simplement conçus pour vous fournir un espace sur lequel travailler et tester les modifications des API, et un autre espace dans lequel les API sont exposées aux applications. La figure suivante montre un proxy déployé dans l'environnement test, comme indiqué par le point vert.

Déployer un proxy

La manière dont vous déployez un proxy dépend de l'emplacement où vous développez le proxy. Si vous travaillez dans l'interface utilisateur, vous pouvez facilement déployer un proxy en quelques clics. Un nouveau proxy est automatiquement déployé lorsque vous le créez. Aucune action de votre part n'est requise. La procédure de redéploiement d'un proxy existant est presque aussi simple. Il vous suffit de sélectionner l'environnement de déploiement dans lequel effectuer le déploiement. L'interface utilisateur de gestion se charge du reste. Pour en savoir plus, consultez la section Déployer des proxys dans l'interface utilisateur.

Si vous développez des proxys et des composants associés hors connexion (c'est-à-dire si vous travaillez avec des fichiers XML de proxy et d'autres codes directement sur votre système de fichiers), Apigee Edge fournit un outil de déploiement de ligne de commande pratique que vous pouvez utiliser. Vous pouvez également obtenir un exemple de script shell que vous pouvez configurer et exécuter pour importer et déployer vos fichiers proxy. Pour en savoir plus, consultez la section Déployer des proxys à partir de la ligne de commande.

Enfin, vous pouvez utiliser l'API de gestion Edge pour déployer des proxys. Les API de déploiement exposent des fonctions atomiques que votre équipe de développement peut coordonner pour automatiser et optimiser le cycle de développement de vos API. Consultez la section Déployer des proxys d'API à l'aide de l'API de gestion.

Qu'est-ce qu'une révision du proxy d'API ?

Les révisions vous permettent de gérer les mises à jour du proxy d'API lorsque vous les créez et les déployez dans un environnement. Les révisions sont numérotées dans l'ordre, ce qui vous permet d'annuler une modification en déployant une révision précédente de votre proxy d'API.

Une seule révision d'un proxy d'API peut être déployée dans un environnement à la fois si les révisions partagent le même chemin de base de proxy d'API.

En règle générale, vous devez annuler le déploiement d'une révision existante avant de pouvoir en déployer une nouvelle. D'autres options avancées incluent l'écrasement d'une révision déployée ou la possibilité de ne pas incrémenter de révision. Par exemple, lorsque vous apportez des modifications mineures, vous pouvez parfois ne pas vouloir incrémenter la révision. Ces options avancées peuvent être réalisées par le biais d'appels directs à l'API de gestion Edge. Consultez la section Déployer des proxys d'API à l'aide de l'API de gestion.

Vous pouvez déployer une révision de proxy d'API dans l'environnement prod, tout en continuant à créer des révisions de ce proxy d'API dans l'environnement test. Lorsque vous êtes prêt, vous pouvez "promouvoir" la révision supérieure de votre proxy d'API de l'environnement test par rapport à la révision précédente du proxy d'API dans l'environnement prod.

Pour plus d'informations sur les révisions, consultez les pages Déployer des proxys d'API à l'aide de l'API de gestion et Déployer des proxys dans l'interface utilisateur.

Vidéo:regardez une courte vidéo pour en savoir plus sur les révisions de l'API.