Container Service for Kubernetes:Menyambungkan EIP independen ke pod

Membuat dan mengaitkan EIP dengan anotasi

Gunakan anotasi manifes pod untuk membuat EIP dan mengaitkannya dengan pod. Lihat FAQ untuk detail anotasi.

1. Buat aplikasi dan gunakan anotasi untuk membuat serta mengaitkan EIP dengan pod.

   Deployment

   Manifes ini membuat Deployment di mana ACK secara otomatis menetapkan instans EIP dengan bandwidth puncak 5 Mbps ke setiap 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

   Setelah pod dibuat, kueri resource podeips.alibabacloud.com yang memiliki nama yang sama dengan pod untuk melihat detail EIP yang ditetapkan.

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

   Output yang diharapkan:

   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

   Gunakan manifes berikut untuk membuat StatefulSet dengan dua pod. EIP ditetapkan secara otomatis ke setiap pod, dan strategi pelepasan diatur untuk menghapus resource PodEIP 10 menit setelah pod yang sesuai dihapus.

   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

   Setelah pod dibuat, kueri resource podeips.alibabacloud.com untuk melacak informasi tentang EIP yang ditetapkan.

   kubectl get podeip -n <namespace> -o yaml

   Output yang diharapkan:

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

   Setelah pod dalam aplikasi stateful ini dihapus, resource kustom PodEIP (CR)-nya dipertahankan selama 10 menit sebelum dihapus. Jika pod dengan nama yang sama dibuat selama periode ini, pod tersebut menggunakan kembali EIP yang sesuai.

2. Verifikasi konfigurasi.

   Setelah pod berada dalam status Running, periksa anotasi k8s.aliyun.com/allocated-eipAddress untuk melihat alamat EIP yang ditetapkan dan mengakses pod.

1. Terapkan konfigurasi Terway untuk mendukung fitur EIP.

   1. Edit ConfigMap Terway.

      kubectl edit cm eni-config -n kube-system

   2. Di eni_conf, tambahkan baris berikut.

      "enable_eip_pool": "true"

      Catatan

      Untuk memaksa memutus kaitan EIP dari instans saat ini saat Anda mengaitkannya dengan yang baru, tambahkan parameter "allow_eip_rob": "true" ke eni_conf.

   3. Setelah selesai mengedit, tekan tombol Esc, ketik :wq!, lalu tekan tombol Enter untuk menyimpan perubahan dan keluar dari mode edit.

   4. Buat ulang pod Terway untuk menerapkan perubahan.

      kubectl delete pod -n kube-system -l app=terway-eniip # Jika Anda menginstal komponen terway-eni, ganti terway-eniip dengan terway-eni.

2. Buat dan kaitkan EIP ke pod menggunakan anotasi.

   Gunakan anotasi manifes pod untuk membuat EIP dan mengaitkannya dengan pod. Lihat Batasan terkait EIP.

   Menetapkan EIP secara otomatis

   Tambahkan anotasi berikut untuk menetapkan EIP secara otomatis dan menentukan bandwidth:

   • k8s.aliyun.com/pod-with-eip: "true": Menetapkan EIP publik khusus ke pod.

   • k8s.aliyun.com/eip-bandwidth: "5": Menentukan bandwidth EIP. Default-nya adalah 5 Mbps.

   Contoh manifes:

   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" # Menetapkan EIP publik secara otomatis ke kontainer Nginx.
           network.alibabacloud.com/eip-bandwidth: "5"   # Menentukan bandwidth EIP. Default-nya adalah 5 Mbps, yang konsisten dengan nilai default EIP.
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx

   Menentukan EIP

   Penting

   • Karena satu EIP tidak dapat dikaitkan dengan beberapa pod, metode ini tidak cocok untuk beban kerja seperti Deployment dan StatefulSet yang memiliki lebih dari satu replika.

   • Secara default, jika EIP yang ditentukan sudah dikaitkan dengan instans, pengaitan akan gagal. Untuk memaksa memutus kaitan EIP dari instans sebelumnya dan mengaitkannya dengan yang baru, Anda harus mengatur "allow_eip_rob": "true" di ConfigMap seperti yang dijelaskan sebelumnya.

   • Anda hanya dapat menentukan ID instans EIP untuk beban kerja satu replika. Misalnya, Deployment tidak boleh memiliki lebih dari satu replika.

   Tambahkan anotasi berikut untuk menentukan ID instans EIP untuk pod:

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

3. Verifikasi konfigurasi.

   Setelah pod berada dalam status Running, periksa anotasi network.alibabacloud.com/allocated-eipAddress untuk melihat alamat EIP yang ditetapkan dan mengakses pod.