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

Fitur alamat IP elastis (EIP) dari plugin jaringan Terway sudah tidak digunakan lagi. Untuk menggunakan EIP, gunakan komponen ack-extend-network-controller. Topik ini menjelaskan cara memigrasikan EIP dari Terway ke ack-extend-network-controller.

Prasyarat

Sebuah ACK managed cluster atau ACK dedicated cluster telah dibuat dan klaster tersebut menggunakan Terway sebagai plugin jaringan. Untuk informasi lebih lanjut, lihat Buat ACK managed cluster atau Buat ACK dedicated cluster.
Izin Resource Access Management (RAM) diberikan untuk menggunakan EIP.

Dampak

Penting

Migrasi ini tidak mengubah informasi EIP atau memengaruhi bisnis Anda.

Jika klaster Anda menggunakan fitur EIP dari Terway, Anda dapat memigrasikan sumber daya yang dialokasikan ke pengontrol EIP dari ack-extend-network-controller dan kemudian memigrasikan EIP.
Jika klaster Anda tidak menggunakan fitur EIP dari Terway, Anda tidak perlu melakukan operasi ini.

Catatan Penggunaan

Setelah Anda mengaktifkan fitur migrasi EIP untuk Terway, Terway membuat PodEIP CustomResource (CR) untuk setiap EIP pod di dalam klaster. PodEIP adalah CustomResourceDefinition (CRD) yang digunakan untuk mengelola informasi EIP terkait pod. Setelah migrasi EIP diaktifkan, Terway tidak lagi mengelola EIP. EIP dikelola oleh ack-extend-network-controller.

Untuk informasi lebih lanjut tentang cara mengaktifkan fitur EIP untuk Terway, lihat bagian Secara otomatis buat dan asosiasikan EIP dengan pod dari topik "Asosiasikan EIP eksklusif dengan pod".

Prosedur

Pastikan bahwa komponen ack-extend-network-controller belum diinstal di dalam klaster. Jika ack-extend-network-controller sudah diinstal, uninstall terlebih dahulu.
1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.
2. Di halaman Clusters, temukan klaster yang diinginkan dan klik namanya. Di panel navigasi kiri, pilih Applications > Helm.
3. Di halaman Helm, periksa apakah ada komponen dengan Release Name ack-extend-network-controller. Jika ack-extend-network-controller ada, klik Delete di kolom Actions dari ack-extend-network-controller untuk menguninstall komponen tersebut.
Perbarui Terway ke v1.6.0 atau versi lebih baru.
Untuk informasi lebih lanjut tentang cara memperbarui Terway, lihat Kelola komponen.

Modifikasi ConfigMap Terway untuk mengaktifkan fitur migrasi EIP.

Penting

Setelah Anda mengaktifkan fitur migrasi EIP untuk Terway, Terway membuat PodEIP CR untuk setiap EIP pod di dalam klaster. Setelah migrasi EIP diaktifkan, Terway tidak lagi mengelola EIP.

Jalankan perintah berikut untuk memodifikasi ConfigMap Terway:
```
kubectl edit cm eni-config -n kube-system
```

Ubah parameter berikut di dalam ConfigMap eni_conf:

Parameter	Nilai	Deskripsi
`enable_eip_pool`	"true"	Jika parameter ini tidak ditentukan atau diatur ke `false`, fitur `EIP` dinonaktifkan dan Anda tidak perlu memigrasikan EIP.
`enable_eip_migrate`	true	Jika parameter ini diatur ke `true`, fitur migrasi diaktifkan.

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

# Isi sebelumnya dihilangkan. 
  eni_conf: |
    {
      "version": "1",

      "enable_eip_pool": "true",
      "enable_eip_migrate": true,
      "vswitch_selection_policy": "ordered"
    }
# Isi berikutnya dihilangkan.

Setelah Anda mengonfigurasi ConfigMap, jalankan perintah berikut untuk membuat ulang pod Terway:
```
kubectl delete pod -n kube-system -l app=terway-eniip
```
Setelah pod Terway yang dibuat ulang dimulai, Terway secara otomatis memigrasikan EIP di dalam klaster ke ack-extend-network-controller.

Anda dapat memeriksa kemajuan migrasi di log Terway. Jika EIP dimigrasikan, eip migrate finished akan dikembalikan.
1. Jalankan perintah berikut untuk menanyakan nama pod Terway:
```
kubectl get pods -n kube-system | grep terway
```
  Satu atau lebih nama pod Terway akan dikembalikan.
2. Jalankan perintah berikut untuk menampilkan log pod Terway:
```
kubectl logs -n kube-system <pod_name> # Ganti <pod_name> dengan nama pod Terway.
```
  Jika eip migrate finished dikembalikan, semua EIP telah dimigrasikan.
Periksa apakah PodEIP CR dibuat di dalam klaster.
Jalankan perintah berikut untuk menanyakan PodEIP CR. PodEIP CR menggunakan nama dan namespace yang sama dengan pod.
```
kubectl get podeip -n {namespace} {name} # Ganti {namespace} dan {name} dengan namespace dan nama pod yang terkait dengan EIP.
```
Di halaman Marketplace, instal ack-extend-network-controller dan aktifkan fitur EIP feature. Untuk informasi lebih lanjut, lihat Instal ack-extend-network-controller dari marketplace.

Jalankan perintah berikut untuk memeriksa apakah status PodEIP CR diperbarui:

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

Jika bidang status tidak kosong, fitur EIP berfungsi seperti yang diharapkan.
Jika bidang status kosong, periksa konfigurasi dan log dari ack-extend-network-controller.

Output yang diharapkan:

Status PodEIP CR

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`: Mengalokasikan EIP dengan ID tertentu ke pod. `Auto`: Secara otomatis mengalokasikan EIP ke pod. EIP dibuat oleh Terway.
spec.allocationType.releaseStrategy	`Follow`: Melepaskan EIP saat pod dihapus. Jika pod dibuat oleh Deployment, Anda tidak perlu menyimpan EIP untuk pod tersebut. `TTL`: Melepaskan EIP dengan penundaan setelah pod dihapus. Jika pod dibuat oleh StatefulSet, Anda perlu menyimpan EIP untuk pod tersebut selama periode waktu tertentu.

Lakukan operasi berikut untuk menonaktifkan fitur EIP untuk 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. Mulai ulang pod Terway.