Instala las CRD de Config Connector v1alpha1

---

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

Advertencia: No se deben usar las CRD de recursos de Config Connector v1alpha1 Google Cloud en producción. Cuando se actualiza Config Connector, las CRD de v1alpha1 deben actualizarse manualmente para garantizar que sigan funcionando. Debes instalar, actualizar y desinstalar manualmente los CRD de v1alpha1, ya que el operador de Config Connector o el complemento de Config Connector no los administran.

Antes de comenzar

1. Asegúrate de que Config Connector esté instalado de forma manual o a través del complemento de GKE.

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

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

Instala las CRD de 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 de v1alpha1:

   cd crds
   

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

      kubectl apply -f CRD_FILENAME
      

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

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

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

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

Actualiza las CRD de v1alpha1

Advertencia: Las CRD de v1alpha1 deben actualizarse después de que se actualice la versión de Config Connector para garantizar que las CR existentes de las CRD de v1alpha1 sigan funcionando.

Advertencia: No se admite la baja de versión de las CRD de v1alpha1.

1. Asegúrate de que la versión de Config Connector se actualice antes de actualizar las CRD de v1alpha1.

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

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

3. Actualiza las CRD de v1alpha1:

   cd crds
   

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

      kubectl apply -f CRD_FILENAME
      

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

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

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

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

Desinstala las CRD de v1alpha1

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

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

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

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

3. Desinstala las CRD de v1alpha1:

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

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