Desinstalar o complemento Knative serving do GKE

Desinstale o complemento do GKE do Knative serving do seu cluster, incluindo recursos e rótulos relacionados.

Nesta tarefa, o script de migração é usado para remover apenas o "complemento do GKE" do cluster. Todos os recursos atuais do Knative serving permanecem no cluster e continuam veiculando tráfego.

Antes de começar

• Primeiro, leia e verifique se você atende aos requisitos de upgrade.

• Os comandos nesta página usam as variáveis de ambiente e o script de migração da etapa de preparação do upgrade.

• É importante que você execute cada etapa desse processo na ordem especificada.

Visão geral

Veja a seguir como desinstalar o complemento do GKE:

1. Validação de que o pool de nós atende aos requisitos de upgrade.
2. Como aplicar rótulos de migração e criar o webhook de admissão ValidatingWebhookConfiguration para evitar que os recursos do Knative serving sejam excluídos nos seguintes namespaces:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Desinstalação do complemento do GKE, incluindo a remoção dos rótulos de administrador relacionados dos recursos do Knative serving.

   Esse processo pode levar mais de 10 minutos.

4. Adição das anotações appdevexperience-operator.

5. Remoção do recurso cloudrun.operator.run.cloud.google.com obsoleto que não é usado com frotas.

Observação: ainda que o tráfego para seus serviços não seja afetado, o nó do plano de controle do GKE ("mestre") é atualizado e, portanto, fica temporariamente indisponível durante o processo. Qualquer operação que exija acesso ao plano de controle do GKE, como operações de recurso do Kubernetes, como exclusão, atualização ou criação, não ocorrerá até que a atualização seja concluída.

Desinstalar o complemento Knative serving do GKE

Nesta seção, o script de migração é usado para desinstalar o complemento do GKE.

1. Execute o seguinte comando para iniciar o script de migração:

   ./migration-addon.sh --command uninstall-cloudrun-addon
   

2. No terminal, o script de migração solicita sua confirmação para executar cada ação. Digite y para iniciar o processo e continuar a cada prompt.

   As solicitações durante o processo de desinstalação do complemento do GKE são semelhantes às seguintes:

   In this process, the script performs the following:
   1. Validating the node pool to make sure it meets the requirements for
      upgrading. Confirming node pool requirements for
      my-gcp-project/us-central1-c/my-gke-cluster...
   2. Applying the required migration labels
      namespace/knative-serving labeled
   3. Create a ValidatingWebhookConfiguration admission webhook to prevent
      the deletion of resources under the following namespaces:
      knative-serving, cloud-run-system, and gke-system
   Continue? [Y/n] y
   
   validatingwebhookconfiguration.admissionregistration.k8s.io/prevent-deletion-cloud-run-resources created
   ValidatingWebhookConfiguration prevent-deletion-cloud-run-resources for preventing deleting Knative serving resources is effective.
   
   4. Uninstall the Knative serving GKE add-on? Your
   Knative serving resources remain in your cluster.
   Continue? [Y/n] y
   
   Updating my-gke-cluster...
   
   5. Removing the add-on manager labels and adding the Operator related
     annotations. This step will take about 10 minutes.
   
   customresourcedefinition.apiextensions.k8s.io/certificates.networking.internal.knative.dev annotated
   
   6. Clean up unused stale Knative serving operator.
   
   cloudrun.operator.run.cloud.google.com "cloud-run" deleted
   No resources found
   
   Knative serving GKE add-on is successfully uninstalled.
   

3. Verifique se o "complemento do GKE" foi disabled executando o seguinte comando:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig.disabled)'
   

   True será retornado se o "complemento do GKE" tiver sido removido do cluster.

A seguir

Migrar para o Cloud Service Mesh

Reversão

Para reverter as alterações feitas por meio das etapas acima, use o script de migração para:

• Reativar o "complemento do GKE" do Knative serving.
• Remover o webhook de admissão ValidatingWebhookConfiguration.

Para iniciar o processo de reversão:

1. Execute o seguinte comando para iniciar o script de migração:

   ./migration-addon.sh --command rollback-uninstall-cloudrun-addon
   

2. No terminal, o script de migração solicita sua confirmação para executar cada ação. Insira y em cada comando para continuar.

   As solicitações durante o processo de reativação do "complemento do GKE" são semelhantes ao seguinte:

   In this step, the script performs the following:
     1. Enable Knative serving GKE add-on
     2. Remove the ValidatingWebhookConfiguration added for uninstalling addon
   Continue? [Y/n] Y
   
   1. Enable Knative serving GKE add-on?
   Continue? [Y/n] Y
   
   Updating my-gke-cluster...done.
   Knative serving GKE add-on is enabled
   
   2. Remove the ValidatingWebhookConfiguration added for uninstalling addon?
   Continue? [Y/n] Y
   
   Removing the ValidatingWebhookConfiguration used to prevent deletion
   

3. Verifique se o complemento do GKE do Knative serving foi reativado:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig)'
   

   Se o complemento estiver em execução no cluster, os detalhes da configuração dele serão retornados. Exemplo:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL