Microservices Engine:Use MSE Ingress gateways to access services in ACK clusters and ACS clusters

Fonctionnement

Lorsque vous créez une ressource Kubernetes Ingress avec ingressClassName: mse, MSE Ingress Controller la détecte et la traduit en route sur la passerelle cloud-native MSE. Le trafic entrant transite par une instance d'équilibreur de charge associée à la passerelle, puis est redirigé vers le service cible de votre cluster.

Client → CLB/NLB → MSE cloud-native gateway → Kubernetes Service → Pod

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Conditions à vérifier :

• Un cluster ACK managé, un cluster ACK Serverless ou un cluster Container Compute Service (ACS) exécutant la version V1.18 ou ultérieure. Pour mettre à niveau un cluster plus ancien, consultez la rubrique Mettre à jour manuellement les clusters ACK.

Actions à réaliser :

• Accordez les autorisations nécessaires à MSE Ingress Controller :

  • Pour les clusters ACK managés et les clusters ACK Serverless : Accorder des autorisations

  • Pour les clusters ACS : Accorder des autorisations

Vue d'ensemble des étapes

Ce tutoriel comprend quatre étapes :

1. Installer MSE Ingress Controller

2. Déployer un service backend

3. Configurer une règle MSE Ingress

4. Accéder au service

Étape 1 : Installer MSE Ingress Controller

1. Sur la page Add-ons, saisissez mse dans la zone de recherche et cliquez sur Install dans la carte MSE Ingress Controller.

   

2. Dans la boîte de dialogue Install MSE Ingress Controller, configurez les paramètres et cliquez sur OK.

   Clusters ACK managés ou clusters ACK Serverless

   Clusters ACK managés et clusters ACK Serverless : Une passerelle cloud-native Professional Edition en paiement à l'utilisation est automatiquement créée avec un nœud doté de 4 cœurs CPU et 8 Go de mémoire, ainsi qu'une instance Classic Load Balancer (CLB) Standard I (slb.s2.small), selon le type de réseau spécifié. Vous pouvez modifier ces spécifications après la création.

   ACS

   Clusters ACS : Une passerelle cloud-native serverless est automatiquement créée avec une instance Network Load Balancer (NLB), selon le type de réseau spécifié.

   Important

   Si l'erreur Failed to pass the precheck. s'affiche, accordez les autorisations à MSE Ingress Controller et réessayez : - Pour les clusters ACK managés et les clusters ACK Serverless : Accorder des autorisations - Pour les clusters ACS : Accorder des autorisations

3. Attendez que la passerelle atteigne l'état Listening (généralement 3 à 5 minutes). Après l'installation, le système crée une ressource MseIngressConfig nommée mse-ingress-pro/serverless-{clusterid} et une ressource IngressClass nommée mse. La passerelle écoute automatiquement les ressources Ingress avec ingressClassName: mse dans votre cluster. Pour vérifier l'état de la passerelle dans la console ACK : cliquez sur le nom du cluster, puis sélectionnez Workloads > Deployments > Custom Resources. Sur l'onglet Resource Objects, recherchez mse dans la section API Group pour afficher la ressource MseIngressConfig. Les états de la passerelle évoluent dans l'ordre suivant. Pour vérifier avec kubectl, exécutez :

   Important

   - Le cycle de vie de MseIngressConfig est lié à l'instance de passerelle cloud-native MSE. La suppression d'une ressource MseIngressConfig entraîne également la suppression de la passerelle associée. Ne supprimez pas les ressources MseIngressConfig sauf indication contraire. - Si une IngressClass nommée mse existe déjà dans votre cluster avant l'installation, le système ne crée pas automatiquement une nouvelle passerelle ni une ressource MseIngressConfig.

   État	Signification
   Pending	La passerelle est en cours de création. Attendez environ 3 minutes.
   Running	La passerelle est créée et en cours d'exécution.
   Listening	La passerelle est en cours d'exécution et écoute les ressources Ingress.
   Failed	La passerelle est dans un état invalide. Consultez le champ Message dans le champ Status pour connaître la cause.

   kubectl get mseingressconfig
   kubectl get ingressclass mse

   

4. Connectez-vous à la console MSE et confirmez qu'une passerelle cloud-native nommée mse-ingress-pro/serverless-{clusterid} apparaît dans votre région.

Étape 2 : Déployer un service backend

1. Sur la page Deployments, cliquez sur Create from YAML et appliquez le manifeste suivant pour déployer un déploiement et un service httpbin dans le namespace default.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: httpbin
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: httpbin
     template:
       metadata:
         labels:
           app: httpbin
           version: v1
       spec:
         containers:
           - image: registry.cn-hangzhou.aliyuncs.com/mse-ingress/go-httpbin
             args:
               - "--version=v1"
             imagePullPolicy: Always
             name: httpbin
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: httpbin
     namespace: default
   spec:
     ports:
       - port: 8080
         protocol: TCP
     selector:
       app: httpbin

2. Vérifiez que le déploiement est en cours d'exécution :

   kubectl get deployment httpbin

   La sortie doit afficher READY 1/1 et AVAILABLE 1 :

   NAME      READY   UP-TO-DATE   AVAILABLE   AGE
   httpbin   1/1     1            1           30s

Étape 3 : Configurer une règle MSE Ingress

1. Sur la page Ingresses, cliquez sur Create Ingress.

2. Dans la boîte de dialogue Create Ingress :

   • Définissez Gateway Type sur MSE Ingress.

   • Définissez Ingress Class sur mse.

   • Configurez une route : sélectionnez Prefix (Prefix-based Match) dans la liste déroulante Rule, saisissez / dans le champ Path et sélectionnez httpbin dans la liste déroulante Service.

   • Cliquez sur OK.

3. Connectez-vous à la console MSE et confirmez que la passerelle cloud-native dispose d'une route dont le nom contient httpbin.

   

Étape 4 : Accéder au service

1. Obtenez l'adresse IP de la passerelle en utilisant l'une des méthodes suivantes :

   Depuis la console ACK ou ACS : Accédez à Network > Ingresses et consultez le point de terminaison Ingress.

   Depuis la console MSE : Accédez à Cloud-native Gateway > Gateways, cliquez sur le nom de la passerelle et consultez l'adresse IP de l'équilibreur de charge sur la page Overview.

   Clusters ACK managés ou clusters ACK Serverless

   Clusters ACK/Serverless :

   ACS

   Clusters ACS :

   

2. Utilisez un navigateur web, cmd ou un autre outil en ligne de commande pour envoyer une requête à <gateway-IP>/version et vérifiez que le service est accessible.

   

Étapes suivantes

• Gestion de MSE Ingress — Découvrez le fonctionnement des passerelles MSE Ingress et explorez les options de configuration avancées telles que HTTPS, les déploiements canaris et l'observabilité.