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

Créer et associer des adresses EIP avec des annotations

Utilisez des annotations dans le manifeste du pod pour créer une adresse EIP et l'associer au pod. Consultez la section FAQ pour plus de détails sur les annotations.

1. Créez une application et utilisez des annotations pour créer et associer une adresse EIP à un pod.

   Deployment

   Ce manifeste crée un Deployment où ACK attribue automatiquement une instance EIP avec une bande passante maximale de 5 Mbit/s à chaque 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

   Une fois le pod créé, interrogez la ressource podeips.alibabacloud.com portant le même nom que le pod pour afficher les détails de l'adresse EIP attribuée.

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

   Sortie attendue :

   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

   Utilisez le manifeste suivant pour créer un StatefulSet avec deux pods. Une adresse EIP est automatiquement attribuée à chaque pod, et la stratégie de libération est configurée pour supprimer la ressource PodEIP 10 minutes après la suppression du pod correspondant.

   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

   Une fois les pods créés, interrogez les ressources podeips.alibabacloud.com pour suivre les informations relatives aux adresses EIP attribuées.

   kubectl get podeip -n <namespace> -o yaml

   Sortie attendue :

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

   Après la suppression d'un pod dans cette application stateful, sa ressource personnalisée (CR) PodEIP est conservée pendant 10 minutes avant d'être supprimée. Si un pod portant le même nom est créé durant cette période, il réutilise l'adresse EIP correspondante.

2. Vérifiez la configuration.

   Une fois le pod passé à l'état Running, consultez l'annotation k8s.aliyun.com/allocated-eipAddress pour afficher son adresse EIP attribuée et accéder au pod.

1. Déployez la configuration Terway pour prendre en charge la fonctionnalité EIP.

   1. Modifiez le ConfigMap Terway.

      kubectl edit cm eni-config -n kube-system

   2. Dans eni_conf, ajoutez la ligne suivante.

      "enable_eip_pool": "true"

      Remarque

      Pour forcer la dissociation d'une adresse EIP de son instance actuelle lors de son association à une nouvelle instance, ajoutez le paramètre "allow_eip_rob": "true" à eni_conf.

   3. Une fois la modification terminée, appuyez sur la touche Esc, saisissez :wq!, puis appuyez sur la touche Enter pour enregistrer vos modifications et quitter le mode édition.

   4. Recréez les pods Terway pour appliquer les modifications.

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

2. Créez et associez une adresse EIP à un pod à l'aide d'annotations.

   Utilisez des annotations dans le manifeste du pod pour créer une adresse EIP et l'associer au pod. Consultez la rubrique Limites liées aux adresses EIP.

   Attribuer automatiquement une adresse EIP

   Ajoutez ces annotations pour attribuer automatiquement une adresse EIP et spécifier la bande passante :

   • k8s.aliyun.com/pod-with-eip: "true" : attribue une adresse EIP publique dédiée au pod.

   • k8s.aliyun.com/eip-bandwidth: "5" : spécifie la bande passante de l'adresse EIP. La valeur par défaut est 5 Mbit/s.

   Exemple de manifeste :

   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

   Spécifier une adresse EIP

   Important

   • Étant donné qu'une seule adresse EIP ne peut pas être associée à plusieurs pods, cette méthode ne convient pas aux charges de travail telles que Deployments et StatefulSets comportant plus d'un réplica.

   • Par défaut, si l'adresse EIP spécifiée est déjà associée à une instance, l'association échoue. Pour forcer la dissociation de l'adresse EIP de l'instance précédente et son association à la nouvelle, vous devez définir "allow_eip_rob": "true" dans le ConfigMap comme indiqué précédemment.

   • Vous ne pouvez spécifier un ID d'instance EIP que pour des charges de travail à réplica unique. Par exemple, un Deployment ne peut pas comporter plus d'un réplica.

   Ajoutez l'annotation suivante pour spécifier un ID d'instance EIP pour un pod :

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

3. Vérifiez la configuration.

   Une fois le pod passé à l'état Running, consultez l'annotation network.alibabacloud.com/allocated-eipAddress pour afficher son adresse EIP attribuée et accéder au pod.