Instala los CRD de Config Connector v1alpha1

---

En este tema, se explica cómo instalar las definiciones de recursos personalizados (CRD) de la versión v1alpha1 de Google Cloud en Config Connector.

Advertencia: Los CRD de recursos de Google Cloud Config Connector v1alpha1 no se deben usar en producción. Cuando se actualiza Config Connector, las CRD v1alpha1 deben actualizarse de forma manual para garantizar que sigan funcionando. Debes instalar, actualizar y desinstalar de forma manual las CRD v1alpha1, ya que no las administra el operador de Config Connector ni el complemento de Config Connector.

Antes de comenzar

1. Asegúrate de que el conector de configuración esté instalado a través de la instalación manual o mediante el complemento de GKE.

2. Verifica tu versión de Config Connector y asegúrate de que sea la versión 1.103.0 y superior. Para verificar la versión de Config Connector, conéctate al clúster en el que está instalado y ejecuta el siguiente comando:

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

Instala las CRD v1alpha1

1. Clona el repositorio de GitHub:

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

2. git checkout a tu versión de 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. Instala las CRD v1alpha1:

   cd crds
   

   1. Si deseas instalar una CRD específica de v1alpha1, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

      Reemplaza CRD_FILENAME por el nombre del archivo de CRD v1alpha1 que deseas instalar.

   2. Si deseas instalar todas las CRD v1alpha1, ejecuta el siguiente comando:

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

Las CRD v1alpha1 se instalan correctamente cuando el comando kubectl apply se completa de forma correcta.

Actualiza las CRD v1alpha1

Advertencia: Las CRD v1alpha1 deben actualizarse después de que se actualice tu versión de Config Connector para garantizar que las CR existentes de las CRD v1alpha1 aún funcionen.

Advertencia: No se admite el cambio a una versión inferior de las CRD.

1. Asegúrate de que la versión de Config Connector esté actualizada antes de actualizar las CRD v1alpha1.

2. git checkout a tu versión de Config Connector en el repositorio de Config Connector local:

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

3. Actualiza las CRD v1alpha1:

   cd crds
   

   1. Si quieres actualizar una CRD específica de v1alpha1, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

      Reemplaza CRD_FILENAME por el nombre del archivo de CRD v1alpha1 que deseas instalar.

   2. Si deseas actualizar todas las CRD v1alpha1, ejecuta el siguiente comando:

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

Las CRD v1alpha1 se actualizan de forma correcta cuando se completa correctamente el comando kubectl apply.

Desinstala las CRD de v1alpha1

1. Borra las CR para las CRD v1alpha1 si ya no necesitas los recursos subyacentes de Google Cloud. De lo contrario, omite este paso.

   Nota: Las CR se abandonan cuando se desinstalan las CRD v1alpha1. Los recursos de Google Cloud correspondientes seguirán existiendo.

2. Consulta la versión de Config Connector en el repositorio de Config Connector local:

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

3. Desinstala las CRD v1alpha1:

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

Las CRD v1alpha1 se desinstalan de forma correcta si el comando kubectl delete se completa de forma correcta.