Menginstal CRD v1alpha1 Config Connector

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

Peringatan: CRD resource Config Connector v1alpha1 Google Cloud 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 versi tersebut adalah 1.103.0 dan yang lebih baru. Anda dapat memeriksa versi Config Connector dengan menghubungkan 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
   

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 crds
   

   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 $(ls *v1alpha1*.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 CRD v1alpha1 yang ada 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 crds
   

   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 instal.

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

      kubectl apply $(ls *v1alpha1*.yaml | awk ' { print " -f " $1 } ')
      

CRD v1alpha1 berhasil diupgrade saat perintah kubectl apply berhasil diselesaikan.

Meng-uninstal 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 saat 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 crds
   kubectl delete $(ls *v1alpha1*.yaml | awk ' { print " -f " $1 } ')
   

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