Bermigrasi dari Hierarchy Controller ke Hierarchical Namespace Controller (HNC)

Halaman ini menjelaskan cara melakukan migrasi dari Hierarchy Controller (tidak tersedia mulai Desember 2024) ke Hierarchical Namespace Controller (HNC) Kubernetes open source.

Untuk menentukan cara melakukan migrasi ke HNC, periksa objek kubectl ConfigManagement atau file gcloud apply spec dan lakukan tindakan yang sesuai dengan nilai di kolom berikut:

• hierarchyController.enablePodTreeLabels: jika true, dan Anda menggunakan observabilitas hierarkis, jangan lanjutkan dengan langkah-langkah di halaman ini. Sebagai gantinya, hubungi Cloud Customer Care untuk mendapatkan bantuan migrasi ke alternatif.
• hierarchyController.enabled: jika true, lakukan hal berikut:
  1. Nonaktifkan Pengontrol Hierarki.
  2. Instal HNC.
  3. Jika ingin, migrasikan Kuota Resource Hierarkis ke HNC.

Menonaktifkan Pengontrol Hierarki

Jika Anda menonaktifkan Pengontrol Hierarki, tindakan ini akan menghapus komponen Pengontrol Hierarki di cluster Anda. Tindakan ini tidak menghapus Definisi Resource Kustom (CRD) Pengontrol Hierarki:

• HierarchyConfiguration
• HNCConfiguration
• SubnamespaceAnchor
• HierarchicalResourceQuota

Untuk menghapus kolom Pengontrol Hierarki, tinjau petunjuk untuk metode yang Anda gunakan untuk menginstal Pengontrol Hierarki:

gcloud

Hapus blok hierarchyController dari file apply spec Google Cloud CLI.

Terraform

Hapus blok hierarchyController dari resource Terraform Anda.

Config Connector

Tetapkan kolom Pengontrol Hierarki ke false di resource GKEHubFeatureMembership.

Penting: Jangan hapus kolom Pengontrol Hierarki dari resource GKEHubFeatureMembership. Menghapus kolom tidak menonaktifkan Pengontrol Hierarki dan menyebabkan kolom menjadi dikelola secara eksternal, bukan dikelola oleh Konektor Konfigurasi.

kubectl

Hapus blok hierarchyController dari objek ConfigManagement.

Menginstal HNC

Ikuti petunjuk untuk menginstal HNC di cluster.

Jika menggunakan Kuota Resource Hierarkis, Anda harus menginstal HNC versi 1.1.0 atau yang lebih baru.

Memigrasikan kuota resource hierarkis

Jika Anda menggunakan kuota resource hierarkis dengan Pengontrol Hierarki dengan menetapkan hierarchyController.enableHierarchicalResourceQuota ke true, untuk menyelesaikan migrasi ke HNC, selesaikan langkah-langkah berikut:

1. Instal kuota resource hierarkis HNC dengan menginstal file hrq.yaml di bagian Releases > Assets.

2. Untuk memigrasikan resource kustom kuota resource hierarkis yang ada, ubah kolom apiVersion dari hierarchycontroller.configmanagement.gke.io/v1alpha1 menjadi hnc.x-k8s.io/v1alpha2. Anda dapat menemukan resource kustom di cluster dengan menjalankan perintah berikut:

   kubectl get hierarchicalresourcequota.hierarchycontroller.configmanagement.gke.io --all-namespaces
   

3. Terapkan kembali resource kuota resource hierarkis.

4. Hapus CRD untuk Kuota Resource Hierarkis dari Pengontrol Hierarki:

   kubectl delete crd hierarchicalresourcequotas.hierarchycontroller.configmanagement.gke.io