Container Service for Kubernetes:Migrasi EIP dari Terway ke ack-extend-network-controller

Prasyarat

• Anda memiliki ACK managed cluster atau ACK dedicated cluster yang menggunakan Terway sebagai plugin jaringan. Untuk informasi lebih lanjut, lihat Create an ACK managed cluster atau Create an ACK dedicated cluster (no longer available for new creation).

• Anda telah mengonfigurasi izin RAM yang diperlukan untuk EIP.

Dampak

• Jika kluster Anda saat ini menggunakan fitur EIP di Terway, ikuti langkah-langkah dalam topik ini untuk memindahkan pengelolaan EIP yang ada ke ack-extend-network-controller.

• Jika kluster Anda tidak menggunakan fitur EIP di Terway, migrasi ini tidak diperlukan.

Migrasi

Saat Anda mengaktifkan fitur migrasi EIP di Terway, sistem akan membuat resource kustom PodEIP untuk setiap EIP yang terkait dengan pod. PodEIP adalah objek resource yang mengelola informasi EIP untuk suatu pod. Setelah Anda mengaktifkan migrasi, Terway berhenti mengelola EIP, dan ack-extend-network-controller mengambil alih tanggung jawab tersebut.

Untuk informasi lebih lanjut tentang cara mengaktifkan fitur EIP di Terway, lihat Automatic EIP allocation.

Prosedur

1. Jika komponen ack-extend-network-controller sudah diinstal, uninstal terlebih dahulu.

   1. Masuk ke ACK console. Di panel navigasi kiri, klik Clusters.

   2. Pada halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Applications > Helm.

   3. Pada halaman Helm, jika terdapat rilis dengan Release Name ack-extend-network-controller, klik Delete pada kolom Actions untuk menguninstalnya.

2. Upgrade plugin jaringan Terway ke versi v1.6.0 atau yang lebih baru.

   Untuk informasi lebih lanjut, lihat Manage components.

3. Ubah file konfigurasi Terway untuk mengaktifkan fitur migrasi EIP.

   1. Jalankan perintah berikut untuk mengedit ConfigMap Terway:

      kubectl edit cm eni-config -n kube-system

   2. Pada bagian eni_conf, ubah konfigurasinya.

      Parameter	Nilai	Deskripsi
      enable_eip_pool	"true"	Jika parameter ini tidak dikonfigurasi atau diatur ke "false", fitur eip tidak diaktifkan, sehingga migrasi tidak diperlukan.
      enable_eip_migrate	true	Atur ke true untuk mengaktifkan fitur migrasi.

      Kode berikut menunjukkan contoh file konfigurasi. Jangan ubah parameter lainnya.

      # Pengaturan lainnya dihilangkan.
        eni_conf: |
          {
            "version": "1",
      
            "enable_eip_pool": "true",
            "enable_eip_migrate": true,
            "vswitch_selection_policy": "ordered"
          }
      # Pengaturan lainnya dihilangkan.

   1. Setelah mengubah file konfigurasi, jalankan perintah berikut untuk membuat ulang pod Terway:

      kubectl delete pod -n kube-system -l app=terway-eniip

      Setelah pod Terway restart, plugin Terway secara otomatis melakukan migrasi EIP.

4. Periksa log Terway untuk memverifikasi status migrasi. Entri log yang berisi eip migrate finished menunjukkan bahwa migrasi telah selesai.

   1. Jalankan perintah berikut untuk mendapatkan nama pod Terway:

      kubectl get pods -n kube-system | grep terway

      Perintah ini mengembalikan nama satu atau beberapa pod Terway.

   2. Jalankan perintah berikut untuk melihat log pod Terway:

      kubectl logs -n kube-system <pod_name> # Ganti <pod_name> dengan nama pod Terway.

      Jika output berisi eip migrate finished, migrasi EIP telah selesai.

      

5. Verifikasi bahwa resource kustom PodEIP (CR) telah dibuat.

   Jalankan perintah berikut untuk mengkueri CR yang telah dimigrasi. Nama dan namespace CR sesuai dengan pod yang bersangkutan.

   kubectl get podeip -n {namespace} {name} # Ganti {namespace} dan {name} dengan namespace dan nama pod yang memiliki EIP.

6. Instal ack-extend-network-controller dari Marketplace dan aktifkan fitur EIP. Untuk informasi lebih lanjut, lihat Install ack-extend-network-controller from the Marketplace.

7. Jalankan perintah berikut untuk memeriksa apakah status CR PodEIP telah diperbarui:

   kubectl get podeip -n {namespace} {name} -o yaml # Ganti {namespace} dan {name} dengan namespace dan nama pod yang memiliki EIP.

   • Jika bidang status tidak kosong, fitur EIP berjalan dengan benar.

   • Jika bidang status kosong, periksa konfigurasi dan log komponen ack-extend-network-controller.

   Berikut ini adalah contoh output:

   Output PodEIP

   apiVersion: alibabacloud.com/v1beta1
   kind: PodEIP
   metadata:
     creationTimestamp: "2023-10-24T08:24:37Z"
     finalizers:
     - podeip-controller.alibabacloud.com/finalizer
     generation: 1
     name: example-xxx-xx
     namespace: default
     resourceVersion: "44013"
     uid: 4744a7af-***-***-ad06-***17aecce
   spec:
     allocationID: eip-xxxxxx
     allocationType:
       releaseStrategy: Follow
       type: Auto
   status:
     eipAddress: 47.XX.XX.XX
     internetChargeType: PayByTraffic
     isp: BGP
     networkInterfaceID: eni-xxxxxxx
     podLastSeen: "2023-10-24T08:31:22Z"
     privateIPAddress: 192.XX.XX.XX
     resourceGroupID: rg-xxxxxx
     status: InUse

   Tabel berikut menjelaskan parameter-parameter tersebut.

   Parameter	Deskripsi
   spec.allocationType.type	Static: EIP ditetapkan secara statis. Pod menggunakan ID EIP tertentu. Auto: EIP ditetapkan secara otomatis. EIP dibuat secara otomatis oleh Terway.
   spec.allocationType.releaseStrategy	Follow: EIP dilepas saat pod dihapus. Cocok untuk beban kerja tanpa status. TTL: EIP dilepas setelah periode waktu hidup (TTL) tertentu setelah pod dihapus. Ini cocok untuk beban kerja stateful yang memerlukan persistensi EIP.

8. Nonaktifkan fitur EIP di Terway.

   1. Atur parameter enable_eip_migrate ke false, atau hapus parameter tersebut.

   2. Atur parameter enable_eip_pool ke "false", atau hapus parameter tersebut.

   3. Restart pod Terway.