Instala las CRD de Config Connector v1alpha1

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

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

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 tu versión de Config Connector y asegúrate de que sea la 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 específica de v1alpha1, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

      Reemplaza CRD_FILENAME por el nombre de archivo del CRD de 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 } ')
      

Los CRD de v1alpha1 se instalan correctamente cuando el comando kubectl apply se completa correctamente.

Actualiza los CRD de v1alpha1

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

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

1. Asegúrate de actualizar la versión de Config Connector antes de actualizar los CRD de v1alpha1.

2. git checkout a tu 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 un CRD específico de v1alpha1, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

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

   2. Si deseas actualizar todos los CRD de v1alpha1, ejecuta el siguiente comando:

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

Los CRD de v1alpha1 se actualizan correctamente cuando el comando kubectl apply se completa correctamente.

Cómo desinstalar las CRD de v1alpha1

1. Borra los CR de los 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 los CRD de v1alpha1. Los recursos Google Cloudcorrespondientes seguirán existiendo.

2. Realiza el checkout de tu 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. Desinstala las CRD de v1alpha1:

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

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