Meng-uninstal Config Sync

Halaman ini menunjukkan cara meng-uninstal Config Sync dari cluster Anda, menonaktifkan fitur fleet Config Management di armada Anda, dan uninstal ConfigManagement Operator.

Halaman ini ditujukan untuk admin IT dan Operator yang mengelola siklus hidup infrastruktur teknologi yang mendasarinya. Untuk mempelajari lebih lanjut tentang peran dan contoh tugas yang kami rujuk dalam konten Google Cloud, lihat Peran dan tugas pengguna GKE Enterprise yang umum.

Fitur fleet Config Management mengelola Config Sync, Pengontrol Kebijakan, dan Pengontrol Hierarki menggunakan Operator ConfigManagement. Karena arsitektur ini, langkah-langkah uninstal harus diselesaikan di urutan berikut:

1. Meng-uninstal Config Sync dari cluster Anda
2. Menonaktifkan fitur Config Management di perangkat Anda
3. Meng-uninstal Operator ConfigManagement dari cluster Anda

Catatan: Jika Anda menggunakan Pengontrol Konfigurasi untuk menginstal dan mengelola Sinkronisasi Konfigurasi, jangan gunakan petunjuk pada halaman ini. Sebagai gantinya, ikuti petunjuk di Menghapus instance Pengontrol Konfigurasi Anda untuk meng-uninstal Config Controller.

Meng-uninstal Config Sync dari cluster Anda

Catatan: Meng-uninstal Config Sync akan menghapus semua RootSync dan RepoSync objek pada cluster. Sebelum melanjutkan, Anda harus memeriksa penghapusan kebijakan propagasi pada objek RootSync dan RepoSync. Untuk selengkapnya informasi, lihat Hapus objek secara massal.

Konsol

Anda tidak dapat meng-uninstal Config Sync hanya dengan Konsol Google Cloud. Gunakan Google Cloud CLI saja.

gcloud

1. Buka manifes applySpec yang Anda buat selama penginstalan dengan Google Cloud CLI.

2. Dalam manifes applySpec, tetapkan spec.configSync.enabled ke false:

   applySpecVersion: 1
   spec:
     configSync:
       enabled: false
   ...
   

3. (hanya diperlukan untuk cluster yang menggunakan Config Sync upgrade otomatis) Dalam manifes applySpec, setel spec.upgrades ke auto:

   Catatan: kolom spec.upgrades didukung dalam versi Google Cloud CLI 471.0.0 dan yang lebih baru. Anda dapat mengupdate Google Cloud CLI ke lainnya dengan menjalankan perintah gcloud components update.

   applySpecVersion: 1
   spec:
     upgrades: auto
     configSync:
       enabled: false
   ...
   

4. Terapkan perubahan:

     gcloud beta container fleet config-management apply \
         --membership=MEMBERSHIP_NAME \
         --config=CONFIG_YAML \
         --project=PROJECT_ID
   

   Ganti kode berikut:

   • MEMBERSHIP_NAME: menambahkan cluster terdaftar yang ingin Anda menerapkan konfigurasi ini. Jika Anda mendaftarkan cluster di Konsol Google Cloud, nama keanggotaan sama dengan nama .

   • CONFIG_YAML: menambahkan jalur ke file apply-spec.yaml.

   • PROJECT_ID: tambahkan project ID Anda.

Terraform

Jika Anda menggunakan Terraform untuk menginstal Config Sync menggunakan gke_hub_feature_membership referensi dari Penyedia Google Cloud Platform, lalu perbarui resource tersebut untuk meng-uninstal Config Sync.

1. Mengidentifikasi resource gke_hub_feature_membership di Terraform Anda file konfigurasi yang berisi argumen configmanagement.

2. Update resource gke_hub_feature_membership untuk menghapus Argumen config_sync dari configmanagement.

   Contoh:

   resource "google_gke_hub_feature_membership" "feature_member" {
     location = "global"
     feature = google_gke_hub_feature.feature.name
     membership = google_gke_hub_membership.membership.membership_id
     membership_location = google_gke_hub_membership.membership.location
     configmanagement {
       version = "1.17.0"
     }
   }
   

3. Terapkan konfigurasi Terraform:

   terraform apply
   

   Konfirmasi bahwa Anda ingin menerapkan tindakan yang dijelaskan dengan memasukkan yes.

Config Connector

Jika Anda menggunakan Konektor Konfigurasi untuk menginstal Config Sync menggunakan GKEHubFeatureMembership resource, lalu perbarui resource tersebut untuk meng-uninstal Config Sync.

1. Identifikasi objek resource GKEHubFeatureMembership di cluster Anda yang memiliki kolom .spec.configmanagement.configSync.

2. Tambahkan patch objek resource GKEHubFeatureMembership untuk menghapus Kolom .spec.configmanagement.configSync dengan menyetelnya ke null:

   kubectl patch GKEHubFeatureMembership FEATURE_MEMBERSHIP_OBJECT_NAME \
       --namespace FEATURE_MEMBERSHIP_OBJECT_NAMESPACE \
       -p '{"spec":{"configmanagement":{"configSync": null}}}'
   

   Ganti kode berikut:

   • FEATURE_MEMBERSHIP_OBJECT_NAME: tambahkan nama Objek resource GKEHubFeatureMembership yang telah Anda buat sebelumnya.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: menambahkan namespace yang berisi objek resource GKEHubFeatureMembership yang dibuat sebelumnya.

Nonaktifkan Config Management di perangkat Anda

