Share via

Como atualizar uma cache Redis 4 existente para Redis 6

  • Artigo

A Cache do Azure para Redis suporta a atualização da versão do Redis 4 para o Redis 6. A atualização é semelhante à manutenção mensal normal. A atualização segue o mesmo padrão que a manutenção: primeiro, a versão do Redis no nó de réplica é atualizada, seguida de uma atualização para o nó principal. A aplicação cliente deve tratar a operação de atualização exatamente como um evento de manutenção planeada.

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

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

Importante

Conforme anunciado em Novidades, desativaremos a versão 4 para instâncias do Cache do Azure para Redis em 30 de junho de 2023. Antes dessa data, você precisa atualizar qualquer uma das suas instâncias de cache para a versão 6.

Para obter mais informações sobre a aposentadoria do Redis 4, consulte Aposentadorias e perguntas frequentes

Pré-requisitos

Limitações

  • Quando você atualiza um cache na camada Basic, ele fica indisponível por vários minutos e resulta em perda de dados.
  • Não há suporte para atualização em cache replicado geograficamente. Você deve desvincular manualmente as instâncias de cache antes de atualizar.
  • Não há suporte para a atualização de um cache com uma dependência dos Serviços de Nuvem. Deve migrar a instância de cache para o Conjunto de Dimensionamento de Máquinas Virtuais antes de atualizar.
  • Ao tentar atualizar para o Redis 6, sua rede virtual deve ser configurada de acordo com os requisitos. A atualização pode falhar ou o cache pode não funcionar corretamente após a atualização, se não estiver configurado corretamente.

Verifique 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 Redis 6.

Screenshot of properties selected in the Resource menu.

Atualizar com o portal do Azure

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

  2. No lado esquerdo do ecrã, selecione Definições avançadas.

  3. Se sua instância de cache estiver qualificada para ser atualizada, você verá o seguinte banner azul. Se quiser continuar, selecione o texto no banner.

    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 exibe um pop-up notificando que a atualização é permanente e pode causar um breve erro de conexão. Selecione Sim se 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 seguinte comando.

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

Ponto Final Privado

Se o Ponto de Extremidade Privado estiver habilitado no cache, use o comando apropriado com base no fato de estar PublicNetworkAccess habilitado ou desabilitado:

Se PublicNetworkAccess estiver ativado:

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

Se PublicNetworkAccess estiver desativado:

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

Atualizar com 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óximos passos