Container Service for Kubernetes:Melampirkan EIP independen ke pod

Buat dan kaitkan EIP ke pod tertentu menggunakan anotasi

Anda dapat membuat atau mengaitkan EIP ke pod dengan menentukan anotasi di pod tersebut. Untuk informasi selengkapnya tentang anotasi, lihat bagian FAQ dalam topik ini.

1. Buat aplikasi, lalu buat dan kaitkan EIP ke pod tertentu.

   Deployment

   Gunakan contoh berikut untuk membuat deployment. Instans EIP dengan bandwidth 5 Mbit/s dialokasikan secara otomatis 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, Anda dapat mengkueri sumber daya podeips.alibabacloud.com yang memiliki nama sama dengan pod untuk melacak informasi EIP yang dialokasikan.

   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 contoh berikut untuk membuat sumber daya StatefulSet. Dua pod dibuat, dan instans EIP dialokasikan secara otomatis ke setiap pod. Kebijakan pelepasan diatur agar PodEIP dihapus 10 menit setelah pod 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, Anda dapat mengambil informasi EIP yang dialokasikan dari sumber daya podeips.alibabacloud.com yang memiliki nama sama dengan pod.

   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 dari aplikasi berstatus dihapus, sumber daya kustom PodEIP (CR)-nya dipertahankan selama 10 menit sebelum dihapus. Jika pod dengan nama yang sama dibuat selama periode ini, pod tersebut akan menggunakan kembali EIP tersebut.

2. Verifikasi konfigurasi.

   Setelah pod memasuki status Berjalan, Anda dapat memeriksa nilai anotasi k8s.aliyun.com/allocated-eipAddress di pod untuk melihat alamat EIP yang terkait. Anda kemudian dapat mengakses pod menggunakan EIP ini.

   

1. Konfigurasikan Terway untuk mendukung fitur EIP.

   1. Modifikasi ConfigMap Terway.

      kubectl edit cm eni-config -n kube-system

   2. Tambahkan konten berikut ke eni_conf.

      "enable_eip_pool": "true"

      Catatan

      Jika Anda ingin memaksa melepas instans sebelumnya saat menentukan EIP, Anda juga harus menambahkan parameter "allow_eip_rob": "true" ke eni_conf.

   3. Setelah mengubah file, tekan tombol Esc, masukkan :wq!, lalu tekan tombol Enter untuk menyimpan file konfigurasi yang telah dimodifikasi dan keluar dari mode edit.

   4. Buat ulang instans Terway.

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

2. Gunakan anotasi untuk membuat dan mengaitkan EIP ke pod.

   Anda dapat membuat atau mengaitkan EIP ke pod dengan menentukan anotasi di pod tersebut. Untuk informasi selengkapnya tentang batasan EIP, lihat Batasan.

   Konfigurasikan anotasi untuk skenario berbeda sebagai berikut:

   Skenario alokasi EIP otomatis

   Tambahkan anotasi berikut untuk mengalokasikan EIP secara otomatis ke pod dan menentukan bandwidth EIP tersebut.

   • k8s.aliyun.com/pod-with-eip: "true": Mengalokasikan EIP publik independen ke pod target.

   • k8s.aliyun.com/eip-bandwidth: "5": Menentukan bandwidth EIP. Bandwidth default adalah 5 Mbit/s, yang sama dengan nilai default untuk EIP.

   Kode berikut memberikan contoh file YAML.

   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" # Mengalokasikan alamat IP publik secara otomatis ke kontainer Nginx.
           network.alibabacloud.com/eip-bandwidth: "5"   # Menentukan bandwidth EIP. Bandwidth default adalah 5 Mbit/s, yang konsisten dengan nilai default untuk EIP.
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: nginx

   Skenario menentukan EIP

   Penting

   • Satu EIP tidak dapat dikaitkan dengan beberapa pod. Oleh karena itu, skenario ini tidak berlaku untuk deployment dan StatefulSets.

   • Secara default, jika EIP sudah terpasang ke instans, EIP tersebut tidak dapat dipasang ke pod. Jika Anda ingin melepas EIP dari instans sebelumnya sebelum memasangnya ke yang baru, Anda harus mengonfigurasi "allow_eip_rob": "true" di ConfigMap seperti yang dijelaskan pada langkah sebelumnya.

   • Anda hanya dapat menentukan ID instans EIP untuk instans single-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: "<youreipInstanceId>"

3. Verifikasi konfigurasi.

   Setelah pod memasuki status Berjalan, Anda dapat memeriksa nilai anotasi network.alibabacloud.com/allocated-eipAddress di pod untuk melihat alamat EIP yang terkait. Anda kemudian dapat mengakses pod menggunakan EIP ini.