Todos os produtos
Search
Central de documentação

Elastic Container Instance:Assign an IPv6 address to an Elastic Container Instance-based pod

Última atualização: Sep 21, 2026

Os pods ECI oferecem suporte a IPv4 e IPv6. Para atribuir um endereço IPv6 a um pod, adicione anotações aos metadados do pod durante a criação.

Pré-requisitos

Antes de começar, verifique se você já:

Limitações

  • Um endereço IPv6 por pod: cada pod pode receber apenas um endereço IPv6.

  • Compatibilidade de tipo de instância: todas as instâncias ECI criadas com especificação de contagem de vCPU e tamanho de memória oferecem suporte a IPv6. Para instâncias criadas com especificação de tipos de instância do Elastic Compute Service (ECS), confirme se o tipo de instância selecionado é compatível com IPv6 antes de prosseguir. Consulte Overview of instance families.

  • Anotações válidas somente na criação: as anotações de ECI entram em vigor apenas durante a criação do pod. Adicionar ou modificar anotações durante a atualização de um pod não produz efeito.

Anotações

Adicione anotações à seção metadata da configuração do pod. Em um Deployment, insira-as em spec.template.metadata.annotations.

Anotação

Valor de exemplo

Obrigatório

Descrição

k8s.aliyun.com/eci-enable-ipv6

"true"

Sim

Atribui um endereço IPv6 ao pod

k8s.aliyun.com/eci-ipv6-bandwidth-enable

"true"

Não

Ativa o acesso à Internet via IPv6 para o pod

k8s.aliyun.com/eci-ipv6-bandwidth

200

Não

Define a largura de banda de pico da Internet (Mbit/s) para o endereço IPv6. Intervalo válido: 1–2.000 Mbit/s (pagamento por largura de banda) ou 1–1.000 Mbit/s (pagamento por tráfego). Se omitido, a largura de banda assume o valor máximo compatível com o gateway IPv6.

Atribuir um endereço IPv6

  1. Adicione a anotação obrigatória à configuração do pod. O exemplo a seguir cria um Deployment com IPv6 ativado e acesso à Internet configurado em 100 Mbit/s.

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       name: test
       labels:
         app: test
     spec:
       replicas: 2
       selector:
         matchLabels:
           app: nginx
       template:
         metadata:
           name: nginx-test
           labels:
             app: nginx
             alibabacloud.com/eci: "true"
           annotations:
             k8s.aliyun.com/eci-enable-ipv6: "true"               # Assigns an IPv6 address to the pod.
             k8s.aliyun.com/eci-ipv6-bandwidth-enable: "true"     # Enables Internet access over IPv6.
             k8s.aliyun.com/eci-ipv6-bandwidth: 100M              # Sets the peak Internet bandwidth.
         spec:
           containers:
           - name: nginx
             image: registry.cn-shanghai.aliyuncs.com/eci_open/nginx:1.14.2
             ports:
             - containerPort: 80
  2. Aplique a configuração.

     kubectl apply -f deployment.yaml

Verificar o endereço IPv6

Quando o pod estiver em execução, execute o comando a seguir para visualizar os detalhes do pod:

kubectl describe pod <pod-name>

Localize o campo k8s.aliyun.com/allocated-ipv6Address na seção de anotações. Ele contém o endereço IPv6 atribuído.