Migrar suas cargas de trabalho do Redis e do Valkey para o Memorystore for Valkey

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O Memorystore oferece suporte à migração automatizada das cargas de trabalho autogerenciadas do Redis e do Valkey para o Memorystore for Valkey. Usar esse recurso permite fazer uma transição tranquila do fardo operacional de gerenciar sua própria infraestrutura. Ao migrar para um ambiente totalmente gerenciado no Memorystore para Valkey, você elimina a necessidade de aplicação manual de patches no SO, configuração de replicação e scripts de backup personalizados. Além disso, você ganha recursos de failover automático e segurança nativa da VPC, além da capacidade de escalonar para centenas de nós com um tempo de inatividade quase nulo.

Ao migrar suas cargas de trabalho autogerenciadas para o Memorystore for Valkey, você aproveita as seguintes vantagens que eliminam as tarefas repetitivas operacionais e modernizam sua infraestrutura de banco de dados:

• Elimine sua sobrecarga operacional: transfira tarefas manuais e demoradas para o Google Cloud, como aplicação de patches no SO, monitoramento de infraestrutura, scripts de backup e gerenciamento de replicação. Assim, você pode se concentrar no desenvolvimento de aplicativos em vez da manutenção do banco de dados.
• Alcance alta disponibilidade de nível empresarial: aproveite um SLA de 99,99% totalmente gerenciado. O Memorystore para Valkey oferece failover automático e recursos integrados de backup e restauração. Isso protege seus aplicativos contra falhas inesperadas de nós e garante uma recuperação rápida de desastres.
• Escalonamento com tempo de inatividade quase zero: escalone suas instâncias para cima ou para baixo para corresponder a picos de tráfego imprevisíveis de forma dinâmica. É possível expandir para centenas de nós (até 250 shards) sem problemas e sem tirar os aplicativos do ar.
• Melhore sua segurança: substitua regras de rede complexas e configuradas manualmente por conectividade VPC integrada e segura e controles de acesso granulares baseados no Identity and Access Management (IAM). Isso garante que os limites de segurança estritos doGoogle Cloudprotejam seus dados.
• Consolide e faça upgrade das suas instâncias: mescle suas instâncias dispersas, isoladas e autogerenciadas em uma única implantação de alta performance no Memorystore para Valkey sem esforço. Como parte dessa migração, você também pode fazer upgrade automático das versões desatualizadas do Redis ou do Valkey para as versões mais recentes com suporte.
• Aproveite a análise avançada em tempo real e a IA generativa: faça a transição para um ambiente otimizado que oferece latências de microssegundos para gerenciamento de cache e de sessão. Para impulsionar seus aplicativos de IA generativa, você tem acesso imediato e gerenciado a recursos avançados, como a pesquisa vetorial.

Compatibilidade das versões

A tabela nesta seção lista as seguintes informações sobre as instâncias autogerenciadas do Redis e do Valkey de origem e as instâncias de destino no Memorystore for Valkey:

• Os tipos e versões das instâncias de origem compatíveis com a migração
• As versões das instâncias de destino do Memorystore for Valkey para as quais você pode migrar suas cargas de trabalho

Tipo de instância de origem	Versão da instância de origem	Versão da instância de destino
Redis	3.2.x - 7.2.x	Valkey 7.2, 8.0 e 9.0
Valkey	7.x, 8.x e 9.x	Valkey 7.2, 8.0 e 9.0

Importante: a versão da instância de destino precisa ser igual ou mais recente que a versão da instância de origem. Não é possível fazer downgrade da instância de destino para uma versão anterior.

Antes de começar

Antes de começar a migrar suas cargas de trabalho, conclua os pré-requisitos nesta seção.

Use o console Google Cloud , a Google Cloud CLI e as APIs

Para usar o console Google Cloud , a CLI gcloud e as APIs, faça o seguinte:

1. No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

   Acessar o seletor de projetos

2. Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.

