Essas etapas são específicas das instalações do Istio no GKE, também chamadas de complemento do Istio.
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.
Identificar se o complemento Istio está em uso
Há dois caminhos possíveis para a migração, dependendo se o gateway de entrada ou o recurso de injeção de sidecar do complemento do Istio está em uso no cluster.
Anteriormente na etapa de preparação, você já identificou se o complemento do Istio está configurado. Execute o seguinte comando para verificar se o namespace
istio-system
existe:echo $INGRESS_NAMESPACE
Execute o seguinte comando para determinar se o recurso de injeção do sidecar no Complemento do Istio está em uso no cluster:
kubectl get ns -l istio-injection=enabled
Se algum namespace diferente de
knative-serving
estiver listado, isso indicará que a injeção de sidecar do complemento do Istio está em uso.Por exemplo, quando o comando lista apenas o namespace
knative-serving
, a injeção de sidecar do complemento do Istio não foi configurada e não está sendo usada.
Resultados:
Um ou ambos usados: um ou os dois recursos do complemento do Istio estão em uso no cluster:
- O serviço de entrada
istio-ingressgateway
do complemento do Istio é usado. - A injeção de sidecar do complemento do Istio é usada.
Próximas etapas: depois de seguir as instruções na próxima seção para desinstalar o complemento do Istio, prossiga para o Cloud Service Mesh com o guia de plano de controle gerenciado.
- O serviço de entrada
Não usado: nem o gateway de entrada nem a injeção de arquivo secundário do complemento do Istio são configurados para uso no cluster. Em outras palavras, a instalação usa a "versão agrupada do Istio".
Próximas etapas: depois de seguir as instruções na próxima seção para desinstalar o complemento Istio não usado, prossiga para o Cloud Service Mesh com o guia de plano de controle no cluster.
Desinstalar o complemento Istio
Nesta seção, o script de migração é usado para desinstalar o complemento do Istio.
Execute o seguinte comando para iniciar o script de migração:
./migration-addon.sh --command uninstall-istio-addon
Verifique se o namespace
istio-system
foi excluído:kubectl get ns istio-system --ignore-not-found
A seguir
Dependendo da configuração do gateway de entrada identificada acima, continue com o guia de instalação correspondente:
Se você tiver identificado anteriormente que um ou ambos os recursos do complemento do Istio foram configurados e usados no cluster, será necessário prosseguir para o Cloud Service Mesh com o guia de plano de controle gerenciado.
Se você identificado anteriormente que nem o gateway de entrada nem a injeção de sidecar do "complemento do Istio" foram usados no cluster, sua instalação realmente usou a versão "empacotada" Istio). Agora é possível instalar o Cloud Service Mesh com o plano de controle no cluster.
Reversão
Se você precisar reverter as alterações feitas por meio das etapas acima, use o script de migração para reativar o complemento do Istio:
Execute este comando:
./migration-addon.sh --command rollback-uninstall-istio-addon
Para continuar revertendo as alterações para o estado original da instalação, reverta o "complemento do GKE" do Knative serving.