Menginstal CRD v1alpha1 Config Connector

Topik ini menjelaskan cara menginstal resource Custom Resource Definitions (CRD) v1alpha1 Google Cloud di Config Connector.

Peringatan: CRD resource v1alpha1 Google Cloud Config Connector tidak boleh digunakan dalam produksi. Saat Config Connector diupgrade, CRD v1alpha1 harus diupgrade secara manual untuk memastikan CRD tersebut terus berfungsi. Anda harus menginstal, mengupgrade, dan meng-uninstal CRD v1alpha1 secara manual, karena CRD tersebut tidak dikelola oleh operator Config Connector atau add-on Config Connector.

Sebelum memulai

1. Pastikan Config Connector diinstal secara manual atau melalui add-on GKE.

2. Periksa versi Config Connector Anda dan pastikan versinya 1.103.0 dan yang lebih baru. Anda dapat memeriksa versi Config Connector dengan terhubung ke cluster tempat Config Connector diinstal dan menjalankan perintah berikut:

   kubectl get ns cnrm-system -o jsonpath='{.metadata.annotations.cnrm\.cloud\.google\.com/version}'
   

Menginstal CRD v1alpha1

1. Clone repositori GitHub:

   git clone https://github.com/GoogleCloudPlatform/k8s-config-connector
   

   Anda juga dapat menjelajahi manifes CRD di direktori config/crds/resources di GitHub.

2. git checkout ke versi Config Connector Anda:

   cd k8s-config-connector
   echo 'v'$(kubectl get ns cnrm-system -o jsonpath='{.metadata.annotations.cnrm\.cloud\.google\.com/version}') | xargs git checkout
   

3. Instal CRD v1alpha1:

   cd config/crds/resources
   

   1. Jika Anda ingin menginstal CRD v1alpha1 tertentu, jalankan perintah berikut:

      kubectl apply -f CRD_FILENAME
      

      Ganti CRD_FILENAME dengan nama file CRD v1alpha1 yang ingin Anda instal.

   2. Jika Anda ingin menginstal semua CRD v1alpha1, jalankan perintah berikut:

      kubectl apply $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.yaml | awk ' { print " -f " $1 } ')
      

CRD v1alpha1 berhasil diinstal saat perintah kubectl apply berhasil diselesaikan.

Mengupgrade CRD v1alpha1

Peringatan: CRD v1alpha1 perlu diupgrade setelah versi Config Connector Anda diupgrade untuk memastikan CR yang ada dari CRD v1alpha1 tetap berfungsi.

Peringatan: Downgrade CRD v1alpha1 tidak didukung.

1. Pastikan versi Config Connector diupgrade sebelum Anda mengupgrade CRD v1alpha1.

2. git checkout ke versi Config Connector di repositori Config Connector lokal Anda:

   echo 'v'$(kubectl get ns cnrm-system -o jsonpath='{.metadata.annotations.cnrm\.cloud\.google\.com/version}') | xargs git checkout
   

3. Upgrade CRD v1alpha1:

   cd config/crds/resources
   

   1. Jika Anda ingin mengupgrade CRD v1alpha1 tertentu, jalankan perintah berikut:

      kubectl apply -f CRD_FILENAME
      

      Ganti CRD_FILENAME dengan nama file CRD v1alpha1 yang ingin Anda upgrade.

   2. Jika Anda ingin mengupgrade semua CRD v1alpha1, jalankan perintah berikut:

      kubectl apply $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.yaml | awk ' { print " -f " $1 } ')
      

CRD v1alpha1 berhasil diupgrade saat perintah kubectl apply berhasil diselesaikan.

Menghapus CRD v1alpha1

1. Hapus CR untuk CRD v1alpha1 jika Anda tidak lagi memerlukan resource Google Cloud yang mendasarinya. Jika tidak, lewati langkah ini.

   Catatan: CR akan ditinggalkan jika CRD v1alpha1 di-uninstal. Resource Google Cloud yang sesuai akan tetap ada.

2. Periksa versi Config Connector di repositori Config Connector lokal Anda:

   echo 'v'$(kubectl get ns cnrm-system -o jsonpath='{.metadata.annotations.cnrm\.cloud\.google\.com/version}') | xargs git checkout
   

3. Uninstal CRD v1alpha1:

   cd config/crds/resources
   kubectl delete $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.yaml | awk ' { print " -f " $1 } ')
   

CRD v1alpha1 berhasil di-uninstal jika perintah kubectl delete berhasil diselesaikan.