Trabalhar com a replicação entre regiões

Observação: para criar um cluster secundário, é necessário ter uma política de rede de serviço na região em que você quer que o cluster esteja localizado. Para mais informações sobre políticas de rede de serviços, consulte Visão geral de rede.

Nesta página, descrevemos como usar a replicação entre regiões criando e trabalhando com clusters secundários.

Para uma visão geral conceitual da replicação entre regiões, consulte Sobre a replicação entre regiões.

Criar um cluster secundário

Ao criar um cluster secundário, o Memorystore para Redis Cluster copia e aplica algumas das configurações do cluster principal como configurações do cluster secundário. Para mais informações, consulte Configurações do cluster.

É possível criar um cluster secundário no Memorystore para Redis Cluster usando o consoleGoogle Cloud ou a Google Cloud CLI.

Console

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

   Memorystore for Redis Cluster

2. Clique em um cluster principal. O cluster principal é o pai do cluster secundário que você está criando.

   Observação: não clique em um cluster secundário porque o Memorystore para Redis Cluster não é compatível com réplicas em cascata. Além disso, não clique em um cluster principal se ele já tiver dois clusters secundários, porque um cluster principal não pode ter mais de dois clusters secundários.

   Se nenhum cluster principal aparecer, crie um. Depois de criar, clique nele.

3. No painel lateral, clique na guia Clusters secundários.

4. Clique em Adicionar cluster secundário.

5. Na janela Adicionar clusters secundários, faça as seguintes mudanças:

   1. No campo ID do cluster, insira o ID do cluster secundário que você está criando. O ID precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula, terminar com uma letra minúscula ou um número e ser exclusivo na região.

   2. No menu Região, selecione onde você quer que o cluster secundário fique.

   3. Na seção Disponibilidade por zona, selecione uma das seguintes opções:

      • Se você quiser que todos os fragmentos e réplicas do cluster sejam distribuídos em três zonas da região em que o Memorystore para Redis Cluster cria o cluster, selecione a opção Multizona.

        Por exemplo, se a região selecionada for us-central1 e você escolher a opção Várias zonas, o Memorystore para Redis Cluster vai distribuir os fragmentos e as réplicas do cluster nas zonas us-central1-a, us-central1-b e us-central1-c. Em caso de falha zonal, os nós do cluster fazem failover para as réplicas.

      • Se você quiser que todos os fragmentos e réplicas do cluster estejam localizados em uma zona da região em que o Memorystore para Redis Cluster cria o cluster, selecione a opção Zona única e escolha a zona no menu Zona.

        Ao usar uma única zona, você reduz os custos de rede. No entanto, em caso de falha zonal, o failover não ocorre.

   4. No menu Réplicas, selecione o número de réplicas (por fragmento) do cluster. Você pode ter zero, uma ou duas réplicas.

   5. No menu Rede, selecione uma rede para o cluster. Para mais informações sobre a rede do Memorystore for Redis Cluster, consulte Visão geral da rede.

6. Clique em Adicionar cluster secundário.

gcloud

Observação: se você instalou a CLI gcloud, verifique se tem a versão mais recente executando gcloud components update. Para gerenciar a replicação entre regiões do Memorystore for Redis Cluster, você precisa da CLI gcloud versão 488.0.0 ou mais recente.

Para criar um cluster secundário, use o comando gcloud redis clusters create.

gcloud redis clusters create CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--cross-cluster-replication-role=secondary \
--network=NETWORK \
--primary-cluster=PRIMARY_CLUSTER_PATH

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster secundário que você está criando. O ID precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula, terminar com uma letra minúscula ou número e ser exclusivo na região.
• PROJECT_ID: o ID do projeto em que você quer criar o cluster secundário. Esse é o mesmo projeto em que o cluster principal está localizado.
• REGION_ID: o ID da região em que você quer que o cluster secundário esteja localizado.
• NETWORK: a rede usada para criar o cluster. Ele precisa usar este formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. O ID da rede que você usa precisa corresponder ao ID usado pela política de conexão de serviço. Caso contrário, não será possível criar o cluster secundário.
• PRIMARY_CLUSTER_PATH: o caminho do cluster principal. Por exemplo: projects/my-project/locations/us-central1/clusters/my-primary-cluster. Você pode escolher qualquer cluster no seu projeto para ser o principal, desde que não seja um cluster secundário.

Exemplo:

gcloud redis clusters create my-secondary-cluster \
--project=my-project \
--region=asia-east1 \
--cross-cluster-replication-role=secondary \
--network=projects/my-project/global/networks/default
--primary-cluster=projects/my-project/locations/us-central1/clusters/my-primary-cluster

Ver um cluster secundário

Para informações resumidas sobre um cluster secundário, use o consoleGoogle Cloud ou a Google Cloud CLI.

Console

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

   Memorystore for Redis Cluster

2. Clique na seta de expansão ao lado de um cluster principal. Esse cluster é o principal do cluster secundário sobre o qual você quer ver informações.

3. Clique no cluster secundário. As informações resumidas sobre o cluster aparecem.

gcloud

Para conferir informações sobre um cluster secundário, incluindo um campo de associação que lista os clusters primário e secundário no grupo de replicação, use o comando gcloud redis clusters describe.

gcloud redis clusters describe CLUSTER_ID \
--region=REGION_ID \

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster secundário
• REGION_ID: o ID da região em que o cluster secundário está localizado.

Realizar uma troca

Uma alternância permite reverter as funções dos clusters principal e secundário promovendo um cluster secundário a principal para fins de recuperação de desastres.

É possível fazer um failover usando o console Google Cloud ou a Google Cloud CLI.