3. Instale e inicialize a Google Cloud CLI.

   Observação:se você já instalou a CLI gcloud anteriormente, execute gcloud components update para verificar se você tem a versão mais recente. É necessário ter pelo menos a versão 489.0.0 da CLI gcloud para acessar os comandos da CLI gcloud do Memorystore para Valkey.

4. Ative a API Memorystore for Valkey.
   API Memorystore for Valkey
5. Ative a API Network Connectivity.
   API Network Connectivity
6. Ative a API Service Consumer Management.
   API Service Consumer Management
7. Ative a API Compute Engine.
   API Compute Engine

Atribuir papéis e permissões

Para realizar todas as operações de migração das cargas de trabalho das instâncias autogerenciadas do Redis e do Valkey para o Memorystore for Valkey, peça ao administrador para conceder a você o papel do IAM de Administrador do Memorystore (roles/memorystore.admin) no projetoGoogle Cloud .

Para criar e visualizar anexos de rede, peça ao administrador para conceder a você o papel do IAM de administrador da rede do Compute (roles/compute.networkAdmin) no seu projeto.

Fluxo de trabalho para migrar suas cargas de trabalho

Para migrar as cargas de trabalho das suas instâncias autogerenciadas do Redis e do Valkey para o Memorystore for Valkey, faça o seguinte:

1. Prepare a instância de origem: configure sua instância autogerenciada do Redis ou do Valkey para permitir conexões seguras e replicação de saída para o Memorystore para Valkey.
2. Prepare a instância de destino: determine as especificações necessárias da instância, como contagem de fragmentos e tipo de nó.
3. Crie a instância de destino: provisione a instância do Memorystore para Valkey que vai receber os dados migrados.
4. Configure um anexo de rede: configure um anexo de rede. Esse anexo permite que a instância de destino na rede VPC do produtor inicie conexões com a instância de origem que está sendo executada na rede VPC do consumidor. Como resultado, a replicação é estabelecida.
5. Iniciar a migração: inicie o processo de sincronização. A instância de destino se conecta automaticamente à instância de origem e começa a replicar seus dados continuamente como uma réplica de leitura.
6. Monitore a migração: verifique se ela está progredindo sem problemas e se o status é HEALTHY.
7. Conclua a migração: transfira o tráfego do aplicativo para a instância de destino.

Preparar a instância de origem

Prepare sua instância autogerenciada do Redis ou do Valkey para migrar suas cargas de trabalho para uma instância de destino do Memorystore para Valkey.

Para permitir conexões dos nós da instância de destino aos nós da instância de origem, faça o seguinte:

• Se o protected-mode estiver ativado nos nós de origem, desative-o.
• Se você configurou os nós de origem com uma diretiva bind explícita, atualize os nós para permitir conexões de entrada dos nós de destino. Os nós de destino iniciam conexões dos endereços IP na sub-rede do anexo de rede.
• Atualize as regras de firewall que possam bloquear conexões de entrada dos nós de destino.
• Se a autenticação e Transport Layer Security (TLS) estiverem ativadas nos nós de origem, desative-as.

Para ativar a replicação dos nós da instância de destino para os nós da instância de origem, faça o seguinte:

• Não renomeie nenhum comando do Valkey ou do Redis necessário para migração ou modificação de dados (por exemplo, PING, PSYNC e HSET).
• Verifique se a instância de origem tem memória e capacidade de CPU suficientes para gerenciar a carga de replicação adicional originada dos nós da instância de destino.

Importante: anote o endereço IP e o número da porta da instância de origem. Você precisa dessas informações para iniciar o processo de migração.

Além disso, o Memorystore para Valkey precisa se comunicar com esse endereço IP e porta durante todo o processo de migração. O Memorystore para Valkey usa o endereço IP e a porta para descobrir automaticamente os outros nós na topologia da instância.

Preparar a instância de destino

