Estes passos são específicos das instalações do Istio no GKE, também conhecido como o "suplemento Istio".
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.
Identifique se o suplemento Istio está a ser usado
Existem dois caminhos possíveis para a migração, consoante a funcionalidade de injeção de gateway de entrada ou de sidecar do suplemento Istio esteja a ser usada no seu cluster.
Anteriormente, no passo de preparação, já identificou se o suplemento Istio está configurado. Pode executar o comando seguinte para verificar se o espaço de nomes
istio-system
existe:echo $INGRESS_NAMESPACE
Execute o seguinte comando para determinar se a funcionalidade de injeção de sidecar do suplemento Istio está a ser usada no seu cluster:
kubectl get ns -l istio-injection=enabled
Se estiver listado qualquer espaço de nomes que não seja
knative-serving
, indica que a injeção de sidecar do suplemento Istio está a ser usada.Por exemplo, se o comando apenas listar o espaço de nomes
knative-serving
, significa que não configurou nem usa a injeção de sidecar do suplemento Istio.
Resultados:
Um ou ambos usados: uma ou ambas as funcionalidades do suplemento Istio estão a ser usadas no seu cluster:
- É usado o serviço de entrada
istio-ingressgateway
do suplemento do Istio. - É usada a injeção de sidecar do suplemento Istio.
Passos seguintes: depois de seguir as instruções na secção seguinte para desinstalar o suplemento Istio, tem de avançar para o guia Cloud Service Mesh com o plano de controlo gerido.
- É usado o serviço de entrada
Não usado: nem a gateway de entrada nem a injeção de sidecar do suplemento do Istio estão configuradas para utilização no seu cluster. Por outras palavras, a sua instalação usa a "versão integrada do Istio".
Passos seguintes: depois de seguir as instruções na secção seguinte para desinstalar o suplemento Istio não usado, pode avançar para o guia Cloud Service Mesh com o plano de controlo no cluster.
Desinstale o suplemento Istio
Nesta secção, o script de migração é usado para desinstalar o "suplemento Istio".
Execute o seguinte comando para iniciar o script de migração:
./migration-addon.sh --command uninstall-istio-addon
Verifique se o espaço de nomes
istio-system
foi eliminado:kubectl get ns istio-system --ignore-not-found
O que se segue?
Consoante a configuração do gateway de entrada que identificou acima, continue para o guia de instalação correspondente:
Se identificou anteriormente que uma ou ambas as funcionalidades do "suplemento do Istio" foram configuradas e usadas no seu cluster, tem de avançar para o guia do Cloud Service Mesh com o plano de controlo gerido.
Se identificou anteriormente que nem o gateway de entrada nem a injeção de sidecar do "suplemento Istio" foram usados no seu cluster, então, a sua instalação usou realmente a "versão integrada do Istio". Agora, pode prosseguir com a instalação do Cloud Service Mesh com o plano de controlo no cluster.
Reversão
Se precisar de reverter as alterações que fez através dos passos acima, pode usar o script de migração para reativar o "suplemento Istio":
Execute o seguinte comando:
./migration-addon.sh --command rollback-uninstall-istio-addon
Para continuar a reverter as alterações ao estado original da instalação, reverta o "suplemento do GKE" do Knative Serving.