Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Configure a filter for ENIs

Última atualização: Jun 27, 2026

No modo Terway, o Terway gerencia as ENIs do nó por padrão. Se você precisar gerenciar algumas ENIs manualmente, configure um filtro de tag para que o Terway administre apenas as interfaces correspondentes ao filtro e evite conflitos. Este tópico explica como configurar um filtro de ENI para o Terway.

Pré-requisitos

  • Um cluster ACK gerenciado com o plug-in de rede Terway foi criado.

  • As ENIs de destino têm as tags necessárias configuradas. O Terway ignora ENIs sem tags.

Aviso

Operação de alto risco. Não prossiga até compreender e validar totalmente todas as etapas.

Limitações

  • O Terway 1.5.5 ou posterior é obrigatório. Consulte Gerencie componentes para atualizar.

  • Compatível apenas com nós ECS, não com nós Lingjun.

Procedimento

  1. Modifique o arquivo de configuração do Terway.

    kubectl edit cm -n kube-system eni-config
  2. Em eni_conf, adicione o filtro de tag.

     "eni_tag_filter":  { "creator": "terway" }

    "eni_tag_filter" especifica um filtro de tag. Neste exemplo, { "creator": "terway" } instrui o Terway a gerenciar apenas as ENIs com essa tag.

    Exemplo:

     eni_conf: |
        {
          "eni_tag_filter":  { "creator": "terway" },
          "ip_stack": "ipv4",
          "vswitch_selection_policy": "ordered"
         }
    Importante

    Verifique se as ENIs de destino têm as tags esperadas. O Terway exclui interfaces sem tags do gerenciamento.

    Consulte Gerencie ENIs usando tags.

    Para aplicar tags automaticamente às ENIs durante a criação, consulte Personalizar parâmetros do Terway.

  3. Reinicie o Terway para aplicar a configuração.

    kubectl delete pod -nkube-system -l app=terway-eniip

    Saída esperada:

    pod "terway-eniip-XXX" deleted
  4. Verifique se a configuração foi aplicada.

    1. Verifique o status do pod terway-eniip.

      kubectl get pods -n kube-system -l app=terway-eniip

      Saída esperada:

      NAME                 READY   STATUS    RESTARTS   AGE
      terway-eniip-XXX   2/2     Running   0          19h
    2. Visualize a configuração do Terway.

      kubectl logs -nkube-system terway-eniip-XXX
      # Or
      kubectl logs -nkube-system terway-eniip-XXX -c terway-init

      Se a saída contiver o trecho a seguir, a configuração foi aplicada:

      # ENITagFilter specifies the network interface tag filter. creator:terway matches only the network interfaces created by Terway.
      ENITagFilter:map[creator:terway]
  5. Adicione um novo nó ou readicione um existente para aplicar a configuração.