Para garantir um processo de replicação tranquilo, dimensione a instância de destino do Memorystore para Valkey de forma adequada para processar a carga de trabalho recebida da instância de origem. Para isso, determine as especificações exatas da instância de destino. Essas especificações incluem a compatibilidade com a instância de origem, o tipo de modo de cluster, o número de bancos de dados, a contagem de fragmentos, a versão e o tipo de nó da instância de destino.

Para preparar a instância de destino, use as seguintes diretrizes:

• Compatibilidade com a instância de origem: as instâncias de origem e de destino precisam estar no mesmo projeto e região.
• Modo de cluster: o modo de cluster da instância de destino precisa corresponder ao modo de cluster da instância de origem. Se a instância de origem estiver com o modo de cluster desativado, a instância de destino também precisará estar. Caso contrário, a instância de destino precisa estar com o modo de cluster ativado.
• Número de bancos de dados: se a instância de destino estiver com o modo de cluster desativado, o número de bancos de dados lógicos na instância precisará ser igual ou maior que o número de bancos de dados na instância de origem.
• Contagem de fragmentos: se a instância de destino estiver com o modo de cluster ativado, o número de fragmentos na instância de destino precisará ser idêntico ao número de fragmentos na instância de origem. No entanto, o número de réplicas nas instâncias de origem e de destino pode ser diferente.
• Versão da instância: a versão da instância de destino precisa ser compatível com a versão da instância de origem. Para mais informações, consulte Suporte de versões.
• Versão de manutenção: a versão de manutenção da instância de destino precisa ser MEMORYSTORE_20260313_01_00 ou mais recente. Para mais informações, consulte Sobre a manutenção.
• Tipo de nó: o tipo de nó na instância de destino precisa ser grande o suficiente para processar os dados recebidos dos nós da instância de origem. Para mais informações sobre os tipos de nós que podem ser selecionados para a instância de destino e a capacidade do keyspace correspondente para cada tipo de nó, consulte Especificação do tipo de nó.

Importante: não é possível usar instâncias de replicação entre regiões como instâncias de destino. Além disso, verifique se o Memorystore for Valkey não bloqueia nenhum dos comandos usados na instância de origem.

Criar a instância de destino

Se você não tiver uma instância de destino que atenda aos requisitos para receber dados migrados da instância de origem, crie uma.

É possível criar essa instância usando o console do Google Cloud ou a CLI gcloud.

Importante: antes de criar a instância de destino, leia as diretrizes em Preparar a instância de destino.

Console

Para criar a instância de destino, consulte Criar instâncias.

gcloud

Para criar a instância de destino, consulte Criar instâncias.

Configurar um anexo de rede

Para migrar as cargas de trabalho de uma instância de origem para uma de destino, os nós da instância de destino precisam estabelecer uma conexão com os nós da instância de origem. Como resultado, os dados na instância de origem podem ser replicados para a instância de destino.

Para que essa conexão e replicação ocorram, use um anexo de rede. As tentativas de conexão dos nós de destino se originam da sub-rede na rede VPC da instância de origem vinculada ao anexo de rede.

Você pode usar um anexo de rede que atenda aos seguintes requisitos:

• Ele precisa estar no mesmo projeto e região que a instância de destino.
• A sub-rede precisa estar na mesma rede VPC da instância de origem.
• A sub-rede na instância de origem precisa ter um intervalo CIDR de IP adequado, com suporte para um mínimo de N+1 endereços IP utilizáveis (em que N é o número de nós na instância de destino). Por exemplo, se uma instância de destino tiver três shards e uma réplica, ela terá seis nós: três para a instância principal e três para a réplica. Portanto, você precisa de pelo menos sete endereços IP.
• O intervalo de sub-redes não pode se sobrepor a 10.0.0.0/23 porque ele é reservado para o Memorystore para Valkey.

Se o anexo de rede não atender a esses requisitos ou se você não tiver um, crie um.

Iniciar a migração

