Desinstale o suplemento do GKE Knative serving

Desinstale o "suplemento do GKE" do Knative Serving do cluster, incluindo recursos e etiquetas relacionados.

Nesta tarefa, o script de migração é usado para remover apenas o "suplemento do GKE" do seu cluster. Todos os seus recursos de serviço do Knative existentes permanecem no cluster e continuam a servir tráfego.

Antes de começar

• Primeiro, tem de rever e garantir que cumpre os requisitos para a atualização.

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

• É importante que execute cada passo deste processo na ordem especificada.

Vista geral

A desinstalação do suplemento do GKE inclui o seguinte:

1. Validar se o conjunto de nós cumpre os requisitos para a atualização.
2. Aplicar etiquetas de migração e criar o webhook de admissão ValidatingWebhookConfiguration para impedir que os seus recursos de apresentação do Knative sejam eliminados nos seguintes espaços de nomes:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Desinstalar o "suplemento do GKE", incluindo a remoção das etiquetas do gestor relacionadas dos recursos de publicação do Knative.

   Tenha em atenção que este processo pode ser executado durante mais de 10 minutos.

4. Adicionar as anotações appdevexperience-operator.

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

Nota: embora o tráfego para os seus serviços permaneça inalterado, o nó do plano de controlo do GKE ("master") é atualizado e, por isso, fica temporariamente indisponível durante o processo. Todas as operações que requerem acesso ao plano de controlo do GKE, como operações de recursos do Kubernetes, como eliminar, atualizar ou criar, não ocorrem até a atualização ser concluída.

Desinstale o suplemento do GKE Knative serving

Nesta secção, o script de migração é usado para desinstalar o "suplemento 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 pede a sua confirmação para realizar cada ação. Introduza y para iniciar o processo e também para continuar em cada comando.

   As instruções durante o processo de desinstalação do "suplemento 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 "suplemento 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 é devolvido se o "suplemento do GKE" tiver sido removido com êxito do seu cluster.

O que se segue?

Migre para o Cloud Service Mesh

Reversão

Se precisar de reverter as alterações que fez através dos passos acima, pode usar o script de migração para:

• Reative o "suplemento do GKE" do Knative Serving.
• Remova 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 pede a sua confirmação para realizar cada ação. Introduza y em cada comando para continuar.

   As instruções durante o processo de reativação do "suplemento do GKE" são semelhantes às seguintes:

   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 "suplemento do GKE" do Knative Serving está novamente ativado:

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

   Se o suplemento estiver em execução no cluster, são devolvidos os detalhes de configuração do suplemento. Exemplo:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL