Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
S’APPLIQUE À : Développeur | Premium
Cet article décrit les étapes de déploiement du composant de passerelle auto-hébergé de Gestion des API Azure sur Azure Kubernetes Service (AKS). Pour déployer une passerelle auto-hébergée sur un cluster Kubernetes, consultez l’article de procédure pour le déploiement à l’aide d’un fichier YAML de déploiement ou avec Helm.
Remarque
Vous pouvez également déployer une passerelle auto-hébergée sur un cluster Kubernetes avec Azure Arc en tant qu’extension de cluster.
Prérequis
- Créer une instance du service Gestion des API Azure
- Créez un cluster Kubernetes Azure en utilisant Azure CLI, en utilisant Azure PowerShell ou en utilisant le Portail Azure.
- Provisionnez une ressource de passerelle dans votre instance de gestion des API.
Déployer une passerelle auto-hébergée sur AKS
Sélectionnez Gateways (Passerelles) sous Deployment and infrastructure (Déploiement et infrastructure).
Sélectionnez la ressource de passerelle auto-hébergée que vous souhaitez déployer.
Sélectionnez Déploiement.
Un nouveau jeton dans la zone de texte Jeton a été généré automatiquement pour vous avec les valeurs par défaut de Expiration et Clé secrète. Ajustez l’un ou l’autre, ou les deux, si vous le souhaitez, puis sélectionnez Générer pour créer un autre jeton.
Assurez-vous que Kubernetes est sélectionné sous Scripts de déploiement.
Sélectionnez le lien de fichier <nom-passerelle.yml> en regard de Déploiement pour télécharger le fichier.
Ajustez
config.service.endpoint, les mappages de port et le nom de conteneur dans le fichier .yml, si nécessaire.Selon votre scénario, vous pouvez avoir besoin de changer le type de service.
- La valeur par défaut est
LoadBalancer, qui correspond à l’équilibreur de charge externe. - Vous pouvez utiliser l’équilibreur de charge interne pour restreindre l’accès à la passerelle auto-hébergée aux utilisateurs internes uniquement.
- L’exemple suivant utilise
NodePort.
- La valeur par défaut est
Sélectionnez l’icône Copier située à l’extrémité droite de la zone de texte Déployer pour enregistrer la commande
kubectldans le Presse-papiers.Collez la commande dans la fenêtre (ou la commande) du terminal. La commande s’attend à ce que le fichier d’environnement téléchargé soit présent dans le répertoire actif.
kubectl apply -f <gateway-name>.yamlExécutez la commande. La commande indique à votre cluster AKS d’effectuer les opérations suivantes :
- Exécuter le conteneur à l’aide de l’image de passerelle auto-hébergée téléchargée à partir du Microsoft Container Registry.
- Configurer le conteneur pour exposer les ports HTTP (8080) et HTTP (443).
Exécutez la commande suivante pour vérifier que votre pod de passerelle est en cours d’exécution. Ce nom de pod est un exemple.
kubectl get pods NAME READY STATUS RESTARTS AGE contoso-apim-gateway-59f5fb94c-s9stz 1/1 Running 0 1mExécutez la commande suivante pour vérifier que votre service de passerelle est en cours d’exécution. Le nom du service et les adresses IP sont des exemples.
kubectl get services NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE contosogateway NodePort 10.110.230.87 <none> 80:32504/TCP,443:30043/TCP 1mRevenez au portail Azure et vérifiez que le nœud de passerelle que vous avez déployé signale un état sain.
Conseil
Utilisez la commande kubectl logs <gateway-pod-name> pour afficher un instantané du journal de la passerelle auto-hébergée.
Contenu connexe
- Pour en savoir plus sur la passerelle auto-hébergée, consultez Vue d’ensemble de la passerelle auto-hébergée Gestion des API.
- Découvrez comment déployer une passerelle auto-hébergée Gestion des API sur des clusters Kubernetes avec Azure Arc.
- En savoir plus sur les capacités d’observabilité des passerelles de Gestion des API Azure.
- En savoir plus sur l’aide pour exécuter la passerelle auto-hébergée sur Kubernetes en production.
- En savoir plus sur Azure Kubernetes Service.