Meng-uninstal add-on GKE yang menayangkan Knative

Uninstal "add-on GKE" penayangan Knative dari cluster Anda, termasuk resource dan label terkait.

Dalam tugas ini, skrip migrasi digunakan untuk hanya menghapus "add-on GKE" dari cluster Anda, semua resource penayangan Knative yang ada akan tetap berada di cluster dan terus menayangkan traffic.

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.

Ringkasan

Meng-uninstal add-on GKE mencakup:

1. Memvalidasi bahwa node pool memenuhi persyaratan untuk upgrade.
2. Menerapkan label migrasi dan membuat webhook admisi ValidatingWebhookConfiguration untuk mencegah resource penayangan Knative Anda dihapus di namespace berikut:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Meng-uninstal "add-on GKE", termasuk menghapus label pengelola terkait dari resource penayangan Knative Anda.

   Perhatikan bahwa proses ini dapat berjalan selama lebih dari 10 menit.

4. Menambahkan anotasi appdevexperience-operator.

5. Menghapus resource cloudrun.operator.run.cloud.google.com yang tidak digunakan dengan fleet.

Catatan: Meskipun traffic ke layanan Anda tidak terpengaruh, node panel kontrol GKE ("master") akan diupdate sehingga tidak tersedia untuk sementara selama proses tersebut. Setiap operasi yang memerlukan akses ke bidang kontrol GKE seperti operasi resource Kubernetes seperti penghapusan, pembaruan, atau pembuatan tidak akan terjadi hingga update selesai.

Meng-uninstal add-on GKE yang menayangkan Knative

Di bagian ini, skrip migrasi digunakan untuk meng-uninstal "add-on GKE".

1. Jalankan perintah berikut untuk memulai skrip migrasi:

   ./migration-addon.sh --command uninstall-cloudrun-addon
   

2. Di terminal, skrip migrasi akan meminta konfirmasi Anda untuk melakukan setiap tindakan. Masukkan y untuk memulai proses dan juga untuk melanjutkan di setiap perintah.

   Perintah selama proses penguninstalan "add-on GKE" terlihat mirip dengan berikut ini:

   In this process, the script performs the following:
   1. Validating the node pool to make sure it meets the requirements for
      upgrading. Confirming node pool requirements for
      my-gcp-project/us-central1-c/my-gke-cluster...
   2. Applying the required migration labels
      namespace/knative-serving labeled
   3. Create a ValidatingWebhookConfiguration admission webhook to prevent
      the deletion of resources under the following namespaces:
      knative-serving, cloud-run-system, and gke-system
   Continue? [Y/n] y
   
   validatingwebhookconfiguration.admissionregistration.k8s.io/prevent-deletion-cloud-run-resources created
   ValidatingWebhookConfiguration prevent-deletion-cloud-run-resources for preventing deleting Knative serving resources is effective.
   
   4. Uninstall the Knative serving GKE add-on? Your
   Knative serving resources remain in your cluster.
   Continue? [Y/n] y
   
   Updating my-gke-cluster...
   
   5. Removing the add-on manager labels and adding the Operator related
     annotations. This step will take about 10 minutes.
   
   customresourcedefinition.apiextensions.k8s.io/certificates.networking.internal.knative.dev annotated
   
   6. Clean up unused stale Knative serving operator.
   
   cloudrun.operator.run.cloud.google.com "cloud-run" deleted
   No resources found
   
   Knative serving GKE add-on is successfully uninstalled.
   

3. Pastikan "add-on GKE" adalah disabled dengan menjalankan perintah berikut:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig.disabled)'
   

   True ditampilkan jika "add-on GKE" berhasil dihapus dari cluster Anda.

Langkah selanjutnya

Bermigrasi ke Cloud Service Mesh

Rollback

Jika perlu melakukan rollback pada perubahan yang Anda buat melalui langkah-langkah di atas, Anda dapat menggunakan skrip migrasi untuk:

• Aktifkan kembali "add-on GKE" penayangan Knative.
• Hapus webhook izin ValidatingWebhookConfiguration.

Untuk memulai proses rollback:

1. Jalankan perintah berikut untuk memulai skrip migrasi:

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

2. Di terminal, skrip migrasi akan meminta konfirmasi Anda untuk melakukan setiap tindakan. Masukkan y pada setiap perintah untuk melanjutkan.

   Perintah selama proses pengaktifan ulang "add-on GKE" terlihat mirip dengan berikut ini:

   In this step, the script performs the following:
     1. Enable Knative serving GKE add-on
     2. Remove the ValidatingWebhookConfiguration added for uninstalling addon
   Continue? [Y/n] Y
   
   1. Enable Knative serving GKE add-on?
   Continue? [Y/n] Y
   
   Updating my-gke-cluster...done.
   Knative serving GKE add-on is enabled
   
   2. Remove the ValidatingWebhookConfiguration added for uninstalling addon?
   Continue? [Y/n] Y
   
   Removing the ValidatingWebhookConfiguration used to prevent deletion
   

3. Pastikan penayangan Knative "add-on GKE" diaktifkan kembali:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig)'
   

   Jika add-on berjalan di cluster Anda, detail konfigurasi untuk add-on akan ditampilkan. Contoh:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL