Menginstal Pengontrol Hierarki

Beta

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dengan Pengontrol Hierarki, Anda dapat mengatur namespace Kubernetes ke dalam hierarki, menerapkan kebijakan ke dalamnya (seperti RBAC dan kuota resource hierarkis), serta mengamati workload dari namespace terkait.

Halaman ini menunjukkan cara menginstal, mengonfigurasi, dan meng-uninstal Pengontrol Hierarki.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:

• Instal dan lakukan inisialisasi Google Cloud CLI, yang menyediakan perintah gcloud dan kubectl yang digunakan dalam petunjuk ini. Jika Anda menggunakan Cloud Shell, Google Cloud CLI sudah terinstal.

• Memiliki cluster yang menjalankan Kubernetes versi 1.16.x atau yang lebih baru.

Pengontrol Hierarki didesain agar dapat bekerja sama dengan Config Sync yang memungkinkan Anda mengelola namespace dan kebijakan hierarkis melalui repositori Git. Jika memilih untuk melakukannya, sebaiknya pilih repositori tidak terstruktur saat menginstal Config Sync yang memungkinkan Anda mengatur repositori sesuai keinginan Anda, sekaligus mempertahankan manfaat kebijakan hierarkis. Sebaliknya, repositori hierarki dapat bertentangan dengan Pengontrol Hierarki sehingga tidak direkomendasikan untuk menggunakan keduanya secara bersamaan.

Atau, Anda dapat memilih untuk menginstal Pengontrol Hierarki tanpa mengonfigurasi repositori Config Sync; namespace hierarki dapat ditentukan sepenuhnya di cluster melalui Kubernetes API. Jika tidak berencana menggunakan Git, Anda tidak perlu memberikan akses kepada Operator ke Git atau mengonfigurasinya dengan cara apa pun kecuali seperti yang dijelaskan di bagian berikut.

Aktifkan Pengontrol Hierarki

Ikuti langkah-langkah ini untuk mengonfigurasi Config Sync agar dapat menginstal Pengontrol Hierarki.

Catatan: Pengontrol Hierarki tidak didukung di cluster Autopilot.

gcloud

Catatan: Format file untuk perintah apply gcloud CLI diubah untuk versi 1.8.0. Pastikan Anda mengupdate gcloud CLI ke versi terbaru.

Ikuti langkah-langkah ini untuk mengonfigurasi Config Sync agar dapat menginstal Pengontrol Hierarki, termasuk semua komponen opsional. Jika Anda tidak ingin mengaktifkan kemampuan observasi hierarki atau kuota resource hierarkis, jadikan baris yang ditunjukkan sebagai komentar.

1. (Opsional) Jika Anda menggunakan cluster pribadi, tambahkan aturan firewall ke project setiap cluster untuk mengizinkan bidang kontrol cluster GKE terhubung ke webhook Pengontrol Hierarki di port 9443:

    gcloud compute firewall-rules create allow-cluster-control-plane-tcp-9443 \
      --allow tcp:9443 \
      --network default \
      --source-ranges CONTROL_PLANE_CIDR \
      --target-tags NODE_TAG
   

   Ganti kode berikut:

   • CONTROL_PLANE_CIDR: Rentang IP untuk bidang kontrol cluster GKE Anda. Contoh, 172.16.0.16/28.
   • NODE_TAG: Tag yang diterapkan ke semua node di cluster GKE Anda.

2. Tetapkan nilai berikut dalam objek spec.hierarchyController ke true dalam file konfigurasi gcloud:

   # apply-spec.yaml
   
   applySpecVersion: 1
   spec:
     hierarchyController:
       # Set to true to enable hierarchical namespaces
       enabled: true
       # Comment to disable hierarchical quota:
       enableHierarchicalResourceQuota: true
       # Comment to disable hierarchical observability:
       enablePodTreeLabels: true
     # ...other fields...
   

3. Terapkan file apply-spec.yaml:

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

   Ganti kode berikut:

   • CLUSTER_NAME: menambahkan cluster terdaftar tempat Anda ingin menerapkan konfigurasi ini.
   • CONFIG_YAML: menambahkan jalur ke file apply-spec.yaml Anda.
   • PROJECT_ID: tambahkan project ID Anda.

   Beberapa workload di-deploy, lalu Pengontrol Hierarki dapat digunakan di cluster Anda. Proses ini dapat memerlukan waktu hingga satu menit.

kubectl

Ikuti langkah-langkah ini untuk mengonfigurasi Config Sync agar dapat menginstal Pengontrol Hierarki, termasuk semua komponen opsional. Jika Anda tidak ingin mengaktifkan kemampuan observasi hierarki atau kuota resource hierarkis, jadikan baris yang ditunjukkan sebagai komentar.

1. (Opsional) Jika Anda menggunakan cluster pribadi, tambahkan aturan firewall ke project setiap cluster untuk mengizinkan bidang kontrol cluster GKE terhubung ke webhook Pengontrol Hierarki di port 9443:

    gcloud compute firewall-rules create allow-cluster-control-plane-tcp-9443 \
      --allow tcp:9443 \
      --network default \
      --source-ranges CONTROL_PLANE_CIDR \
      --target-tags NODE_TAG
   

   Ganti kode berikut:

   • CONTROL_PLANE_CIDR: Rentang IP untuk bidang kontrol cluster GKE Anda. Contoh, 172.16.0.16/28.
   • NODE_TAG: Tag yang diterapkan ke semua node di cluster GKE Anda.

2. Di file konfigurasi untuk Operator, pada objek spec.hierarchyController, tetapkan nilai enabled ke true:

   # config-management.yaml
   
   apiVersion: configmanagement.gke.io/v1
   kind: ConfigManagement
   metadata:
     name: config-management
   spec:
     # Set to true to enable hierarchical namespaces
     hierarchyController:
       enabled: true
       # Comment to disable hierarchical quota:
       enableHierarchicalResourceQuota: true
       # Comment to disable hierarchical observability:
       enablePodTreeLabels: true
      # ...other fields...
   

3. Terapkan konfigurasi:

     kubectl apply -f config-management.yaml
   

   Beberapa workload di-deploy, lalu Pengontrol Hierarki dapat digunakan di cluster Anda. Proses ini dapat memerlukan waktu hingga satu menit.

Menginstal plugin kubectl

Anda dapat berinteraksi dengan Pengontrol Hierarki hanya melalui alat klien Kubernetes seperti kubectl. Namun, plugin kubectl kubectl-hns open source sangat menyederhanakan beberapa tugas. Plugin ini adalah bagian dari Hierarchical Namespace Controller (HNC), yang merupakan komponen dari Hierarchy Controller.

Plugin ini didistribusikan oleh komunitas OSS, dan saat ini tersedia untuk Linux dan macOS. Untuk menginstalnya di workstation Anda, lihat Menginstal plugin kubectl dalam dokumentasi Config Sync.

Memverifikasi penginstalan

Setelah menginstal Pengontrol Hierarki, Anda dapat memverifikasi bahwa penginstalan berhasil diselesaikan.

gcloud

Jalankan perintah berikut:

gcloud beta container fleet config-management status \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project Anda.

Anda akan melihat output yang mirip dengan contoh berikut ini:

Name          ...other columns... Hierarchy_Controller
CLUSTER_NAME  ...other fields ... INSTALLED

Penginstalan yang berhasil akan menampilkan status INSTALLED di kolom Hierarchy_Controller. Mungkin perlu waktu beberapa menit hingga status muncul setelah Anda mengaktifkan Pengontrol Hierarki.

kubectl

Jika {i>Hierarchy Controller<i} diinstal dengan benar, Pod-nya akan berjalan. Pod mungkin akan dimulai ulang beberapa kali sebelum tersedia.

Karena Pod Pengontrol Hierarki berjalan di namespace hnc-system, Anda dapat melihat statusnya dengan menjalankan perintah berikut:

kubectl get pods -n hnc-system

Anda akan melihat output yang mirip dengan contoh berikut ini:

NAME                                         READY   STATUS    RESTARTS   AGE
gke-hc-controller-manager-6f4dbb484d-t8tdm   2/2     Running   1          1m
hnc-controller-manager-7b75655894-tzqvx      2/2     Running   1          1m

Upgrade Pengontrol Hierarki

Pengontrol Hierarki diupgrade setiap kali Anda mengupgrade Sinkronisasi Konfigurasi. Untuk mempelajari lebih lanjut, lihat Mengupgrade Config Sync.

Uninstal Pengontrol Hierarki

Ikuti langkah-langkah ini untuk meng-uninstal Hierarchy Controller dari cluster Anda.

gcloud

Untuk meng-uninstal Hierarchy Controller:

1. Edit konfigurasi Pengontrol Hierarki di file apply-spec.yaml dan tetapkan hierarchyController.enabled ke false.

2. Terapkan perubahan di file apply-spec.yaml:

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

   Ganti kode berikut:

   • CLUSTER_NAME: menambahkan cluster terdaftar tempat Anda ingin menerapkan konfigurasi ini.
   • CONFIG_YAML: menambahkan jalur ke file apply-spec.yaml Anda.
   • PROJECT_ID: tambahkan project ID Anda.

Setelah Pengontrol Hierarki menghapus resolver hierarchycontroller.configmanagement.gke.io, proses uninstal selesai.

Catatan: Meng-uninstal Pengontrol Hierarki tidak akan menghapus namespace apa pun, juga tidak menghapus objek apa pun yang disebarkan dari namespace ancestor ke turunannya. Namun, perubahan lebih lanjut pada objek ini tidak akan disebarkan.

kubectl

Untuk meng-uninstal Pengontrol Hierarki, edit konfigurasi Config Sync di file config-management.yaml Anda dan tetapkan hierarchyController.enabled ke false. Setelah Config Sync menghapus resolver hierarchycontroller.configmanagement.gke.io, proses uninstal selesai.

Catatan: Meng-uninstal Pengontrol Hierarki tidak akan menghapus namespace apa pun, juga tidak menghapus objek apa pun yang disebarkan dari namespace ancestor ke turunannya. Namun, perubahan lebih lanjut pada objek ini tidak diterapkan.

Jika ingin meng-uninstal Config Sync sepenuhnya, lihat Meng-uninstal Config Sync dari cluster.

Langkah selanjutnya

• Pelajari Pengontrol Hierarki lebih lanjut
• Menerapkan kuota resource hierarki
• Mengamati workload hierarkis
• Pelajari fitur namespace hierarkis dasar
• Jelajahi fitur namespace hierarki lanjutan