Como instalar os CRDs do Config Connector v1alpha1

---

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

Aviso: os CRDs de recursos do Google Cloud Config Connector v1alpha1 não devem ser usados na produção. Quando o Config Connector é atualizado, as CRDs v1alpha1 precisam ser atualizadas manualmente para garantir que continuem funcionando. É preciso instalar, atualizar e desinstalar manualmente os CRDs v1alpha1, já que 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 por meio da instalação manual ou do complemento do GKE.

2. Verifique se a versão do Config Connector é 1.103.0 e posterior. Para verificar a versão do Config Connector, conecte-se ao cluster em que o Config Connector 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 à 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 um CRD v1alpha1 específico, execute o seguinte comando:

      kubectl apply -f CRD_FILENAME
      

      Substitua CRD_FILENAME pelo nome do arquivo da 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.

Como fazer upgrade dos CRDs v1alpha1

Aviso: é necessário fazer upgrade dos CRDs v1alpha1 depois que sua versão do Config Connector é atualizada para garantir que as respostas automáticas 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 fazer upgrade dos CRDs v1alpha1.

2. git checkout à 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 da CRD v1alpha1 que você quer instalar.

   2. Se você quiser atualizar 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.

Como desinstalar os CRDs v1alpha1

1. Exclua as respostas automáticas para CRDs v1alpha1 se você não precisar mais dos recursos subjacentes do Google Cloud. Caso contrário, pule esta etapa.

   Observação: as respostas automáticas são abandonadas quando as CRDs v1alpha1 são desinstaladas. Os recursos do Google Cloud correspondentes ainda existirão.

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 } ')
   

As CRDs v1alpha1 serão desinstaladas se o comando kubectl delete for concluído.