Installazione delle CRD v1alpha1 di Config Connector

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

Avviso: i CRD delle risorse Config Connector v1alpha1 Google Cloud non devono essere utilizzati in produzione. Quando viene eseguito l'upgrade di Config Connector, è necessario eseguire manualmente l'upgrade dei CRD v1alpha1 per assicurarsi che continuino a funzionare. Devi installare, eseguire l'upgrade e disinstallare manualmente i CRD v1alpha1, in quanto 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 di GKE.

2. Controlla la versione di Config Connector e assicurati che sia la 1.103.0 o versioni successive. 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 tua 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 una CRD v1alpha1 specifica, esegui questo comando:

      kubectl apply -f CRD_FILENAME
      

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

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

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

Le CRD v1alpha1 vengono installate correttamente al termine del comando kubectl apply.

Upgrade dei CRD v1alpha1

Avviso:i CRD v1alpha1 devono essere aggiornati dopo l'upgrade della versione di Config Connector per garantire che i CR esistenti dei CRD v1alpha1 continuino a funzionare.

Avviso:il downgrade dei CRD v1alpha1 non è supportato.

1. Assicurati che la versione di Config Connector sia aggiornata prima di eseguire l'upgrade dei CRD v1alpha1.

2. git checkout alla tua 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. Esegui l'upgrade dei CRD v1alpha1:

   cd crds
   

   1. Se vuoi eseguire l'upgrade di una CRD v1alpha1 specifica, esegui questo comando:

      kubectl apply -f CRD_FILENAME
      

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

   2. Se vuoi eseguire l'upgrade di tutti i CRD v1alpha1, esegui questo comando:

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

Gli CRD v1alpha1 vengono aggiornati correttamente al termine del comando kubectl apply.

Disinstallazione dei CRD v1alpha1

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

   Nota: le CR vengono abbandonate quando vengono disinstallate le CRD v1alpha1. Le risorse Google Cloud corrispondenti esisteranno ancora.

2. Esegui il controllo della 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. Disinstalla i CRD v1alpha1:

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

Le CRD v1alpha1 vengono disinstallate correttamente se il comando kubectl delete viene completato correttamente.