Langkah-langkah ini khusus untuk penginstalan Istio di GKE, yang juga disebut sebagai "add-on Istio".
Sebelum memulai
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.
Mengidentifikasi apakah add-on Istio sedang digunakan
Ada dua kemungkinan jalur untuk migrasi, bergantung pada apakah fitur injeksi sidecar atau gateway ingress dari add-on Istio digunakan dalam cluster Anda.
Sebelumnya di langkah persiapan, Anda telah mengidentifikasi apakah add-on Istio dikonfigurasi. Anda dapat menjalankan perintah berikut untuk memverifikasi bahwa namespace
istio-system
ada:echo $INGRESS_NAMESPACE
Jalankan perintah berikut untuk menentukan apakah fitur injeksi sidecar dari add-on Istio sedang digunakan dalam cluster Anda:
kubectl get ns -l istio-injection=enabled
Jika ada namespace selain
knative-serving
yang tercantum, hal ini menunjukkan bahwa penyisipan sidecar add-on Istio sedang digunakan.Misalnya, jika perintah hanya mencantumkan namespace
knative-serving
, berarti Anda belum mengonfigurasi dan tidak menggunakan injeksi sidecar add-on Istio.
Hasil:
Salah satu atau keduanya digunakan - Salah satu atau kedua fitur add-on Istio sedang digunakan dalam cluster Anda:
- Layanan ingress
istio-ingressgateway
add-on Istio digunakan. - Injeksi file bantuan add-on Istio digunakan.
Langkah berikutnya: Setelah Anda mengikuti petunjuk di bagian berikutnya untuk meng-uninstal add-on Istio, Anda harus melanjutkan ke panduan Cloud Service Mesh dengan managed control plane.
- Layanan ingress
Tidak digunakan - Baik gateway ingress maupun injeksi sidecar add-on Istio tidak dikonfigurasi untuk digunakan dalam cluster Anda. Dengan kata lain, penginstalan Anda menggunakan "versi Istio yang di-bundle".
Langkah berikutnya: Setelah mengikuti petunjuk di bagian berikutnya untuk meng-uninstal add-on Istio yang tidak digunakan, Anda dapat melanjutkan ke panduan Cloud Service Mesh dengan bidang kontrol dalam cluster.
Meng-uninstal add-on Istio
Di bagian ini, skrip migrasi digunakan untuk meng-uninstal "add-on Istio".
Jalankan perintah berikut untuk memulai skrip migrasi:
./migration-addon.sh --command uninstall-istio-addon
Verifikasi bahwa namespace
istio-system
telah dihapus:kubectl get ns istio-system --ignore-not-found
Langkah berikutnya
Bergantung pada konfigurasi gateway ingress yang Anda identifikasi di atas, lanjutkan ke panduan penginstalan yang sesuai:
Jika Anda mengidentifikasi sebelumnya bahwa satu atau kedua fitur "Add-on Istio" dikonfigurasi dan digunakan dalam cluster Anda, Anda harus melanjutkan ke panduan Cloud Service Mesh dengan managed control plane.
Jika Anda mengidentifikasi sebelumnya bahwa gateway ingress maupun penyisipan sidecar "add-on Istio" tidak digunakan di cluster Anda, maka penginstalan Anda sebenarnya menggunakan "versi Istio yang dibundel". Anda kini dapat melanjutkan untuk menginstal Cloud Service Mesh dengan bidang kontrol dalam cluster.
Rollback
Jika perlu melakukan rollback perubahan yang Anda buat melalui langkah-langkah di atas, Anda dapat menggunakan skrip migrasi untuk mengaktifkan kembali "Add-on Istio":
Jalankan perintah berikut:
./migration-addon.sh --command rollback-uninstall-istio-addon
Untuk terus mengembalikan perubahan ke kondisi awal penginstalan Anda, lakukan rollback pada "add-on" GKE untuk layanan Knative.