Container Service for Kubernetes:Migrar EIPs do Terway para ack-extend-network-controller

O recurso de EIP do Terway foi descontinuado e não recebe mais manutenção. Utilize o add-on ack-extend-network-controller para gerenciar EIPs. Este tópico orienta você na migração de EIPs do Terway para o ack-extend-network-controller sem interromper os serviços.

Pré-requisitos

• É necessário ter um cluster gerenciado pelo ACK ou um cluster dedicado do ACK com o Terway como plugin de rede. Consulte Criar um cluster gerenciado pelo ACK e Criar um cluster dedicado do ACK (não mais disponível).

• Você configurou as permissões de RAM necessárias para EIPs.

Impacto

• Caso seu cluster utilize EIPs do Terway, siga este guia para migrar para o ack-extend-network-controller.

• Se o seu cluster não usar EIPs do Terway, ignore esta migração.

Visão geral da migração

Ao ativar a migração de EIP no Terway, ele cria um resource PodEIP para cada EIP associado a um pod. O PodEIP gerencia as informações de EIP desse pod. Após a migração, o ack-extend-network-controller assume o gerenciamento dos EIPs.

Para ativar o recurso de EIP no Terway, consulte Casos de uso de atribuição automática de EIP.

Procedimento

1. Verifique se o ack-extend-network-controller está instalado no seu cluster. Em caso afirmativo, desinstale-o.

   1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

   2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Applications > Helm.

   3. Na página Helm, localize o Release Name ack-extend-network-controller. Se existir, clique em Delete na coluna Actions para desinstalá-lo.

2. Atualize o plugin de rede Terway para a versão v1.6.0 ou posterior.

   Consulte Gerenciar componentes.

3. Modifique o ConfigMap do Terway para ativar a migração de EIP.

   Importante

   Ao ativar a migração de EIP, o Terway cria um resource PodEIP para cada EIP associado a um pod e deixa de gerenciar os EIPs.

   1. Edite o ConfigMap do Terway:

      kubectl edit cm eni-config -n kube-system

   2. Altere a configuração em eni_conf.

      Parâmetro	Valor	Descrição
      enable_eip_pool	"true"	Se não estiver configurado ou definido como "false", o recurso eip não estará ativado e nenhuma migração será necessária.
      enable_eip_migrate	true	Defina como true para ativar a migração.

      Exemplo de configuração. Não modifique outros parâmetros.

      # The preceding content is omitted.
        eni_conf: |
          {
            "version": "1",
            "enable_eip_pool": "true",
            "enable_eip_migrate": true,
            "vswitch_selection_policy": "ordered"
          }
      # The following content is omitted.

   1. Após modificar a configuração, reinicie os pods do Terway:

      kubectl delete pod -n kube-system -l app=terway-eniip

      Depois que os pods forem reiniciados, o Terway migra automaticamente os EIPs do cluster para o ack-extend-network-controller.

4. Verifique o status da migração nos logs do Terway. A saída eip migrate finished indica sucesso.

   1. Obtenha os nomes dos pods do Terway:

      kubectl get pods -n kube-system | grep terway

      A saída lista os nomes dos pods do Terway.

   2. Visualize os logs de um pod do Terway:

      kubectl logs -n kube-system <pod_name> # Replace <pod_name> with the name of your Terway pod.

      A presença de eip migrate finished na saída confirma que a migração foi concluída.

      Ds:[sg-2ze360hfgjtsemo2wyyj] InstanceID:i-2zed                              5 VSwitchSelectionPolic
      I1013 03:44:40.082505 daemon.go:1596] subSys=network-service eip migrate finished

5. Confirme se os custom resources (CRs) PodEIP foram criados no cluster.

   Consulte um CR migrado. Cada CR compartilha o nome e o namespace do seu pod correspondente.

   kubectl get podeip -n {namespace} {name} # Replace {namespace} and {name} with the namespace and name of the pod associated with an EIP.

6. Instale o ack-extend-network-controller pelo Marketplace e ative o recurso de EIP. Consulte Instalar ack-extend-network-controller pelo Marketplace.

7. Verifique se o status do resource PodEIP foi atualizado:

   kubectl get podeip -n {namespace} {name} -o yaml # Replace {namespace} and {name} with the namespace and name of the pod associated with an EIP.

   • Um campo status não vazio indica que a função de EIP está operando corretamente.

   • Um campo status vazio indica um problema. Verifique a configuração e os logs do ack-extend-network-controller.

   Exemplo de saída:

   Exemplo de saída PodEIP

   apiVersion: alibabacloud.com/v1beta1
   kind: PodEIP
   metadata:
     creationTimestamp: "2023-10-24T08:24:37Z"
     finalizers:
     - podeip-controller.alibabacloud.com/finalizer
     generation: 1
     name: example-xxx-xx
     namespace: default
     resourceVersion: "44013"
     uid: 4744a7af-***-***-ad06-***17aecce
   spec:
     allocationID: eip-xxxxxx
     allocationType:
       releaseStrategy: Follow
       type: Auto
   status:
     eipAddress: 47.XX.XX.XX
     internetChargeType: PayByTraffic
     isp: BGP
     networkInterfaceID: eni-xxxxxxx
     podLastSeen: "2023-10-24T08:31:22Z"
     privateIPAddress: 192.XX.XX.XX
     resourceGroupID: rg-xxxxxx
     status: InUse

   Parâmetros:

   Parâmetro	Descrição
   spec.allocationType.type	Static: O pod utiliza um ID de EIP especificado. Auto: O Terway cria o EIP automaticamente.
   spec.allocationType.releaseStrategy	Follow: O EIP é liberado quando o pod é excluído. Para cargas de trabalho stateless, a associação entre EIP e pod não é mantida. TTL: O EIP é liberado após uma duração especificada. Utilize esta opção para manter a associação entre EIP e pod em cargas de trabalho stateful.

8. Para desativar o recurso de EIP no Terway:

   1. Defina enable_eip_migrate como false ou exclua esse parâmetro.

   2. Defina enable_eip_pool como "false" ou exclua esse parâmetro.

   3. Reinicie os pods do Terway.