Observação: antes de fazer uma alternância, siga as instruções em Práticas recomendadas de alternância. Com essas instruções, seu aplicativo pode acompanhar as gravações feitas e enviá-las para o cluster apropriado.

Console

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

   Memorystore for Redis Cluster

2. Clique na seta de expansão ao lado de um cluster principal. Esse cluster é o principal do cluster secundário que você quer fazer failover.

3. Clique no cluster secundário.

4. Clique em Promover a principal.

5. Na caixa de diálogo Promover cluster secundário a principal?, insira o ID do cluster secundário e clique em Promover.

Depois que a alternância for concluída, você precisará reconectar os aplicativos ao novo cluster principal.

gcloud

Para fazer um failover, use o comando gcloud redis clusters switchover.

gcloud redis clusters switchover CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID \

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster secundário que você quer fazer failover.
• PROJECT_ID: ID do projeto;
• REGION_ID: o ID da região em que o cluster secundário está localizado.

Após a conclusão da troca, você precisa reconectar os aplicativos ao novo cluster principal.

Remover clusters secundários

Remover um ou mais clusters secundários do cluster principal os torna clusters independentes totalmente funcionais que permitem leituras e gravações. Para mais informações, consulte Como trabalhar com a replicação entre regiões.

É possível separar clusters secundários usando o console Google Cloud ou a Google Cloud CLI.

Remover um cluster secundário

Esta seção explica como desanexar um cluster secundário do cluster principal.

Console

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

   Memorystore for Redis Cluster

2. Clique em um cluster principal. Este é o pai do cluster secundário que você está removendo do cluster principal.

3. No painel lateral, clique na guia Clusters secundários.

4. Marque a caixa de seleção ao lado do ID do cluster secundário que você está desvinculando do cluster principal.

5. Clique em Desvincular do principal.

6. Na caixa de diálogo Desvincular cluster secundário?, insira o ID do cluster secundário e clique em Desvincular.

gcloud

Para remover um cluster secundário, use o comando gcloud redis clusters detach.

gcloud redis clusters detach CLUSTER_ID \
--project=PROJECT_ID \
--region=REGION_ID

Faça as seguintes substituições:

• CLUSTER_ID: o ID do cluster secundário que você quer remover.
• PROJECT_ID: ID do projeto;
• REGION_ID: o ID da região em que o cluster secundário está localizado.

Remover vários clusters secundários

Esta seção explica como desanexar vários clusters secundários do cluster principal. Você também pode usar o procedimento nesta seção para desanexar um cluster secundário indisponível do cluster principal.

Console

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

   Memorystore for Redis Cluster

2. Clique em um cluster principal. Este é o pai dos clusters secundários que você está removendo do cluster principal.

3. No painel lateral, clique na guia Clusters secundários.

4. Marque as caixas de seleção ao lado dos IDs dos clusters secundários que você está desvinculando do cluster principal.

5. Clique em Desvincular do principal.

6. Na caixa de diálogo Remover clusters secundários?, faça o seguinte:

   1. Insira os IDs dos clusters secundários. Use vírgulas para separar os IDs.

   2. Clique em Desanexar.

gcloud

Para remover vários clusters secundários, use o comando gcloud redis clusters detach-secondaries.

gcloud redis clusters detach-secondaries PRIMARY_CLUSTER_ID \
--clusters-to-detach=SECONDARY_CLUSTERS \
--project=PROJECT_ID \
--region=PRIMARY_CLUSTER_REGION_ID

Faça as seguintes substituições:

• PRIMARY_CLUSTER_ID: o ID do cluster principal.
• SECONDARY_CLUSTERS: os clusters secundários que você quer remover. Use vírgulas para separar os IDs de cluster. Cada cluster secundário precisa ter este formato: projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID.
• PROJECT_ID: o ID do projeto.
• PRIMARY_CLUSTER_REGION: o ID da região em que o cluster principal está localizado.

Exemplo:

gcloud redis clusters detach-secondaries my-primary-cluster \
--clusters-to-detach=projects/my-project/locations/us-west4/clusters/my-secondary-cluster-1,projects/my-project/locations/asia-southeast2/clusters/my-secondary-cluster-2  \
--project=my-project \
--region=us-central1

Atualizar as configurações do cluster

Esta seção fornece links para atualizar as configurações do cluster. O processo de atualização das configurações do cluster é diferente, dependendo se você muda as configurações no cluster principal ou secundário. Para mais informações sobre como atualizar as configurações, consulte Configurações do cluster.

Atualizar as configurações no cluster principal

Você precisa mudar as seguintes configurações no cluster principal. Depois disso, o Memorystore para Redis Cluster sincroniza as mudanças com os clusters secundários.

• Escalonar a capacidade do cluster
• Configurar o cluster
• Impedir a exclusão do cluster
• Gerenciar a persistência do cluster

Atualizar as configurações no cluster secundário

Você precisa mudar as seguintes configurações no cluster secundário:

• Configurar se o cluster é de zona única ou multizonal
• Escalonar a contagem de réplicas do cluster
• Definir janelas de manutenção para o cluster

Excluir clusters que usam a replicação entre regiões

Nesta seção, explicamos como excluir clusters principais e secundários que usam replicação entre regiões.

Excluir um cluster principal

Para excluir um cluster principal, faça o seguinte:

1. Remova ou exclua todos os clusters secundários.
2. Para excluir o cluster principal, siga as instruções em Excluir clusters.

Para evitar a exclusão acidental, não é possível excluir clusters primários e secundários simultaneamente.

Excluir um cluster secundário

Para excluir um cluster secundário, siga as instruções em Excluir clusters. Para o ID do cluster, use o ID do cluster secundário.