Server Load Balancer:Migrer NGINX Ingress vers ALB Ingress

Processus de migration

Faites pointer un nom de domaine à la fois vers NGINX Ingress et ALB Ingress, puis ajustez progressivement les pondérations DNS pour transférer le trafic de manière transparente. Le schéma suivant illustre ce processus. L'exemple de Migration example ci-dessous fournit des étapes détaillées.

La répartition du trafic basée sur le DNS est l'une des approches permettant une migration sans interruption. Ce processus est fourni à titre indicatif uniquement.

Exemple de migration

L'exemple suivant détaille la migration à travers des opérations spécifiques.

Une entreprise exécute un contrôleur NGINX Ingress dans son cluster. Le service de type LoadBalancer orienté Internet du contrôleur provisionne automatiquement une instance CLB orientée Internet. Le DNS résout www.example.net vers le CLB, qui transfère les requêtes aux pods backend.

Étape 1 : Configurer ALB Ingress

NGINX Ingress ne répond plus aux exigences de performance et engendre des coûts d'exploitation et de maintenance élevés. L'entreprise utilise l'outil de migration pour convertir la configuration NGINX Ingress en ALB Ingress et ajoute ALB Ingress au DNS avec une pondération inférieure.

Étape 2 : Transférer progressivement le trafic vers ALB Ingress

Après avoir vérifié qu'ALB Ingress fonctionne comme prévu, augmentez la pondération DNS d'ALB Ingress pour acheminer davantage de trafic via celui-ci.

Étape 3 : Supprimer les ressources NGINX Ingress

Une fois tout le trafic migré vers ALB Ingress, supprimez les entrées DNS de NGINX Ingress, retirez les ressources NGINX Ingress et désinstallez le module complémentaire du contrôleur NGINX Ingress.

Prérequis

Un client kubectl est connecté au cluster ACK. Pour plus d'informations, consultez la rubrique Connect to an ACK cluster using kubectl.

Étape 1 : Configurer ALB Ingress

1. L'outil de migration convertit automatiquement les ressources AlbConfig, IngressClass et Ingress. Par conséquent, lors de l'installation du module complémentaire, sélectionnez None pour ALB Instance.

   • ACK : Connectez-vous à la Container Service for Kubernetes (ACK) console et install the ALB Ingress controller add-on dans le cluster où vous souhaitez effectuer la migration.

   • ACS : Connectez-vous à la Container Compute Service console et install the ALB Ingress controller add-on dans le cluster où vous souhaitez effectuer la migration.

   Important

   Pour accéder aux services via ALB Ingress dans un ACK dedicated cluster, accordez les autorisations au contrôleur ALB Ingress avant de déployer les services. Consultez la rubrique Grant permissions to the ALB Ingress controller in an ACK dedicated cluster.

2. Créez un fichier nommé ingress2albconfig.yaml avec le contenu suivant.

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: ingress2albconfig
     namespace: default
   spec:
     template:
       spec:
         containers:
         - name: ingress2albconfig
           image: registry-cn-hangzhou.ack.aliyuncs.com/acs/ingress2albconfig:0.0.2
           command: ["/bin/ingress2albconfig", "print", "-A"]
         restartPolicy: Never
         serviceAccount: ingress2albconfig
         serviceAccountName: ingress2albconfig
     backoffLimit: 4
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: system:ingress2albconfig
   rules:
   - apiGroups:
     - networking.k8s.io
     resources:
     - ingresses
     - ingressclasses
     verbs:
     - get
     - list
     - watch
     - update
     - create
     - patch
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: ingress2albconfig
     namespace: default
   ---
   kind: ClusterRoleBinding
   apiVersion: rbac.authorization.k8s.io/v1
   metadata:
     name: system:ingress2albconfig
   roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: system:ingress2albconfig
   subjects:
     - kind: ServiceAccount
       name: ingress2albconfig
       namespace: default

