Container Service for Kubernetes:Attach an independent EIP to a pod

Crie e associe EIPs com annotations

Use annotations no manifesto do pod para criar um EIP e associá-lo ao pod. Consulte FAQ para detalhes sobre annotations.

1. Crie uma aplicação e use annotations para criar e associar um EIP a um pod.

   Deployment

   Este manifesto cria um Deployment onde o ACK atribui automaticamente uma instância de EIP com largura de banda de pico de 5 Mbps para cada pod.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: example
     labels:
       app: example
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: example
     template:
       metadata:
         labels:
           app: example
         annotations:
           k8s.aliyun.com/pod-with-eip: "true"
           k8s.aliyun.com/eip-bandwidth: "5"
       spec:
         readinessGates:
         - conditionType: "k8s.aliyun.com/eip"
         containers:
         - name: example
           image: nginx

   Após a criação do pod, consulte o recurso podeips.alibabacloud.com que possui o mesmo nome do pod para visualizar os detalhes do EIP atribuído.

   kubectl get podeip -n <namespace> <podname>  -o yaml

   Saída esperada:

   apiVersion: alibabacloud.com/v1beta1
   kind: PodEIP
   metadata:
     creationTimestamp: "2023-12-15T04:25:37Z"
     finalizers:
     - podeip-controller.alibabacloud.com/finalizer
     generation: 1
     name: example-xxx
     namespace: default
     resourceVersion: "222800"
     uid: 43xxx-f1xx-4xxx-b3xx-969faxxx
   spec:
     allocationID: eip-2ze2qe8zsxxx
     allocationType:
       releaseStrategy: Follow
       type: Auto
   status:
     eipAddress: 39.102.XX.XX
     internetChargeType: PayByTraffic
     isp: BGP
     networkInterfaceID: eni-2zeagv8f3xxxx
     podLastSeen: "2023-12-15T05:18:47Z"
     privateIPAddress: 192.168.XX.XX
     resourceGroupID: rg-acfmwxxxxxsq
     status: InUse

   StatefulSet

   Use o seguinte manifesto para criar um StatefulSet com dois pods. Um EIP é atribuído automaticamente a cada pod, e a estratégia de liberação é definida para excluir o recurso PodEIP 10 minutos após a exclusão do pod correspondente.

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: example
     labels:
       app: example
   spec:
     serviceName: "example"
     replicas: 2
     selector:
       matchLabels:
         app: example
     template:
       metadata:
         labels:
           app: example
         annotations:
           k8s.aliyun.com/pod-with-eip: "true"
           k8s.aliyun.com/pod-eip-release-strategy: "10m"
       spec:
         containers:
         - name: example
           image: nginx

   Após a criação dos pods, consulte os recursos podeips.alibabacloud.com para rastrear informações sobre os EIPs atribuídos.

   kubectl get podeip -n <namespace> -o yaml

   Saída esperada:

   apiVersion: v1
   items:
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T03:28:01Z"
       finalizers:
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-0
       namespace: default
       resourceVersion: "227221"
       uid: 79954xx-17xx-4dxx-b7xx-15b84xxx
     spec:
       allocationID: eip-2ze08metxxx
       allocationType:
         releaseAfter: 10m
         releaseStrategy: TTL
         type: Auto
     status:
       eipAddress: 39.105.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2ze4tkg4xxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       resourceGroupID: rg-acfmwxxx
       status: InUse
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T03:28:03Z"
       finalizers:
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-1
       namespace: default
       resourceVersion: "227222"
       uid: 1339xxxe7-97xx-46xx-9bxx-537690xxx
     spec:
       allocationID: eip-2zetwhffqxxx
       allocationType:
         releaseAfter: 10m
         releaseStrategy: TTL
         type: Auto
     status:
       eipAddress: 39.105.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2zeagv8f3wxxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       resourceGroupID: rg-acfmwqnwxxx
       status: InUse
   - apiVersion: alibabacloud.com/v1beta1
     kind: PodEIP
     metadata:
       creationTimestamp: "2023-12-15T04:25:37Z"
       finalizers:
       - podeip-controller.alibabacloud.com/finalizer
       generation: 1
       name: example-5bxxx-9xx
       namespace: default
       resourceVersion: "227220"
       uid: 43cdfxxx-f1xx-42xx-b3xx-969fxxx
     spec:
       allocationID: eip-2ze2qe8zsmnxxx
       allocationType:
         releaseStrategy: Follow
         type: Auto
     status:
       eipAddress: 39.102.XX.XX
       internetChargeType: PayByTraffic
       isp: BGP
       networkInterfaceID: eni-2zeagv8f3wxxx
       podLastSeen: "2023-12-15T05:31:34Z"
       privateIPAddress: 192.168.XX.XX
       publicIpAddressPoolID: pippool-2ze498cxxx
       resourceGroupID: rg-acfmwqnxxx
       status: InUse
   kind: List
   metadata:
     resourceVersion: ""

   Após a exclusão de um pod nesta aplicação stateful, seu recurso personalizado (CR) PodEIP é retido por 10 minutos antes de ser excluído. Se um pod com o mesmo nome for criado durante esse período, ele reutilizará o EIP correspondente.

