Como instalar CRDs v1alpha1 do Config Connector

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

Aviso: os CRDs de recursos do Config Connector v1alpha1 Google Cloud não devem ser usados em 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, já que eles não são gerenciados pelo operador do Config Connector nem 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
   

   Você também pode procurar os manifestos de CRD no diretório config/crds/resources no GitHub.

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 config/crds/resources
   

   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 quiser instalar todos os CRDs v1alpha1, execute o seguinte comando:

      kubectl apply $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.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 atuais 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 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 config/crds/resources
   

   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 fazer upgrade.

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

      kubectl apply $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.yaml | awk ' { print " -f " $1 } ')
      

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

Desinstalar os CRDs v1alpha1

1. Exclua as 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 o check-out da sua 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 config/crds/resources
   kubectl delete $(grep -l "cnrm.cloud.google.com/stability-level: alpha" *.yaml | awk ' { print " -f " $1 } ')
   

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