Tous les produits
Search
Centre de documentation

Alibaba Cloud Service Mesh:Create an ingress gateway

Dernière mise à jour :Aug 24, 2026

Une passerelle d'entrée offre un point d'accès unique au trafic externe vers votre maillage de services, que ce soit via Internet ou un réseau interne. Elle achemine les requêtes HTTP vers les services backend en fonction des chemins URL, des en-têtes d'hôte et d'autres attributs, vous offrant ainsi un contrôle du trafic de niveau 7.

Après avoir créé la passerelle, définissez des règles de routage Istio pour contrôler la distribution du trafic. La ressource Gateway gère la configuration des ports et des protocoles. Les ressources VirtualService se chargent de la logique de routage, telle que le routage basé sur le chemin, les déploiements canaris et les tests A/B.

Fonctionnement

  1. Déployez une passerelle d'entrée dans un cluster Kubernetes géré par votre instance ASM.

  2. Créez un service LoadBalancer, ClusterIP ou NodePort pour accepter le trafic externe.

  3. Créez des ressources Istio Gateway et VirtualService pour définir comment le trafic est acheminé depuis la passerelle vers vos services backend.

Prérequis

Créer une passerelle d'entrée dans la console

Les étapes suivantes vous guident à travers trois phases : configuration des paramètres de base, configuration des options avancées et vérification de la passerelle.

  1. Connectez-vous à la console ASM. Dans le volet de navigation de gauche, sélectionnez Service Mesh > Mesh Management.

  2. Sur la page Mesh Management, cliquez sur le nom de l'instance ASM. Dans le volet de navigation de gauche, sélectionnez ASM Gateways > Ingress Gateway.

  3. Sur la page Ingress Gateway, cliquez sur Create.

  4. Configurez les paramètres de base.

    Paramètre Description
    Name Nom de la passerelle d'entrée.
    Cluster Cluster dans lequel déployer la passerelle.
    Service Type Type de service Kubernetes : LoadBalancer, ClusterIP ou NodePort. Pour plus de détails, consultez la rubrique Service.
    CLB / NLB Apparaît lorsque le paramètre Service Type est défini sur LoadBalancer. Sélectionnez Internet Access pour les services exposés publiquement ou Private Access pour les services internes.
    Create LoadBalancer Instance Apparaît lorsque le paramètre Service Type est défini sur LoadBalancer. Options disponibles :
    - Create LoadBalancer Instance : Pour CLB, sélectionnez une spécification dans Select CLB Specifications. Pour NLB, sélectionnez des vSwitches dans au moins deux zones depuis Select Zones for NLB Instance.
    - Use Existing SLB Instance : Sélectionnez un équilibreur de charge existant dans la liste.
    Port Mapping Définissez le protocole Protocol et le port de service Service Port. La console propose deux ports Istio par défaut. Modifiez-les si nécessaire.
    Resources Limits Limites de CPU et de mémoire pour le pod de la passerelle.
    Gateway instances Nombre de réplicas de pods pour la passerelle.
    Remarque

    Si votre cluster de plan de données est un cluster enregistré, vérifiez qu'il prend en charge les services LoadBalancer avant de sélectionner LoadBalancer. Sinon, la création de la passerelle échouera.

    Important

    Utilisez un équilibreur de charge dédié pour chaque service Kubernetes. Le partage d'un équilibreur de charge présente les risques suivants :

    • La réutilisation d'un équilibreur de charge existant écrase ses écouteurs, rendant potentiellement les applications inaccessibles.

    • Seuls les équilibreurs de charge créés manuellement (via la console ou OpenAPI) peuvent être réutilisés. Les équilibreurs de charge provisionnés par Kubernetes via la ressource Service ne peuvent pas être réutilisés.

    • Les services partageant un équilibreur de charge ne peuvent pas utiliser le même port d'écoute frontal.

    • Ne renommez pas les écouteurs ni les groupes de serveurs virtuels, car Kubernetes utilise leurs noms comme identifiants uniques.

    • La réutilisation d'équilibreurs de charge entre clusters et entre régions n'est pas prise en charge.

    Pour définir la passerelle en YAML à la place, cliquez sur Use a YAML template sur la page Ingress Gateway. Pour connaître le schéma, consultez la rubrique Manage the ingress gateway by using KubeAPI.

  5. (Facultatif) Cliquez sur Advanced Options pour une configuration supplémentaire.

    Paramètre Description
    External Traffic Policy Contrôle la distribution du trafic. Local : achemine le trafic uniquement vers les pods situés sur le nœud récepteur, en préservant l'adresse IP source du client. Cluster : permet au trafic d'atteindre les pods sur n'importe quel nœud.
    HPA Active la mise à l'échelle horizontale automatique des pods. Définissez les éléments de surveillance Monitoring items, le seuil Threshold, le nombre maximal de réplicas Maximum replicas et le nombre minimal de réplicas Minimum number of replicas. Si les seuils CPU et mémoire sont tous deux configurés, la passerelle effectue une mise à l'échelle dès qu'un seuil est dépassé. Disponible uniquement pour les éditions Enterprise ou Ultimate.
    Rolling Upgrade Contrôle le comportement de la mise à jour progressive. Maximum number of unavailable instances : nombre de pods pouvant être indisponibles pendant une mise à jour. Exceeding the desired number of instances : nombre supplémentaire de pods autorisés pendant une mise à jour (par exemple, 25 % signifie que le nombre de réplicas ne peut pas dépasser 125 % du nombre souhaité).
    Enable MultiBuffer-based TLS encryption and decryption performance optimization Accélère le traitement TLS. Définissez le paramètre supported nodeaffinity pour sélectionner les nœuds cibles et le délai d'interrogation Poll Delay(ms) pour ajuster la latence. Consultez la rubrique Parameter description. Disponible uniquement pour les éditions Enterprise ou Ultimate.
    Deploy ASM Gateway replicas as widely as possible Définit le paramètre podAntiAffinity afin que les pods de la passerelle soient planifiés sur différents nœuds lorsque cela est possible.
    Custom Deployment Policy Configure les paramètres nodeSelector, tolerations et affinity pour les pods de la passerelle. Consultez la rubrique ASM gateway CRD description.
    Graceful Shutdown Maintient les connexions existantes ouvertes lors de la suppression des pods. Connection timeout (seconds) : durée pendant laquelle l'équilibreur de charge attend avant de se déconnecter du pod supprimé. Ne dépassez pas la période de fermeture gracieuse par défaut de 30 secondes. Disponible uniquement pour les éditions Enterprise ou Ultimate.
  6. Cliquez sur Create.