Ao iniciar a migração, a instância de destino estabelece a replicação com a instância de origem. Todos os dados gravados na instância de origem são replicados automaticamente na instância de destino. A instância de destino se torna uma réplica de leitura da instância de origem.

É possível iniciar a migração usando o console do Google Cloud ou a CLI gcloud.

Importante: antes de iniciar a migração, revise as diretrizes em Configurar um anexo de rede. Além disso, depois de iniciar a migração, não faça operações de migração de slot na instância de origem até concluir a migração.

Console

1. No console Google Cloud , acesse a página Memorystore para Valkey.

   Memorystore for Valkey

2. Clique no ID da instância de destino.

3. Na página Visão geral da instância, clique em Iniciar migração.

4. Na janela Migrar instâncias autogerenciadas do Redis e do Valkey, faça o seguinte:

5. Na guia Preparar, leia as informações sobre os pré-requisitos da instância de origem e as diretrizes para a vinculação de rede. Em seguida, clique em Continuar.

6. Na guia Conectar, faça o seguinte:

   1. Digite o Endereço IP e a Porta da instância de origem. Você anotou essas informações em Preparar a instância de origem.
   2. Selecione o anexo de rede que você quer usar para migrar dados.
   3. Clique em Continuar.

7. Na guia Revisar, confira as informações associadas ao processo de migração. Essas informações incluem o ID da instância de destino, o endereço IP e a porta da instância de origem e o nome do anexo de rede. Depois de analisar essas informações, clique em Iniciar migração.

8. Na página Visão geral da instância, verifique se o status Migrando aparece.

Se os nós da instância de destino não puderem se conectar aos nós da instância de origem ou se os dados da instância de origem não puderem ser replicados na instância de destino, a migração vai falhar.

Quando isso acontece, o Memorystore for Valkey reverte a instância de destino para o estado em que ela estava antes do início do processo de migração. O status da instância de destino volta para Pronto, e a instância tem recursos de leitura e gravação novamente.

Depois de resolver os problemas que causaram a falha na migração, você pode iniciar a migração novamente.

gcloud

Para iniciar a migração, use o comando gcloud beta memorystore instances start-migration.

gcloud beta memorystore instances start-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION \
--source-ip=SOURCE_IP_ADDRESS \
--source-port=SOURCE_PORT \
--network-attachment=projects/NETWORK_ATTACHMENT_PROJECT_ID/locations/NETWORK_ATTACHMENT_REGION/networkAttachments/NETWORK_ATTACHMENT_ID

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância de destino.
• PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância de destino.
• REGION: a região em que a instância de destino está localizada.
• SOURCE_IP_ADDRESS: o endereço IP da instância de origem. Você anotou esse endereço IP em Preparar a instância de origem.
• SOURCE_PORT: o número da porta da instância de origem. Você anotou essa porta em Preparar a instância de origem.
• NETWORK_ATTACHMENT_PROJECT_ID: o ID ou número do projeto do projetoGoogle Cloud , que contém o anexo de rede que você quer usar para migrar dados.
• NETWORK_ATTACHMENT_REGION: a região em que o anexo de rede está localizado.
• NETWORK_ATTACHMENT_ID: o ID do anexo de rede.

Para confirmar que a migração foi iniciada, use o comando gcloud memorystore instances describe.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Verifique se um status MIGRATING aparece ao lado do parâmetro state.

Se os nós da instância de destino não puderem se conectar aos nós da instância de origem ou se os dados da instância de origem não puderem ser replicados na instância de destino, a migração vai falhar.

Quando isso acontece, o Memorystore for Valkey reverte a instância de destino para o estado em que ela estava antes do início do processo de migração. O status da instância de destino volta a ser ACTIVE, e a instância tem recursos de leitura e gravação novamente.

Depois de resolver os problemas que causaram a falha na migração, você pode iniciar a migração novamente.

Monitorar a migração

Para garantir que a migração esteja progredindo sem problemas, monitore o processo nas instâncias de origem e de destino.

Monitorar a instância de origem

