Como atualizar um cache existente do Redis 4 para o Redis 6

  • Artigo

O Cache do Azure para Redis dá suporte à atualização da versão do Cache do Azure para Redis do Redis 4 para o Redis 6. A atualização é semelhante à manutenção mensal comum. A atualização segue o mesmo padrão que a manutenção: primeiro, a versão do Redis no nó de réplica é atualizada. Depois, uma atualização do nó primário é realizada. Seu aplicativo cliente deve tratar a operação de atualização exatamente como um evento de manutenção planejada.

Como uma etapa de precaução, recomendamos exportar os dados do cache Redis 4 existente e testar seu aplicativo cliente com um cache Redis 6 em um ambiente com versão anterior antes da atualização.

Para obter mais informações sobre como exportar, confira Importar e exportar dados no Cache do Azure para Redis.

Importante

Conforme anunciado em O que há de novo, vamos desativar a versão 4 para instâncias de Cache do Azure para Redis em 30 de junho de 2023. Antes dessa data, você precisa atualizar qualquer uma das instâncias de cache para a versão 6.

Para obter mais informações sobre a desativação do Redis 4, confira Desativações e Perguntas frequentes

Pré-requisitos

Limitações

  • Quando você atualiza um cache na camada Básica, ele fica indisponível por vários minutos e resulta em perda de dados.
  • Não há suporte para a atualização em cache replicado geograficamente. Você deve desvincular manualmente as instâncias de cache antes de atualizar.
  • Não há suporte para atualização de um cache com uma dependência de Serviços de Nuvem. Você deve migrar sua instância de cache para o conjunto de dimensionamento de máquinas virtuais antes de atualizar.
  • Ao tentar atualizar para o Redis 6, sua VNet deve ser configurada de acordo com os requisitos. Se não for configurada corretamente, o upgrade poderá falhar ou o cache poderá não funcionar adequadamente após o upgrade.

Verificar a versão de um cache

Antes de atualizar, verifique a versão Redis de um cache selecionando Propriedades no menu Recurso do Cache do Azure para Redis. Recomendamos que você use o Redis 6.

Screenshot of properties selected in the Resource menu.

Atualizar usando o portal do Azure

  1. No portal do Azure, selecione a instância de Cache do Azure para Redis que você deseja atualizar do Redis 4 para o Redis 6.

  2. No lado esquerdo da tela, selecione Configurações avançadas.

  3. Se sua instância de cache estiver qualificada para ser atualizada, você deverá ver a faixa azul a seguir. Se você quiser continuar, selecione o texto na faixa.

    Screenshot informing you that you can upgrade your cache to Redis 6 with more features. Upgrading your cache instance can't be reversed.

  4. Uma caixa de diálogo exibirá um pop-up notificando você de que a atualização é permanente e pode causar uma breve falha na conexão. Selecione Sim se você quiser atualizar sua instância de cache.

    Screenshot showing a dialog with more information about upgrading your cache with Yes selected.

  5. Para verificar o status da atualização, navegue até Visão geral.

    Screenshot showing Overview in the Resource menu. Status shows cache is being upgraded.

Atualizar usando a CLI do Azure

Para atualizar um cache de 4 para 6 usando a CLI do Azure que não está usando o Ponto de Extremidade Privado, use o comando a seguir.

az redis update --name cacheName --resource-group resourceGroupName --set redisVersion=6

Ponto de extremidade privado

Se o ponto de extremidade privado estiver habilitado no cache, use o comando apropriado com base em se PublicNetworkAccess está habilitado ou desabilitado:

Se PublicNetworkAccess estiver habilitado:

 az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Enabled redisVersion=6

Se PublicNetworkAccess estiver desabilitado:

az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Disabled redisVersion=6

Atualizar usando o PowerShell

Para atualizar um cache de 4 para 6 usando o PowerShell, use o seguinte comando:

Set-AzRedisCache -Name "CacheName" -ResourceGroupName "ResourceGroupName" -RedisVersion "6"

Próximas etapas