Instalar CRDs de Config Connector v1alpha1

En este tema se explica cómo instalar la versión v1alpha1 del recurso Google Cloud CustomResourceDefinitions (CRDs) en Config Connector.

Advertencia: Los CRDs de recursos de Config Connector v1alpha1 Google Cloud no se deben usar en producción. Cuando se actualiza Config Connector, los CRDs de v1alpha1 deben actualizarse manualmente para que sigan funcionando. Debes instalar, actualizar y desinstalar manualmente los CRDs v1alpha1, ya que no los gestiona el operador de Config Connector ni el complemento Config Connector.

Antes de empezar

1. Comprueba que Config Connector esté instalado manualmente o mediante el complemento de GKE.

2. Comprueba la versión de Config Connector y asegúrate de que sea la 1.103.0 o una posterior. Para comprobar 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}'
   

Instalar los CRDs 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 los CRDs de v1alpha1:

   cd crds
   

   1. Si quieres instalar un CRD v1alpha1 específico, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

      Sustituye CRD_FILENAME por el nombre de archivo del CRD v1alpha1 que quieras instalar.

   2. Si quieres instalar todos los CRDs de v1alpha1, ejecuta el siguiente comando:

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

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

Actualizar los CRDs de v1alpha1

Advertencia: Las CRDs de la versión v1alpha1 deben actualizarse después de que se actualice la versión de Config Connector para asegurarse de que las CRs de la versión v1alpha1 sigan funcionando.

Advertencia: No se admite la versión anterior de las CRDs de la versión v1alpha1.

1. Asegúrate de que la versión de Config Connector se haya actualizado antes de actualizar los CRDs 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 los CRDs de v1alpha1:

   cd crds
   

   1. Si quieres actualizar un CRD v1alpha1 específico, ejecuta el siguiente comando:

      kubectl apply -f CRD_FILENAME
      

      Sustituye CRD_FILENAME por el nombre de archivo del CRD v1alpha1 que quieras instalar.

   2. Si quieres actualizar todos los CRDs v1alpha1, ejecuta el siguiente comando:

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

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

Desinstalar los CRDs de v1alpha1

1. Elimina los CRs de los CRDs de la versión v1alpha1 si ya no necesitas los Google Cloud recursos subyacentes. De lo contrario, sáltate este paso.

   Nota: Los CRs se abandonan cuando se desinstalan los CRDs v1alpha1. Los recursos correspondientes seguirán existiendo. Google Cloud

2. Consulta 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. Desinstala los CRDs de v1alpha1:

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

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