Vérifier le résultat

Sur la page Ingress Gateway, confirmez que l'état de la passerelle est Running. La colonne Service address affiche l'adresse IP de la passerelle.

Gérer la passerelle d'entrée

Modifier ou afficher dans la console ASM

  1. Connectez-vous à la console ASM. Dans le volet de navigation de gauche, sélectionnez Service Mesh > Mesh Management.

  2. Sur la page Mesh Management, cliquez sur le nom de l'instance ASM. Dans le volet de navigation de gauche, sélectionnez ASM Gateways > Ingress Gateway.

  3. Sur la page Ingress Gateway, localisez la passerelle cible et effectuez l'une des actions suivantes :

    • Cliquez sur View Details pour afficher ou modifier la configuration de la passerelle.

    • Cliquez sur YAML pour modifier directement la ressource de la passerelle. Dans la boîte de dialogue Edit, modifiez les champs et cliquez sur OK. Pour plus de détails sur les champs, consultez la rubrique ASM gateway CRD description.

Supprimer la passerelle

Localisez la passerelle cible et cliquez sur Delete. Dans la boîte de dialogue Submit, cliquez sur OK.

Important

La suppression de la passerelle d'entrée supprime définitivement l'accès externe aux services via cette passerelle. Cette action est irréversible.

Afficher dans la console ACK

Informations sur le service :

  1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

  2. Sur la page Clusters, cliquez sur le nom du cluster. Dans le volet de navigation de gauche, sélectionnez Network > Services.

  3. Sélectionnez istio-system dans la liste déroulante Namespace. La colonne External IP affiche l'adresse IP de la passerelle d'entrée.

Informations sur les pods :

  1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

  2. Sur la page Clusters, cliquez sur le nom du cluster. Dans le volet de navigation de gauche, sélectionnez Workloads > Pods.

  3. Sélectionnez Istio-system dans la liste déroulante Namespace. Cliquez sur un pod pour afficher ses détails.

Étapes suivantes

Références