Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Cet article présente brièvement le déploiement de proxy. Vous pouvez déployer des proxys à l'aide de l'UI de gestion, de scripts de ligne de commande ou d'API.
Vidéo:regardez une courte vidéo pour découvrir les bonnes pratiques à suivre pour éviter tout temps d'arrêt lors du déploiement d'un 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 de choisir le moment du déploiement. Lorsque vous travaillez dans un environnement de test, vous pouvez effectuer de nombreux déploiements itératifs. 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 se fait automatiquement)
- Modifier un proxy existant
- Créer une révision d'un proxy
- Créer une version d'un proxy
- Transférer un proxy d'un environnement à un autre, par exemple d'un environnement de test à un environnement de production.
- Supprimez et recréez un keystore.
Où déployer un proxy
Vous déployez un proxy dans un environnement. Par défaut, toutes les organisations d'Apigee Edge disposent de deux environnements appelés test et prod. Ces environnements sont simplement conçus pour vous fournir un espace où travailler et tester les modifications apportées aux API, et un autre espace où 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 façon dont vous déployez un proxy dépend de l'emplacement où vous le développez. 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 particulière n'est requise de votre part. 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, et l'UI de gestion se charge du reste. Pour en savoir plus, consultez la section Déployer des proxys dans l'UI.
Si vous développez des proxys et des composants associés hors connexion (c'est-à-dire que 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 par 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 de proxy. Pour en savoir plus, consultez 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 vie 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 de 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 de manière séquentielle, 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 à un moment donné si les révisions partagent le même chemin de base de proxy d'API.
En règle générale, une révision existante doit être désinstallée avant qu'une nouvelle ne puisse être déployée. Parmi les autres options avancées, vous pouvez écraser une version déployée ou choisir de ne pas incrémenter une version du tout. Par exemple, il peut arriver que vous ne souhaitiez pas incrémenter la révision lorsque vous apportez des modifications mineures. Ces options avancées peuvent être obtenues via des 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 d'un 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 en savoir plus 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'UI.
Vidéo:regardez une courte vidéo pour en savoir plus sur les révisions d'API.