Memigrasikan add-on Istio ke Cloud Service Mesh

Langkah-langkah ini khusus untuk penginstalan yang mengidentifikasi bahwa gateway ingress Istio di GKE dikonfigurasi di cluster mereka. Dalam proses ini, Cloud Service Mesh versi 1.18 diinstal dengan bidang kontrol terkelola.

Penting: Jika Anda menginstal Istio versi paket yang disertakan secara default dengan "add-on GKE", Anda harus mengikuti langkah-langkah dalam memigrasikan Istio paket ke Cloud Service Mesh.

Sebelum memulai

• Migrasi dari "add-on Istio" mengharuskan Anda menggunakan Cloud Service Mesh dengan bidang kontrol yang dikelola Google. Oleh karena itu, Bidang kontrol dalam cluster Cloud Service Mesh bukan opsi migrasi yang didukung.

• Anda harus meninjau dan memastikan bahwa Anda memenuhi persyaratan untuk mengupgrade terlebih dahulu.

• Perintah di halaman ini menggunakan variabel lingkungan dan skrip migrasi dari langkah persiapan upgrade.

• Anda harus melakukan setiap langkah proses ini dalam urutan yang ditentukan.

Ringkasan

Secara umum, proses migrasi dari "add-on Istio" ke Cloud Service Mesh dengan bidang kontrol terkelola meliputi:

1. Menginstal bidang kontrol terkelola Cloud Service Mesh.
2. Menggunakan skrip migrasi untuk mengonfigurasi gateway masuk Cloud Service Mesh.

Bermigrasi ke Cloud Service Mesh versi 1.18

Anda harus mengikuti petunjuk mendetail dalam dokumen Cloud Service Mesh "Bermigrasi dari Istio di GKE ke Cloud Service Mesh". Setelah Anda menyelesaikan penginstalan dan telah memigrasikan beban kerja, kembali ke halaman ini untuk menyelesaikan langkah-langkah konfigurasi yang tersisa.

1. Gunakan "Petunjuk migrasi add-on Istio" untuk memigrasikan penginstalan Anda ke Cloud Service Mesh dengan bidang kontrol yang dikelola Google.

   Item utama yang perlu diperhatikan selama proses tersebut:

   • Jika Anda diminta bahwa custom envoy filters are not supported. Cukup pilih "ya" untuk melanjutkan migrasi. Contoh:

     Detected custom envoy filters are not supported by Cloud Service Mesh.
     Please remove these if possible
     NAMESPACE    NAME                                 AGE
     gke-system   allowconnect-cluster-local-gateway   26m
     Continue anyways? [y/N] Y
     

   • Petunjuk migrasi mencakup bagian Menyelesaikan migrasi yang berhasil, yang melakukan langkah-langkah untuk menyelesaikan penginstalan Cloud Service Mesh Anda. Penting: Setelah melakukan langkah-langkah tersebut, Anda tidak akan dapat lagi mengembalikan perubahan.

   Petunjuk migrasi add-on Istio: Bermigrasi dari Istio on GKE ke Cloud Service Mesh

2. Setelah Anda menyelesaikan langkah-langkah migrasi dan telah Memigrasikan workload ke Cloud Service Mesh, jalankan perintah berikut untuk memulai ulang dan memberi label pada pod ingress di namespace knative-serving:

   1. Mulai ulang pod ingress:

      kubectl rollout restart deployment autoscaler activator webhook -n knative-serving
      

   2. Tambahkan label istio: ingressgateway:

      kubectl patch deployment ${INGRESS_NAME} --namespace ${INGRESS_NAMESPACE} --patch  '{"spec": {"template": {"metadata": {"labels": {"istio": "ingressgateway"}}}}}'
      

Mengonfigurasi Ingress Cloud Service Mesh

Di bagian ini, skrip migrasi digunakan untuk menetapkan saluran rilis ke asm-managed-rapid untuk bidang kontrol terkelola Cloud Service Mesh.

Jalankan perintah berikut untuk memulai skrip migrasi:

 ./migration-addon.sh \
 --asm-revision asm-managed-rapid \
 --command set-up-asm-ingress

Langkah berikutnya

Instal komponen fleet

Rollback

Jika Anda perlu mengembalikan perubahan yang Anda lakukan melalui langkah-langkah di atas, Anda dapat:

• Gunakan skrip migrasi untuk menghapus ingress Cloud Service Mesh.
• Rollback penginstalan Cloud Service Mesh.

Untuk mengembalikan penginstalan dan konfigurasi Cloud Service Mesh dengan bidang kontrol yang dikelola Google:

1. Jalankan perintah berikut untuk menghapus ingress Cloud Service Mesh:

   ./migration-addon.sh --command rollback-set-up-asm-ingress
   

   Output terminal selama proses akan terlihat mirip dengan berikut ini:

   Deleting Cloud Service Mesh ingress
   deployment.apps "istio-ingressgateway" deleted
   horizontalpodautoscaler.autoscaling "istio-ingressgateway" deleted
   role.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
   rolebinding.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
   Cloud Service Mesh ingress is successfully deleted.
   

2. Untuk memverifikasi rollback, periksa apakah layanan istio-ingressgateway tidak ada lagi di namespace gke-system:

   kubectl get deployment istio-ingressgateway -n gke-system
   

3. Mengembalikan penginstalan Cloud Service Mesh

4. Jalankan perintah berikut untuk mengaktifkan kembali "Add-on Istio":

   ./migration-addon.sh --command rollback-uninstall-istio-addon
   

5. Untuk terus mengembalikan perubahan ke status awal penginstalan Anda, lakukan rollback add-on Istio.