Installazione dei CRD di Config Connector v1alpha1

---

Questo argomento spiega come installare le definizioni di risorse personalizzate (CRD) Google Cloud della risorsa v1alpha1 in Config Connector.

Avviso: le risorse Google Cloud CRD di Config Connector v1alpha1 non devono essere utilizzate in produzione. Quando viene eseguito l'upgrade di Config Connector, è necessario eseguire l'upgrade manuale dei CRD v1alpha1 per assicurarsi che continuino a funzionare. Devi installare, eseguire l'upgrade e disinstallare manualmente i CRD v1alpha1, poiché non sono gestiti dall'operatore Config Connector o dal componente aggiuntivo Config Connector.

Prima di iniziare

1. Assicurati che Config Connector sia installato manualmente o tramite il componente aggiuntivo GKE.

2. Controlla la versione di Config Connector e assicurati che sia 1.103.0 o successiva. Puoi controllare la versione di Config Connector connettendoti al cluster in cui è installato Config Connector ed eseguendo il seguente comando:

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

Installazione dei CRD v1alpha1

1. Clona il repository GitHub:

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

2. git checkout alla versione di Config Connector:

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

3. Installa i CRD v1alpha1:

   cd crds
   

   1. Se vuoi installare un CRD v1alpha1 specifico, esegui il seguente comando:

      kubectl apply -f CRD_FILENAME
      

      Sostituisci CRD_FILENAME con il nome del file del CRD v1alpha1 che vuoi installare.

   2. Se vuoi installare tutti i CRD v1alpha1, esegui il seguente comando:

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

I CRD v1alpha1 vengono installati correttamente al termine del comando kubectl apply.

Eseguire l'upgrade delle CRD v1alpha1

Avviso: è necessario eseguire l'upgrade delle CRD v1alpha1 dopo l'upgrade della versione di Config Connector per assicurarsi che le RP esistenti delle CRD v1alpha1 continuino a funzionare.

Avviso: il downgrade delle CRD v1alpha1 non è supportato.

1. Assicurati di eseguire l'upgrade della versione di Config Connector prima di eseguire l'upgrade delle CRD v1alpha1.

2. git checkout alla versione di Config Connector nel repository Config Connector locale:

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

3. Esegui l'upgrade dei CRD v1alpha1:

   cd crds
   

   1. Se vuoi eseguire l'upgrade di un CRD v1alpha1 specifico, esegui il seguente comando:

      kubectl apply -f CRD_FILENAME
      

      Sostituisci CRD_FILENAME con il nome del file del CRD v1alpha1 che vuoi installare.

   2. Se vuoi eseguire l'upgrade di tutte le CRD v1alpha1, esegui il seguente comando:

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

L'upgrade delle CRD v1alpha1 viene eseguito correttamente al termine del comando kubectl apply.

Disinstallazione dei CRD v1alpha1

1. Elimina i CR per i CRD v1alpha1 se non hai più bisogno delle risorse Google Cloud sottostanti. In caso contrario, salta questo passaggio.

   Nota: le risorse CR vengono abbandonate quando le risorse CRD v1alpha1 vengono disinstallate. Le risorse Google Cloud corrispondenti continueranno a esistere.

2. Esegui il check-out della versione di Config Connector nel repository locale di Config Connector:

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

3. Disinstalla i CRD v1alpha1:

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

I CRD v1alpha1 vengono disinstallati correttamente se il comando kubectl delete viene completato correttamente.