Alibaba Cloud Service Mesh:Migrate traffic from Nginx Ingress Controller to an ingress gateway

Fonctionnement

Avec le Nginx Ingress Controller, une seule ressource Ingress gère à la fois la configuration de l'écouteur (ports, hôtes, TLS) et les règles de routage (chemins, backends). Istio sépare ces éléments en deux ressources distinctes :

• Gateway -- Définit la couche infrastructure : quels ports exposer, quels protocoles accepter et quels hôtes servir.

• VirtualService -- Définit la couche de routage : comment faire correspondre les requêtes entrantes et où les envoyer.

Pendant la migration, le Nginx Ingress Controller et la passerelle d'entrée ASM partagent la même instance CLB. Une répartition du trafic basée sur des pondérations vous permet de déplacer le trafic de manière incrémentielle, de vérifier le comportement à chaque étape et de revenir en arrière en définissant la pondération sur 0.

Prérequis

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

• Une instance ASM Enterprise Edition ou Ultimate Edition, exécutant la dernière version. Consultez la rubrique Créer une instance ASM

• Un cluster Container Service for Kubernetes (ACK) ajouté à l'instance ASM. Consultez la rubrique Ajouter un cluster à une instance ASM

• L'ID de l'instance CLB et les ID des groupes de serveurs virtuels pour votre configuration Nginx Ingress Controller existante

• L'algorithme de planification CLB défini sur weighted round-robin (WRR)

Étape 1 : Créer une passerelle d'entrée qui partage le CLB existant

Créez une passerelle d'entrée ASM qui réutilise l'instance CLB déjà associée au Nginx Ingress Controller. Cela permet aux deux passerelles de coexister derrière le même équilibreur de charge pendant la migration.

Ajoutez les annotations de service suivantes au YAML de la passerelle pour lier la passerelle d'entrée à votre CLB existant :

Exemple de configuration de passerelle :

serviceAnnotations:
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-id: "lb-xxxxx"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-force-override-listeners: 'false'
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-vgroup-port: "${YOUR_VGROUP_ID}:80"
  service.beta.kubernetes.io/alibaba-cloud-loadbalancer-weight: "60"

Remplacez les valeurs d'espace réservé :

kubectl get pods -n istio-system -l istio=ingressgateway

NAME                                   READY   STATUS    RESTARTS   AGE
istio-ingressgateway-xxxx-xxxxx        1/1     Running   0          1m

Étape 2 : Traduire les règles Ingress en VirtualService et DestinationRule Istio

Convertissez chaque ressource Nginx Ingress en une paire de ressources Istio : une Gateway (déjà créée à l'étape 1) et un VirtualService. Si vous avez besoin de politiques de trafic telles que les paramètres de pool de connexions ou la détection des pannes, créez également une DestinationRule.

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: helloworld
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
    - http:
        paths:
          - backend:
              serviceName: helloworld
              servicePort: 80
            path: /helloworld(/|$)(.*)
      host: example.com

apiVersion: networking.istio.io/v1beta1
kind: VirtualService
metadata:
  name: example-vs
spec:
  gateways:
  - istio-system/ingressgateway    # Reference your gateway name
  hosts:
  - example.com
  http:
  - name: route-helloworld
    match:
    - uri:
        prefix: /helloworld/
    - uri:
        prefix: /helloworld
    rewrite:
      uri: /
    route:
    - destination:
        host: helloworld
        port:
          number: 80

kubectl apply -f virtualservice.yaml
kubectl get virtualservice example-vs -o yaml

Étape 3 : Vérifier les configurations

Vérifiez que les configurations sont valides et prennent effet en contrôlant le flux de trafic. Créez une instance CLB, envoyez du trafic vers l'instance CLB et vérifiez si le flux de trafic répond aux attentes. Pour plus d'informations, consultez la section Flux de trafic.

Étape 4 : Transférer progressivement le trafic

Une fois la configuration de routage vérifiée, augmentez progressivement la pondération de la passerelle d'entrée pour migrer le trafic :

1. Commencez par une faible pondération (par exemple, 1) et surveillez les erreurs.

2. Augmentez la pondération par étapes, par exemple 1 -> 10 -> 30 -> 60 -> 100.

3. À chaque étape, vérifiez que la latence, les taux d'erreur et le contenu des réponses restent cohérents.

4. Une fois que tout le trafic passe par la passerelle d'entrée, définissez la pondération du Nginx Ingress Controller sur 0.

Étapes suivantes

Une fois que tout le trafic passe par la passerelle d'entrée ASM :

• Configurez la terminaison TLS sur la passerelle d'entrée ASM

• Configurez la surveillance et la journalisation des accès pour la passerelle d'entrée

• Supprimez le déploiement Nginx Ingress Controller après avoir confirmé la stabilité des opérations

• Explorez les fonctionnalités de gestion du trafic Istio telles que l'injection de fautes, le disjoncteur et les déploiements canaris