2. Verifique a configuração.

   Depois que o pod entrar no estado Running, verifique a annotation k8s.aliyun.com/allocated-eipAddress para visualizar o endereço de EIP atribuído e acessar o pod.

1. Implante a configuração do Terway para suportar o recurso de EIP.

   1. Edite o ConfigMap do Terway.

      kubectl edit cm eni-config -n kube-system

   2. Em eni_conf, adicione a seguinte linha.

      "enable_eip_pool": "true"

      Nota

      Para forçar a desassociação de um EIP de sua instância atual ao associá-lo a uma nova, adicione o parâmetro "allow_eip_rob": "true" em eni_conf.

   3. Após concluir a edição, pressione a tecla Esc, insira :wq! e pressione a tecla Enter para salvar as alterações e sair do modo de edição.

   4. Recrie os pods do Terway para aplicar as alterações.

      kubectl delete pod -n kube-system -l app=terway-eniip # If you installed the terway-eni component, replace terway-eniip with terway-eni.

2. Crie e associe um EIP a um pod usando annotations.

   Use annotations no manifesto do pod para criar um EIP e associá-lo ao pod. Consulte Limites relacionados a EIP.

   Automatically assign an EIP

   Adicione estas annotations para atribuir automaticamente um EIP e especificar a largura de banda:

   • k8s.aliyun.com/pod-with-eip: "true": Atribui um EIP público dedicado ao pod.

   • k8s.aliyun.com/eip-bandwidth: "5": Especifica a largura de banda do EIP. O padrão é 5 Mbps.

   Manifesto de exemplo:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment-basic
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         annotations:
           network.alibabacloud.com/pod-with-eip: "true" # Automatically assign a public EIP to the Nginx container.
           network.alibabacloud.com/eip-bandwidth: "5"   # Specify the bandwidth of the EIP. The default is 5 Mbps, which is consistent with the EIP default value.
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx

   Specify an EIP

   Importante

   • Como um único EIP não pode ser associado a múltiplos pods, este método não é adequado para workloads como Deployments e StatefulSets que possuem mais de uma réplica.

   • Por padrão, se o EIP especificado já estiver associado a uma instância, a associação falhará. Para forçar a desassociação do EIP da instância anterior e associá-lo à nova, você deve definir "allow_eip_rob": "true" no ConfigMap conforme descrito anteriormente.

   • Você pode especificar um ID de instância de EIP apenas para workloads de réplica única. Por exemplo, um Deployment não pode ter mais de uma réplica.

   Adicione a seguinte annotation para especificar um ID de instância de EIP para um pod:

   k8s.aliyun.com/pod-eip-instanceid: "<your-eip-instance-id>"

3. Verifique a configuração.

   Depois que o pod entrar no estado Running, verifique a annotation network.alibabacloud.com/allocated-eipAddress para visualizar o endereço de EIP atribuído e acessar o pod.