Meng-uninstal Config Sync

Halaman ini menunjukkan cara menghapus instalasi Config Sync dari cluster Anda, menonaktifkan fitur fleet Config Management di fleet Anda, dan menghapus instalasi Operator ConfigManagement.

Halaman ini ditujukan bagi administrator dan Operator IT yang mengelola siklus proses infrastruktur teknologi yang mendasarinya. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam konten, lihat Peran dan tugas pengguna GKE umum. Google Cloud

Fitur armada Config Management mengelola Config Sync menggunakan Operator ConfigManagement. Karena arsitektur ini, langkah-langkah uninstal harus diselesaikan dalam urutan berikut:

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

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

Meng-uninstal Config Sync dari cluster Anda

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

Konsol

Anda tidak dapat meng-uninstal Config Sync hanya dengan Google Cloud konsol. Sebagai gantinya, gunakan Google Cloud CLI.

gcloud

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

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

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

3. Terapkan perubahan:

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

   Ganti kode berikut:

   • MEMBERSHIP_NAME: tambahkan cluster terdaftar yang ingin Anda terapkan konfigurasi ini. Jika Anda mendaftarkan cluster di konsol Google Cloud , nama keanggotaan sama dengan nama cluster Anda.

   • CONFIG_YAML: tambahkan jalur ke file apply-spec.yaml Anda.

   • PROJECT_ID: tambahkan project ID Anda.

Terraform

Jika Anda menggunakan Terraform untuk menginstal Config Sync menggunakan resource gke_hub_feature_membership dari Penyedia Google Cloud Platform, perbarui resource tersebut untuk meng-uninstal Config Sync. Jangan gunakan perintah terraform destroy. Perintah terraform destroy tidak sepenuhnya meng-uninstal Config Sync. Beberapa komponen tetap ada.

1. Identifikasi resource gke_hub_feature_membership di file konfigurasi Terraform Anda yang memiliki argumen configmanagement yang diisi.

2. Perbarui 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.20.0"
     }
   }
   

3. Terapkan konfigurasi Terraform:

   terraform apply
   

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

Config Connector

Jika Anda menggunakan Config Connector untuk menginstal Config Sync menggunakan resource GKEHubFeatureMembership, update resource tersebut untuk meng-uninstal Config Sync.

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

2. Patch objek resource GKEHubFeatureMembership untuk menghapus kolom .spec.configmanagement.configSync dengan menetapkannya 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 Anda buat sebelumnya.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: tambahkan namespace yang berisi objek resource GKEHubFeatureMembership yang sebelumnya Anda buat.

Menonaktifkan Config Management di armada Anda

Catatan: Jika masih ingin menggunakan Pengelolaan Konfigurasi di cluster lain dalam Fleet, Anda dapat melewati langkah ini, tetapi Anda tidak akan dapat meng-uninstal Operator ConfigManagement hingga setelah fitur Pengelolaan Konfigurasi dinonaktifkan di fleet atau cluster dihapus dari fleet.

Konsol

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

   Buka Pengelola Fitur

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

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

4. Di halaman konfirmasi, klik Nonaktifkan Pengelolaan Konfigurasi.

gcloud

1. Untuk menonaktifkan Pengelolaan Konfigurasi di semua cluster dalam armada, jalankan perintah berikut:

   gcloud beta container fleet config-management disable
   

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

Terraform

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

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

2. Jika Anda masih memiliki resource gke_hub_feature_membership yang ditentukan dengan kolom feature yang mereferensikan google_gke_hub_feature yang dihapus, hapus juga resource gke_hub_feature_membership tersebut.

3. Terapkan konfigurasi Terraform:

   terraform apply
   

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

Config Connector

Jika Anda menggunakan Config Connector untuk mengaktifkan fitur Config Management di fleet menggunakan resource GKEHubFeature, 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 sebesar configmanagement.

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

   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 Anda buat sebelumnya.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: tambahkan namespace yang berisi objek resource GKEHubFeatureMembership yang sebelumnya Anda buat.

3. Hapus resource GKEHubFeature dari cluster Anda:

   kubectl delete GKEHubFeature FEATURE_OBJECT_NAME \
       --namespace FEATURE_OBJECT_NAMESPACE
   

   Ganti kode berikut:

   • FEATURE_OBJECT_NAME: tambahkan nama objek resource GKEHubFeature yang Anda buat sebelumnya.

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

Catatan: Menonaktifkan fitur Config Management di fleet Anda tidak akan secara otomatis menghapus instalasi Operator ConfigManagement dari cluster di fleet. Lanjutkan ke bagian berikutnya untuk menghapus instalasi ConfigManagement Operator di setiap cluster.

Meng-uninstal Operator ConfigManagement

Gunakan kubectl untuk menghapus Operator ConfigManagement setelah Anda menonaktifkan fitur Pengelolaan Konfigurasi di fleet atau membatalkan pendaftaran cluster Anda dari fleet.

Untuk menghapus Operator ConfigManagement, jalankan perintah berikut:

1. Hapus objek ConfigManagement dari cluster:

   kubectl delete configmanagement --all
   

   Setelah Anda menjalankan perintah ini, hal berikut akan terjadi:

   • Semua ClusterRole dan ClusterRoleBinding yang dibuat di cluster oleh ConfigManagement Operator akan dihapus dari cluster.
   • Semua konfigurasi pengontrol penerimaan yang diinstal oleh Operator ConfigManagement akan dihapus.
   • Konten namespace config-management-system dihapus, kecuali git-creds Secret, dan untuk versi Config Sync yang dimulai dari 1.9.0, config-management-operator Deployment, dan config-management-operator Pod. Operator ConfigManagement tidak dapat berfungsi tanpa namespace config-management-system. Setiap CustomResourceDefinitions (CRD) yang dibuat atau diubah oleh pengontrol ConfigManagement Operator akan dihapus dari cluster tempat CRD tersebut dibuat atau diubah. CRD yang diperlukan untuk menjalankan ConfigManagement Operator masih ada karena dari sudut pandang Kubernetes, CRD tersebut ditambahkan oleh pengguna yang menginstal ConfigManagement Operator. Informasi tentang cara menghapus komponen ini dibahas di langkah berikutnya.

2. Jika Anda perlu mempertahankan git-creds Secret, 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 CustomResourceDefinition ConfigManagement:

   kubectl delete crd configmanagements.configmanagement.gke.io