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

  • Article

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.

Important

La prise en charge des images conteneur de la passerelle auto-hébergée version 0 et version 1 d’Azure Gestion des API se termine le 1er octobre 2023, ainsi que son API de configuration correspondante v1. Utilisez notre guide de migration pour utiliser la passerelle auto-hébergée v2.0.0 ou une version ultérieure avec l’API de configuration v2. En savoir plus dans notre documentation de dépréciation

Notes

L’hébergement d’une passerelle auto-hébergée dans Docker convient pour l’évaluation, ainsi que pour les cas d’utilisation de développement. Il est recommandé d’utiliser Kubernetes dans un environnement de production. Apprenez à déployer avec Helm ou à l’aide du fichier de déploiement YAML pour apprendre à déployer la passerelle auto-hébergée sur Kubernetes.

Prérequis

Notes

La passerelle auto-hébergée se présente sous la forme d’un conteneur Docker basé sur Linux x86-64.

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

  1. Sélectionnez Gateways (Passerelles) sous Deployment and infrastructure (Déploiement et infrastructure).

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

  3. Sélectionnez Déploiement.

  4. Remarquez qu’un jeton d’accès a été généré automatiquement dans la zone de texte Token (Jeton), avec les valeurs par défaut pour l’expiration (Expiry) et la clé secrète (Secret key). 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 de fichier env. conf en regard de l’Environnement pour télécharger le fichier.

  7. Sélectionnez l’icône Copier située à l’extrémité droite de la zone de texte Exécuter pour copier la commande Docker dans le 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. Notez que la commande s’attend à ce que le fichier d’environnement téléchargé soit 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 demande à votre environnement Docker d’exécuter le conteneur à l’aide de l’image conteneur à partir de Microsoft Artifect Registry, et de mapper les ports HTTP (8080) et HTTPS (8081) du conteneur aux ports 80 et 443 de l’hôte.

  10. Exécutez la commande ci-dessous pour vérifier que le conteneur de la 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, cliquez sur Vue d’ensemble, puis vérifiez que le conteneur de la passerelle auto-hébergée que vous venez de déployer indique un état sain.

    état de la passerelle

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.

Étapes suivantes