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

Prasyarat

• Anda memiliki Kluster ACK yang dikelola atau Cluster khusus ACK yang menggunakan Terway sebagai plug-in jaringan. Untuk informasi selengkapnya, lihat Buat Kluster ACK yang dikelola dan Buat Cluster khusus ACK (tidak tersedia lagi).

• Anda telah mengonfigurasi izin RAM yang diperlukan untuk EIP.

Dampak

• Jika kluster Anda menggunakan fitur EIP di Terway, gunakan panduan ini untuk memigrasikan pengelolaan EIP ke ack-extend-network-controller.

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

Ikhtisar migrasi

Saat Anda mengaktifkan fitur migrasi EIP di Terway, Terway membuat resource PodEIP untuk setiap EIP yang dikaitkan dengan pod di kluster Anda. PodEIP adalah objek resource yang mengelola informasi EIP untuk suatu pod. Setelah migrasi selesai, ack-extend-network-controller mengambil alih pengelolaan EIP dari Terway.

Untuk mempelajari cara mengaktifkan fitur EIP di Terway, lihat Kasus penggunaan penugasan EIP Otomatis.

Prosedur

1. Pastikan komponen ack-extend-network-controller belum diinstal di kluster Anda. Jika sudah terinstal, uninstal terlebih dahulu.

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

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

   3. Di halaman Helm, periksa apakah ada komponen dengan Release Name ack-extend-network-controller. Jika ada, klik Delete di kolom Actions untuk komponen tersebut agar di-uninstal.

2. Lakukan upgrade plug-in jaringan Terway ke versi v1.6.0 atau lebih baru.

   Untuk instruksi upgrade, lihat Manage components.

3. Ubah ConfigMap Terway untuk mengaktifkan fitur migrasi EIP.

   Penting

   Saat Anda mengaktifkan fitur migrasi EIP di Terway, sistem akan membuat resource PodEIP untuk setiap EIP yang dikaitkan dengan pod. Setelah fitur ini diaktifkan, Terway tidak lagi mengelola EIP tersebut.

   1. Jalankan perintah berikut untuk mengedit ConfigMap Terway:

      kubectl edit cm eni-config -n kube-system

   2. Ubah konfigurasi di bagian eni_conf.

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

      Berikut contoh konfigurasinya. Jangan ubah parameter lainnya.

      # Konten sebelumnya dihilangkan.
        eni_conf: |
          {
            "version": "1",
            "enable_eip_pool": "true",
            "enable_eip_migrate": true,
            "vswitch_selection_policy": "ordered"
          }
      # Konten berikutnya dihilangkan.

   1. Setelah mengubah file konfigurasi, jalankan perintah berikut untuk me-restart pod Terway:

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

      Setelah pod Terway direstart, plug-in secara otomatis memigrasikan EIP di kluster ke ack-extend-network-controller.

4. Periksa status migrasi di log Terway. Output eip migrate finished menunjukkan bahwa migrasi EIP telah selesai.

   1. Jalankan perintah berikut untuk mendapatkan nama pod Terway:

      kubectl get pods -n kube-system | grep terway

      Output akan menampilkan satu atau beberapa nama 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 Anda.

      Output eip migrate finished menunjukkan bahwa migrasi EIP telah selesai.

      Ds:[sg-2ze360hfgjtsemo2wyyj] InstanceID:i-2zed                              5 VSwitchSelectionPolic
      I1013 03:44:40.082505 daemon.go:1596] subSys=network-service eip migrate finished

5. Verifikasi bahwa migrasi telah membuat custom resource (CR) PodEIP di kluster.

   Jalankan perintah berikut untuk mengkueri CR yang telah dimigrasikan. CR tersebut memiliki nama dan namespace yang sama dengan pod yang sesuai.

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

6. Instal ack-extend-network-controller dari Marketplace dan aktifkan fitur EIP. Untuk informasi selengkapnya, lihat Instal ack-extend-network-controller dari Marketplace.

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

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

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

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

   Contoh output:

   Contoh 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: Menentukan metode alokasi statis. Pod menggunakan ID EIP yang ditentukan. Auto: EIP dibuat secara otomatis oleh Terway.
   spec.allocationType.releaseStrategy	Follow: Menunjukkan bahwa EIP dilepas saat Pod dihapus. Artinya, untuk workload tanpa status, asosiasi antara EIP dan Pod tidak perlu dipertahankan. TTL: Menentukan durasi setelah itu EIP dilepas. Ini memungkinkan Anda mempertahankan asosiasi antara EIP dan pod untuk workload stateful.

8. Untuk menonaktifkan fitur EIP di Terway, ikuti langkah-langkah berikut:

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

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

   3. Restart pod Terway.