Meng-uninstal Config Sync

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

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

Fitur armada Config Management mengelola Config Sync menggunakan Operator ConfigManagement. Karena arsitektur ini, langkah-langkah penguninstalan 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 penyebaran 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 konsol Google Cloud. Sebagai gantinya, gunakan Google Cloud CLI.

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. 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 akan 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, update resource tersebut untuk meng-uninstal Config Sync.

1. Identifikasi resource gke_hub_feature_membership dalam file konfigurasi Terraform Anda yang memiliki argumen configmanagement yang terisi.

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

   • 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 di 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 Disable Config Management. Halaman konfirmasi akan muncul.

4. Di halaman konfirmasi, klik Disable Config Management.

gcloud

1. Untuk menonaktifkan Pengelolaan Konfigurasi di semua cluster dalam fleet, 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, update resource tersebut untuk menonaktifkan Config Management di semua cluster dalam fleet.

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

2. Jika Anda masih memiliki objek resource GKEHubFeatureMembership yang ditentukan dengan kolom .spec.featureRef yang mereferensikan objek 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 sebelumnya Anda buat.

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

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

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

Catatan: Menonaktifkan fitur Config Management di fleet tidak akan otomatis meng-uninstal Operator ConfigManagement 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 menonaktifkan fitur Pengelolaan Konfigurasi di fleet atau membatalkan pendaftaran cluster 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 ClusterRoles dan ClusterRoleBindings yang dibuat di cluster oleh Operator ConfigManagement akan dihapus dari cluster.
   • Semua konfigurasi pengontrol akses yang diinstal oleh Operator ConfigManagement akan dihapus.
   • Konten namespace config-management-system akan dihapus, kecuali git-creds Secret, dan untuk versi Config Sync mulai 1.9.0, Deployment config-management-operator, dan Pod config-management-operator. Operator ConfigManagement tidak dapat berfungsi tanpa namespace config-management-system. Setiap CustomResourceDefinitions (CRD) yang dibuat atau diubah oleh pengontrol Operator ConfigManagement akan dihapus dari cluster tempat CRD dibuat atau diubah. CRD yang diperlukan untuk menjalankan Operator ConfigManagement masih ada karena dari sudut pandang Kubernetes, CRD ditambahkan oleh pengguna yang menginstal Operator ConfigManagement. Informasi tentang cara menghapus komponen ini akan dibahas di langkah berikutnya.

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

   kubectl delete crd configmanagements.configmanagement.gke.io