Migre o complemento do Istio para o Cloud Service Mesh

Essas etapas são específicas das instalações que identificaram que o gateway de entrada do Istio no GKE foi configurado no cluster. Neste processo, a versão 1.18 do Cloud Service Mesh é instalada com o plano de controle gerenciado.

Importante: se você instalou a versão em pacote do Istio incluída por padrão com o "complemento GKE", siga as etapas para migrar o Istio empacotado para o Cloud Service Mesh.

Antes de começar

• A migração do complemento do Istio requer que você use o Cloud Service Mesh com o plano de controle gerenciado pelo Google. Portanto, o plano de controle no cluster do Cloud Service Mesh não é uma opção de migração compatível.

• 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

Em geral, o processo de migração do "complemento do Istio" para o Cloud Service Mesh com o plano de controle gerenciado inclui:

1. Como instalar o plano de controle gerenciado do Cloud Service Mesh.
2. Use o script de migração para configurar o gateway de entrada do Cloud Service Mesh.

Migrar para o Cloud Service Mesh versão 1.18

Siga as instruções detalhadas no documento "Como migrar do Istio no GKE para o Cloud Service Mesh" do Cloud Service Mesh. Depois de concluir a instalação e migrar as cargas de trabalho, volte a esta página para concluir as etapas de configuração restantes.

1. Use as "Instruções de migração de complementos do Istio" para migrar a instalação para o Cloud Service Mesh com o plano de controle gerenciado pelo Google.

   Principais itens que você precisa considerar durante esse processo:

   • Se a solicitação custom envoy filters are not supported for exibida Basta escolher "sim" para continuar a migração. Exemplo:

     Detected custom envoy filters are not supported by Cloud Service Mesh.
     Please remove these if possible
     NAMESPACE    NAME                                 AGE
     gke-system   allowconnect-cluster-local-gateway   26m
     Continue anyways? [y/N] Y
     

   • As instruções de migração incluem a seção Concluir uma migração bem-sucedida, que executa etapas para finalizar a instalação do Cloud Service Mesh. Importante: depois de executar essas etapas, não será mais possível reverter as alterações.

   Instruções de migração de complementos do Istio: Como migrar do Istio no GKE para o Cloud Service Mesh

2. Depois de concluir as etapas de migração e migrar sua carga de trabalho para o Cloud Service Mesh, execute os seguintes comandos para reiniciar e rotular seus pods de entrada no namespace knative-serving:

   1. Reinicie os pods de entrada:

      kubectl rollout restart deployment autoscaler activator webhook -n knative-serving
      

   2. Adicione o rótulo istio: ingressgateway:

      kubectl patch deployment ${INGRESS_NAME} --namespace ${INGRESS_NAMESPACE} --patch  '{"spec": {"template": {"metadata": {"labels": {"istio": "ingressgateway"}}}}}'
      

Configurar o Ingress do Cloud Service Mesh

Nesta seção, o script de migração é usado para definir o canal de lançamento como asm-managed-rapid para o plano de controle gerenciado do Cloud Service Mesh.

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

 ./migration-addon.sh \
 --asm-revision asm-managed-rapid \
 --command set-up-asm-ingress

A seguir

Instalar o componente de frota

Reverter

Se precisar reverter as alterações feitas por meio das etapas acima, você poderá fazer o seguinte:

• Use o script de migração para excluir a entrada do Cloud Service Mesh.
• Reverta a instalação do Cloud Service Mesh.

Para reverter a instalação e a configuração do Cloud Service Mesh com o plano de controle gerenciado pelo Google:

1. Execute o seguinte comando para excluir a entrada do Cloud Service Mesh:

   ./migration-addon.sh --command rollback-set-up-asm-ingress
   

   A saída do terminal durante o processo é semelhante a esta:

   Deleting Cloud Service Mesh ingress
   deployment.apps "istio-ingressgateway" deleted
   horizontalpodautoscaler.autoscaling "istio-ingressgateway" deleted
   role.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
   rolebinding.rbac.authorization.k8s.io "istio-ingressgateway-sds" deleted
   Cloud Service Mesh ingress is successfully deleted.
   

2. Para verificar a reversão, verifique se o serviço istio-ingressgateway não existe mais no namespace gke-system:

   kubectl get deployment istio-ingressgateway -n gke-system
   

3. Reverter a instalação do Cloud Service Mesh

4. Execute o seguinte comando para reativar o "complemento do Istio":

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

5. Para continuar revertendo as alterações para o estado original da instalação, reverta o complemento Istio.