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

Crear y asociar EIP mediante anotaciones

Utilice las anotaciones del manifiesto del pod para crear una EIP y asociarla al pod. Consulte FAQ para obtener detalles sobre las anotaciones.

1. Cree una aplicación y use anotaciones para generar y vincular una EIP a un pod.

   Deployment

   Este manifiesto crea un Deployment donde ACK asigna automáticamente una instancia de EIP con un ancho de banda máximo de 5 Mbps a 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

   Una vez creado el pod, consulte el recurso podeips.alibabacloud.com que tiene el mismo nombre que el pod para ver los detalles de la EIP asignada.

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

   Salida 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

   Utilice el siguiente manifiesto para crear un StatefulSet con dos pods. Se asigna automáticamente una EIP a cada pod y la estrategia de liberación se configura para eliminar el recurso PodEIP 10 minutos después de borrar el pod correspondiente.

   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

   Después de crear los pods, consulte los recursos podeips.alibabacloud.com para rastrear la información de las EIP asignadas.

   kubectl get podeip -n <namespace> -o yaml

   Salida 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: ""

   Cuando se elimina un pod de esta aplicación con estado, su recurso personalizado (CR) PodEIP se conserva durante 10 minutos antes de borrarse. Si se crea un pod con el mismo nombre durante este periodo, reutilizará la EIP correspondiente.

2. Compruebe la configuración.

   Una vez que el pod entre en estado Running, revise la anotación k8s.aliyun.com/allocated-eipAddress para ver su dirección EIP asignada y acceder al pod.

1. Despliegue la configuración de Terway para admitir la función de EIP.

   1. Edite el ConfigMap de Terway.

      kubectl edit cm eni-config -n kube-system

   2. En eni_conf, agregue la siguiente línea.

      "enable_eip_pool": "true"

      Nota

      Para forzar la desasociación de una EIP de su instancia actual al vincularla con una nueva, agregue el parámetro "allow_eip_rob": "true" en eni_conf.

   3. Al terminar la edición, presione la tecla Esc, escriba :wq! y presione la tecla Enter para guardar los cambios y salir del modo de edición.

   4. Recrea los pods de Terway para aplicar los cambios.

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

2. Cree y asocie una EIP a un pod mediante anotaciones.

   Utilice las anotaciones del manifiesto del pod para crear una EIP y asociarla al pod. Consulte EIP-related limits.

   Asignar automáticamente una EIP

   Agregue estas anotaciones para asignar automáticamente una EIP y especificar el ancho de banda:

   • k8s.aliyun.com/pod-with-eip: "true": Asigna una EIP pública dedicada al pod.

   • k8s.aliyun.com/eip-bandwidth: "5": Especifica el ancho de banda de la EIP. El valor predeterminado es 5 Mbps.

   Manifiesto de ejemplo:

   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

   Especificar una EIP

   Importante

   • Dado que una sola EIP no puede asociarse a múltiples pods, este método no es adecuado para cargas de trabajo como Deployments y StatefulSets que tienen más de una réplica.

   • De forma predeterminada, si la EIP especificada ya está asociada a una instancia, la asociación fallará. Para forzar la desasociación de la EIP de la instancia anterior y vincularla a la nueva, debe establecer "allow_eip_rob": "true" en ConfigMap como se describió anteriormente.

   • Solo puede especificar un ID de instancia de EIP para cargas de trabajo de réplica única. Por ejemplo, un Deployment no puede tener más de una réplica.

   Agregue la siguiente anotación para especificar un ID de instancia de EIP para un pod:

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

3. Compruebe la configuración.

   Una vez que el pod entre en estado Running, revise la anotación network.alibabacloud.com/allocated-eipAddress para ver su dirección EIP asignada y acceder al pod.