Catatan: Jika Anda masih ingin menggunakan Config Management pada cluster lain di Armada, Anda dapat melewatkan langkah ini, tetapi Anda tidak akan dapat menghapus ConfigManagement Operator hingga fitur Config Management dinonaktifkan di fleet atau cluster akan dihapus dari fleet.

Konsol

1. Di konsol Google Cloud, buka halaman Feature Manager.

   Buka Feature Manager

2. Di baris Config Management pada tabel Features, klik Detail. Halaman Ringkasan status akan muncul.

3. Klik Disable Config Management. Halaman konfirmasi akan muncul.

4. Di halaman konfirmasi, klik Disable Config Management.

gcloud

1. Untuk menonaktifkan Config Management di semua cluster dalam fleet, jalankan perintah berikut:

   gcloud beta container fleet config-management disable
   

   Catatan: Perintah sebelumnya tidak menghentikan pelaporan status. Jika Anda ingin menghentikan pelaporan status, Anda harus membatalkan pendaftaran cluster.

Terraform

Jika Anda menggunakan Terraform untuk mengaktifkan fitur Config Management di perangkat Anda menggunakan google_gke_hub_feature sumber daya dari Penyedia Google Cloud Platform, lalu perbarui resource tersebut untuk menonaktifkan Config Management di semua cluster di fleet.

1. Update file HCL yang berisi google_gke_hub_feature Anda resource untuk menghapus resource google_gke_hub_feature.

2. Jika Anda masih memiliki resource gke_hub_feature_membership yang ditentukan dengan Kolom feature yang merujuk ke google_gke_hub_feature yang dihapus, hapus resource gke_hub_feature_membership itu juga.

3. Terapkan konfigurasi Terraform:

   terraform apply
   

   Konfirmasi bahwa Anda ingin menerapkan tindakan yang dijelaskan dengan memasukkan yes.

Config Connector

Jika Anda menggunakan Konektor Konfigurasi untuk mengaktifkan fitur Config Management di perangkat Anda menggunakan GKEHubFeature resource, lalu perbarui resource tersebut untuk menonaktifkan Config Management di semua cluster dalam fleet.

1. Identifikasi objek resource GKEHubFeature di cluster Anda yang memiliki Nilai .spec.resourceID dari configmanagement.

2. Jika Anda masih memiliki objek resource GKEHubFeatureMembership yang ditentukan dengan kolom .spec.featureRef yang merujuk ke resource GKEHubFeature tersebut , hapus:

   kubectl delete GKEHubFeatureMembership FEATURE_MEMBERSHIP_OBJECT_NAME \
       --namespace FEATURE_MEMBERSHIP_OBJECT_NAMESPACE
   

   Ganti kode berikut:

   • FEATURE_MEMBERSHIP_OBJECT_NAME: tambahkan nama Objek resource GKEHubFeatureMembership yang telah Anda buat sebelumnya.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: menambahkan namespace yang berisi objek resource GKEHubFeatureMembership yang dibuat sebelumnya.

3. Hapus resource GKEHubFeature dari cluster Anda:

   kubectl delete GKEHubFeature FEATURE_OBJECT_NAME \
       --namespace FEATURE_OBJECT_NAMESPACE
   

   Ganti kode berikut:

   • FEATURE_OBJECT_NAME: menambahkan nama GKEHubFeature resource yang telah Anda buat sebelumnya.

   • FEATURE_OBJECT_NAMESPACE: tambahkan namespace yang berisi Objek resource GKEHubFeature yang telah Anda buat sebelumnya.

Catatan: Menonaktifkan fitur Config Management di perangkat Anda tidak secara otomatis meng-uninstal ConfigManagement Operator dari cluster di fleet. Lanjutkan ke bagian berikutnya untuk meng-uninstal Operator ConfigManagement di setiap cluster.

Meng-uninstal Operator ConfigManagement

Gunakan kubectl untuk menghapus Operator ConfigManagement setelah Anda menonaktifkannya fitur Config Management pada fleet atau membatalkan pendaftaran cluster Anda dari armada itu.

Untuk menghapus ConfigManagement Operator, jalankan perintah berikut:

1. Hapus objek ConfigManagement dari cluster:

   kubectl delete configmanagement --all
   

   Setelah Anda menjalankan perintah ini, hal-hal berikut akan terjadi:

   • Setiap ClusterRoles dan ClusterRoleBindings dibuat di cluster dengan ConfigManagement Operator dihapus dari cluster.
   • Konfigurasi pengontrol penerimaan yang diinstal oleh ConfigManagement Operator dihapus.
   • Konten namespace config-management-system akan dihapus, dengan pengecualian Rahasia git-creds, dan untuk versi Config Sync mulai 1.9.0, Deployment config-management-operator, dan Pod config-management-operator. ConfigManagement Operator tidak dapat berfungsi tanpa config-management-system namespace. Setiap CustomResourceDefinitions (CRD) yang dibuat atau diubah oleh Pengontrol ConfigManagement Operator dihapus dari cluster tempat dibuat atau diubah. CRD yang diperlukan untuk menjalankan ConfigManagement Operator masih ada karena dari sudut pandang Kubernetes, ditambahkan oleh pengguna yang ConfigManagement Operator yang terinstal. Lumen cara menghapus komponen ini dibahas di langkah berikutnya.

2. Jika Anda perlu mempertahankan Rahasia git-creds, lakukan sekarang:

   kubectl -n config-management-system get secret git-creds -o yaml
   

3. Hapus namespace config-management-system:

   kubectl delete ns config-management-system
   

4. Hapus namespace config-management-monitoring:

   kubectl delete ns config-management-monitoring
   

5. Hapus ConfigManagement CustomResourceDefinition:

   kubectl delete crd configmanagements.configmanagement.gke.io