Como instalar CRDs do Config Connector v1alpha1

---

Neste tópico, explicamos como instalar definições de recurso personalizadas (CRDs, na sigla em inglês) de recursos v1alpha1 Google Cloud no Config Connector.

Aviso: os CRDs de recursos do Config Connector v1alpha1 Google Cloud não devem ser usados na produção. Quando o Config Connector é atualizado, os CRDs v1alpha1 precisam ser atualizados manualmente para garantir que continuem funcionando. É necessário instalar, fazer upgrade e desinstalar manualmente os CRDs v1alpha1, porque eles não são gerenciados pelo operador do Config Connector ou pelo complemento do Config Connector.

Antes de começar

1. Verifique se o Config Connector está instalado manualmente ou pelo complemento do GKE.

2. Verifique se a versão do Config Connector é 1.103.0 ou mais recente. Para verificar a versão do Config Connector, conecte-se ao cluster em que ele está instalado e execute o seguinte comando:

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

Como instalar os CRDs v1alpha1

1. Clone o repositório do GitHub:

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

2. git checkout para sua versão do 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. Instale os CRDs v1alpha1:

   cd crds
   

   1. Se você quiser instalar uma CRD v1alpha1 específica, execute o seguinte comando:

      kubectl apply -f CRD_FILENAME
      

      Substitua CRD_FILENAME pelo nome do arquivo do CRD v1alpha1 que você quer instalar.

   2. Se você quiser instalar todos os CRDs v1alpha1, execute o seguinte comando:

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

Os CRDs v1alpha1 são instalados quando o comando kubectl apply é concluído.

Fazer upgrade dos CRDs v1alpha1

Aviso: os CRDs v1alpha1 precisam ser atualizados depois que a versão do Config Connector for atualizada para garantir que os CRs existentes dos CRDs v1alpha1 ainda funcionem.

Aviso: não é possível fazer downgrade dos CRDs v1alpha1.

1. Verifique se a versão do Config Connector foi atualizada antes de atualizar os CRDs v1alpha1.

2. git checkout para a versão do Config Connector no repositório local do Config Connector:

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

3. Faça upgrade dos CRDs v1alpha1:

   cd crds
   

   1. Se você quiser fazer upgrade de um CRD v1alpha1 específico, execute o seguinte comando:

      kubectl apply -f CRD_FILENAME
      

      Substitua CRD_FILENAME pelo nome do arquivo do CRD v1alpha1 que você quer instalar.

   2. Se você quiser fazer upgrade de todos os CRDs v1alpha1, execute o seguinte comando:

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

Os CRDs v1alpha1 são atualizados quando o comando kubectl apply é concluído.

Desinstalar os CRDs v1alpha1

1. Exclua os CRs para CRDs v1alpha1 se você não precisar mais dos recursos Google Cloud subjacentes. Caso contrário, pule esta etapa.

   Observação: os CRs são abandonados quando os CRDs v1alpha1 são desinstalados. Os recursos Google Cloud correspondentes ainda vão existir.

2. Faça check-out da versão do Config Connector no repositório local do Config Connector:

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

3. Desinstale os CRDs v1alpha1:

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

Os CRDs v1alpha1 são desinstalados se o comando kubectl delete for concluído.