Na instância de origem, verifique se o uso do buffer de saída do cliente permanece baixo nos nós de origem. O uso baixo e constante indica um atraso mínimo e uma sincronização bem-sucedida dos dados da instância de origem para a de destino.

Monitorar a instância de destino

Para cada nó principal na instância de destino, verifique se o status da métrica Status da migração de nós é HEALTHY. Esse status indica que os links de replicação entre os fragmentos das instâncias de origem e de destino estão íntegros e ativos.

É possível monitorar a migração da instância de destino usando o console doGoogle Cloud . Para verificar o valor da métrica Status da migração do nó de cada nó principal da instância de destino, faça o seguinte:

1. No console do Google Cloud , acesse a página do Metrics explorer.

   Metrics Explorer

2. No menu Métrica, selecione Status da migração do nó. Para fazer isso, selecione Nó da instância do Memorystore > Instância > Status da migração do nó e clique em Aplicar.

3. No campo Filtro, adicione os seguintes filtros:

   • instance_id = (equals) INSTANCE_ID
   • role = (equals) primary
   • status != (does not equal) HEALTHY

   Substitua INSTANCE_ID pelo ID da instância de destino.

   Ao adicionar esses filtros, você pode monitorar os nós principais da instância de destino para verificar se algum deles não está íntegro. Se nenhum nó aparecer, todos os nós estarão íntegros, e você poderá concluir a migração.

Concluir a migração

Quando estiver tudo pronto para transferir o tráfego do aplicativo para a instância de destino, conclua a migração. Assim, os nós da instância de destino não replicam mais com os nós da instância de origem. A instância de destino permite todas as operações de leitura e gravação.

É possível concluir a migração usando o console do Google Cloud ou a CLI gcloud.

Importante: por padrão, o Memorystore para Valkey garante que a instância de destino esteja totalmente atualizada com a instância de origem até o momento em que você concluir a migração. As gravações na instância de origem depois da conclusão da migração podem não ser replicadas.

Se você quiser uma consistência total de dados entre as instâncias de origem e de destino, e sem perda de dados, pare todas as operações de gravação na instância de origem antes de concluir a migração.

Console

1. No console Google Cloud , acesse a página Memorystore para Valkey.

   Memorystore for Valkey

2. Clique no ID da instância de destino.

3. Na página Visão geral da instância, clique em Concluir migração.

4. Na caixa de diálogo Concluir migração, faça o seguinte:

   1. Se você quiser garantir que todos os dados na instância de origem sejam replicados na instância de destino, selecione Padrão.

      Cuidado: se você quiser transferir o tráfego do aplicativo para a nova instância de destino imediatamente, selecione Forçar (ignorar sincronização). No entanto, se você fizer essa seleção, talvez o Memorystore para Valkey não consiga replicar todos os dados da instância de origem para a de destino.

   2. No campo de texto ID da instância, insira o ID da instância de destino.

   3. Clique em Concluir migração.

5. Na página Visão geral da instância, verifique se o status Migrado aparece.

Importante: depois de concluir a migração, atualize os arquivos de configuração do aplicativo para direcionar todo o tráfego à instância de destino.

gcloud

Para concluir a migração, use o comando gcloud beta memorystore instances finish-migration.

gcloud beta memorystore instances finish-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância de destino
• PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância de destino
• REGION: a região em que a instância de destino está localizada

Cuidado: se você quiser transferir o tráfego do aplicativo para a nova instância de destino imediatamente, use o parâmetro --force. No entanto, ao usar esse parâmetro, talvez o Memorystore para Valkey não consiga replicar todos os dados da instância de origem para a de destino.

Para confirmar que a migração foi concluída com sucesso, use o comando gcloud memorystore instances describe.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Verifique se um status MIGRATED aparece ao lado do parâmetro state.

Importante: depois de concluir a migração, atualize os arquivos de configuração do aplicativo para direcionar todo o tráfego à instância de destino.