Déployer une passerelle auto-hébergée de gestion des API Azure sur Docker

S’APPLIQUE À : Développeur | Premium

Cet article explique comment déployer la passerelle auto-hébergée de la Gestion des API Azure dans un environnement Docker.

Remarque

L’hébergement d’une passerelle auto-hébergée dans Docker est mieux adapté aux cas d’utilisation d’évaluation et de développement. Il est recommandé d’utiliser Kubernetes dans un environnement de production. Découvrez comment déployer une passerelle auto-hébergée sur Kubernetes avec Helm ou à l’aide d’un fichier YAML de déploiement.

Prérequis

• Suivez le guide de démarrage rapide suivant : Créer une instance Gestion des API Azure.
• Créer un environnement Docker : Docker for Desktop est une bonne option à des fins de développement et d’évaluation. Pour plus d’informations sur toutes les éditions de Docker, leurs fonctionnalités et une documentation complète sur Docker, voir la Documentation Docker.
• Provisionnez une ressource de passerelle dans votre instance Gestion des API Azure.

Remarque

Les passerelles auto-hébergées sont empaquetées en tant que conteneurs Docker basés sur Linux x86-64.

Déployer une passerelle auto-hébergée sur Docker

1. Sélectionnez des passerelles auto-hébergées sous Déploiement + infrastructure.

2. Sélectionnez la ressource de passerelle que vous souhaitez déployer.

3. Sélectionnez Paramètres>Déploiement.

4. Notez qu’un jeton d’accès dans la zone de texte Jeton est généré automatiquement pour vous à l’aide des valeurs de clé d’expiration et de clé secrète par défaut. Si nécessaire, sélectionnez les valeurs souhaitées dans l’un des contrôles ou dans les deux pour générer un jeton.

5. Assurez-vous que Docker est sélectionné sous Scripts de déploiement.

6. Sélectionnez le lien du fichier env.conf en regard de l’environnement pour télécharger le fichier.

7. Sélectionnez l’icône Copier située à droite de la zone de texte Exécuter pour copier la commande Docker dans votre Presse-papiers.

8. Collez la commande dans la fenêtre (ou la commande) du terminal. Ajustez les mappages de port et le nom de conteneur si nécessaire. La commande suppose que le fichier d’environnement téléchargé est présent dans le répertoire actif.

   docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>
   

9. Exécutez la commande. La commande indique à votre environnement Docker d’exécuter le conteneur à l’aide d’une image conteneur à partir du Registre d’artefacts Microsoft et de mapper les ports HTTP (8080) et HTTPS (8081) aux ports 80 et 443 sur l’hôte.

10. Exécutez la commande suivante pour vérifier si le conteneur de passerelle est en cours d’exécution :

    docker ps
    CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
    895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway
    

11. Revenez au portail Azure, sélectionnez Vue d’ensemble et vérifiez que le conteneur de passerelle auto-hébergé que vous venez de déployer signale un état sain.

    

Conseil

Utilisez la commande console docker container logs <gateway-name> pour afficher un instantané du journal de la passerelle auto-hébergée.

Utilisez la commande docker container logs --help pour voir toutes les options d’affichage des journaux.

Contenu connexe

• Pour en savoir plus sur la passerelle auto-hébergée, consultez la vue d’ensemble de la passerelle auto-hébergée.
• Configurez un nom de domaine personnalisé pour une passerelle auto-hébergée.