Ao atualizar o campo spec de um recurso do Istio, o ASM registra o histórico de versões e armazena até as cinco versões mais recentes. Este tópico usa um VirtualService como exemplo para demonstrar como reverter um recurso do Istio para uma versão anterior.
Pré-requisitos
Você criou uma instância do ASM da versão 1.9.7.92 ou posterior. Para mais informações, consulte Crie an ASM instance e Upgrade an ASM instance.
Você criou um VirtualService. Para mais informações, consulte Gerencie virtual services.
Informações de contexto
Os recursos do Istio incluem os itens em Traffic Management no console do ASM, como VirtualService, destination rule, gateway, service entry, Envoy filter, workload group, workload entry e Sidecar. Eles também abrangem os recursos em Zero Trust Security, como request authentication policy, peer authentication policy e authorization policy.
Etapa 1: Ativar o histórico de versões
Ative o recurso de histórico de versões de recursos do Istio de uma das seguintes formas:
Para uma nova instância do ASM: Selecione Enable Istio custom resource version control ao criar a instância do ASM.
Para uma instância do ASM existente: Ative o recurso na página Basic Information da instância.
Faça login no console do ASM. No painel de navegação à esquerda, escolha .
Na página Mesh Management, clique em nome da instância do ASM. No painel de navegação à esquerda, escolha .
Na página Basic Information, clique em Settings. No painel Settings Update, selecione Enable Istio custom resource version control e clique em OK.
Etapa 2: Gerar uma versão histórica
O ASM registra uma nova versão histórica apenas quando você modifique o campo spec de um recurso do Istio. Alterações em outros campos não geram novas versões.
Faça login no console do ASM. No painel de navegação à esquerda, escolha .
Na página Mesh Management, clique em nome da instância do ASM. No painel de navegação à esquerda, escolha .
Na página Virtual Service, clique em View YAML na coluna Actions do VirtualService de destino.
Na caixa de diálogo Edit, modifique o conteúdo no campo
spec(por exemplo, altere onumberda porta de9080para9081) e clique em OK.
Etapa 3: Reverter o VirtualService
Este exemplo demonstra como reverter o VirtualService de destino para a versão v2.
Faça login no console do ASM. No painel de navegação à esquerda, escolha .
Na página Mesh Management, clique em nome da instância do ASM. No painel de navegação à esquerda, escolha .
Na página Virtual Service, clique em Version na coluna Actions do VirtualService de destino.
-
Na caixa de diálogo Version, localize a versão v2. Clique em View na coluna Actions e, em seguida, clique em Rollback.
Verifique o rollback, retorne à página Virtual Service e clique em View YAML na coluna Actions do VirtualService de destino. Na caixa de diálogo Edit, você verá que o conteúdo YAML foi restaurado para a versão v2.
Perguntas frequentes
Por que a opção Version está ausente?
Para usar o recurso de reversão de versão, certifique-se de que sua instância do ASM seja da versão 1.9.7.92 ou posterior e de que o recurso de histórico de versões de recursos do Istio esteja ativado.
O histórico de versões é limitado às atualizações do console?
Não. O recurso de histórico de versões é independente de como você atualize os recursos. Após ativar o recurso, o ASM registra versões históricas para todas as atualizações em recursos do Istio.
Existem limitações no histórico de versões?
O ASM armazena até as cinco versões históricas mais recentes para cada recurso do Istio. Quando você modifique um recurso pela sexta vez, o ASM exclui automaticamente a versão mais antiga.
Por que o YAML registrado é diferente?
O ASM omite automaticamente valores padrão redundantes do arquivo YAML ao registrar uma versão histórica. Essa otimização não afeta o comportamento da versão ao restaurá-la. Por exemplo, o valor padrão do campo servers.tls no spec de um gateway é PASSTHROUGH. Se você defina explicitamente esse campo como PASSTHROUGH, o ASM considera a configuração redundante e não a inclui no histórico de versões.