3. Exécutez la commande suivante pour démarrer le Job. Le Job convertit les configurations NGINX Ingress existantes en ressources AlbConfig, IngressClass, Ingress et autres, et affiche les résultats dans les journaux du pod.

   kubectl apply -f ingress2albconfig.yaml

   Sortie attendue :

   job.batch/ingress2albconfig created
   clusterrole.rbac.authorization.k8s.io/system:ingress2albconfig created
   serviceaccount/ingress2albconfig created
   clusterrolebinding.rbac.authorization.k8s.io/system:ingress2albconfig created

4. Consultez le pod appartenant au Job.

   kubectl get pod -l job-name=ingress2albconfig

   Sortie attendue :

   NAME                READY   STATUS      RESTARTS   AGE
   ingress2albconfig-vw***   0/1     Completed   0          16m

5. Consultez les journaux du pod.

   kubectl logs ingress2albconfig-vw*** # Replace this with the pod name from the previous step.

   Sortie attendue. Déployez ces ressources dans le cluster pour configurer ALB Ingress.

   apiVersion: alibabacloud.com/v1
   kind: AlbConfig
   metadata:
     name: from-nginx
   spec:
     config:
       accessLogConfig: {}
       edition: Standard
       name: from-nginx
       tags:
       - key: converted/ingress2albconfig
         value: "true"
       zoneMappings:
       - vSwitchId: vsw-xxx # Replace this with the ID of a vSwitch in your VPC.
       - vSwitchId: vsw-xxx # Replace this with the ID of a vSwitch in your VPC.
     listeners:
     - port: 80
       protocol: HTTP
   ---
   apiVersion: networking.k8s.io/v1
   kind: IngressClass
   metadata:
     name: from-nginx
   spec:
     controller: ingress.k8s.alibabacloud/alb
     parameters:
       apiGroup: alibabacloud.com
       kind: AlbConfig
       name: from-nginx
   ---
   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       alb.ingress.kubernetes.io/listen-ports: '[{"HTTP":80}]'
     name: from-ingress1
     namespace: default
   spec:
     ingressClassName: from-nginx
     rules:
     - http:
         paths:
         - backend:
             service:
               name: nginx-svc-g1msr
               port:
                 number: 80
           path: /
           pathType: Prefix
   status:
     loadBalancer: {}

Étape 2 : Transférer progressivement le trafic vers ALB Ingress

Étape 3 : Supprimer les ressources NGINX Ingress

Une fois toutes les connexions persistantes vers NGINX Ingress fermées et aucun nouveau trafic ne l'atteignant, surveillez le système pendant une période adaptée à votre activité avant de libérer les ressources redondantes.

1. Supprimez les entrées DNS liées à NGINX Ingress depuis la Alibaba Cloud DNS console.

2. Désinstallez le module complémentaire du contrôleur NGINX Ingress.

   1. Connectez-vous à la ACK console.

   2. Sur la page Clusters, cliquez sur le nom du cluster cible. Dans le volet de navigation de gauche, choisissez Network > Ingresses.

   3. Recherchez NGINX Ingress. Dans la colonne Actions, choisissez > Delete. Dans la boîte de dialogue qui s'affiche, cliquez sur Confirm Deletion.

   4. Dans le volet de navigation de gauche, choisissez Add-ons. Cliquez sur l'onglet Networking. Sur la carte NGINX Ingress controller, cliquez sur Uninstall.

   5. Dans la boîte de dialogue qui s'affiche, cliquez sur OK.

      La désinstallation du module complémentaire libère automatiquement l'instance CLB utilisée par le contrôleur NGINX Ingress, ce qui n'engendrera plus de frais.

3. Connectez-vous à la Container Compute Service console. Dans le volet de navigation de gauche, cliquez sur Applications > Helm et désinstallez le module complémentaire du contrôleur NGINX Ingress.

Documents connexes

• Configure an ALB instance by using AlbConfig

• Configure an HTTPS certificate for encrypted communication

• ALB Ingress annotations