Server Load Balancer:Migrate NGINX Ingress to ALB Ingress

Processo de migração

Resolva um nome de domínio tanto para o NGINX Ingress quanto para o ALB Ingress e ajuste os pesos do DNS progressivamente para transferir o tráfego sem interrupções. O diagrama a seguir ilustra o processo. O Migration example abaixo apresenta as etapas detalhadas.

A transferência de tráfego baseada em DNS é uma das abordagens para migração sem downtime. Este processo é fornecido apenas como referência.

Exemplo de migração

O exemplo a seguir percorre a migração com operações específicas.

Uma empresa executa um controlador NGINX Ingress em seu cluster. O service do tipo LoadBalancer voltado para a Internet provisiona automaticamente uma instância CLB voltada para a Internet. O DNS resolve www.example.net para o CLB, que encaminha as requisições para os pods de backend.

Etapa 1: Configure o ALB Ingress

O NGINX Ingress não consegue mais atender aos requisitos de desempenho e gera altos custos de O&M. A empresa usa a ferramenta de migração para converter a configuração do NGINX Ingress para ALB Ingress e adiciona o ALB Ingress ao DNS com um peso menor.

Etapa 2: Transfira o tráfego gradualmente para o ALB Ingress

Após verificar que o ALB Ingress funciona conforme esperado, aumente o peso do DNS para o ALB Ingress a fim de rotear mais tráfego por ele.

Etapa 3: Exclua os recursos do NGINX Ingress

Após migrar todo o tráfego para o ALB Ingress, exclua as entradas DNS do NGINX Ingress, remova os recursos do NGINX Ingress e desinstale o add-on do controlador NGINX Ingress.

Pré-requisitos

Um cliente kubectl está conectado ao cluster ACK. Para mais informações, consulte Connect to an ACK cluster using kubectl.

Etapa 1: Configure o ALB Ingress

1. A ferramenta de migração converte automaticamente os recursos AlbConfig, IngressClass e Ingress. Portanto, ao instale o add-on, selecione None para ALB Instance.

   • ACK: Faça login no console do Container Service for Kubernetes (ACK) e install the ALB Ingress controller add-on no cluster em que deseja realizar a migração.

   • ACS: Faça login no console do Container Compute Service e install the ALB Ingress controller add-on no cluster em que deseja realizar a migração.

   Importante

   Para acessar serviços por meio de um ALB Ingress em um cluster ACK dedicado, conceda permissões ao controlador ALB Ingress antes de implantar os serviços. Grant permissions to the ALB Ingress controller in an ACK dedicated cluster.

2. Crie um arquivo chamado ingress2albconfig.yaml com o seguinte conteúdo.

   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. Execute o comando a seguir para iniciar o Job. O Job converte as configurações existentes do NGINX Ingress em recursos AlbConfig, IngressClass, Ingress e outros, exibindo os resultados nos logs do pod.

   kubectl apply -f ingress2albconfig.yaml

   Saída esperada:

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

4. Visualize o pod pertencente ao Job.

   kubectl get pod -l job-name=ingress2albconfig

   Saída esperada:

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

5. Visualize os logs do pod.

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

   Saída esperada. Implante esses recursos no cluster para configure o 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: {}

Etapa 2: Transfira o tráfego gradualmente para o ALB Ingress

Etapa 3: Exclua os recursos do NGINX Ingress

Após o encerramento de todas as conexões persistentes com o NGINX Ingress e a cessação de novo tráfego direcionado a ele, monitore o sistema por um período adequado ao seu negócio antes de liberar os recursos redundantes.

1. Exclua as entradas DNS relacionadas ao NGINX Ingress pelo console do Alibaba Cloud DNS.

2. Desinstale o add-on do controlador NGINX Ingress.

   1. Faça login no ACK console.

   2. Na página Clusters, clique em no nome do cluster de destino. No painel de navegação à esquerda, escolha Network > Ingresses.

   3. Localize o NGINX Ingress. Na coluna Actions, escolha > Delete. Na caixa de diálogo exibida, clique em Confirm Deletion.

   4. No painel de navegação à esquerda, escolha Add-ons. Clique em na aba Networking. No card NGINX Ingress controller, clique em Uninstall.

   5. Na caixa de diálogo exibida, clique em OK.

      A desinstalação do add-on libera automaticamente a instância CLB utilizada pelo controlador NGINX Ingress, encerrando a cobrança correspondente.

3. Faça login no console do Container Compute Service. No painel de navegação à esquerda, clique em Applications > Helm e desinstale o add-on do controlador NGINX Ingress.

Documentos relacionados

• Configure an ALB instance by using AlbConfig

• Configure an HTTPS certificate for encrypted communication

• ALB Ingress annotations