Trabalhar com a replicação entre regiões

Console

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

   Memorystore for Valkey

2. Clique em uma instância principal. A instância principal é a mãe da instância secundária que você está criando.

3. No painel lateral, clique na guia Instâncias secundárias.

4. Clique em Adicionar instância secundária.

5. Na janela Adicionar instâncias secundárias, faça as seguintes mudanças:

   1. No campo ID da instância, insira o ID da instância secundária 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 a instância secundária fique localizada.

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

      • Se você quiser que todos os fragmentos e réplicas da instância sejam distribuídos em três zonas da região em que o Memorystore para Valkey cria a instância, 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 Valkey vai distribuir os fragmentos e as réplicas da instância nas zonas us-central1-a, us-central1-b e
        us-central1-c. Em caso de falha zonal, os nós na instância fazem failover para as réplicas.

      • Se você quiser que todos os fragmentos e réplicas da instância estejam localizados em uma zona da região em que o Memorystore para Valkey cria a instância, 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) da instância. Você pode ter zero, uma ou duas réplicas.

   5. No menu Rede, selecione uma rede para a instância. Para mais informações sobre rede no Memorystore para Valkey, consulte Rede.

6. Clique em Adicionar instância secundária.

gcloud

Para criar uma instância secundária, use o comando gcloud memorystore instances create.

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=NETWORK,projectId=PROJECT_ID \
--primary-instance=PRIMARY_INSTANCE_PATH

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância secundária 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.
• PROJECT_ID: o ID do projeto em que você quer criar a instância secundária. Esse é o mesmo projeto em que a instância principal está localizada.
• REGION_ID: o ID da região em que você quer que a instância secundária esteja localizada.
• NETWORK: a rede usada para criar a instância. Ele precisa usar este formato: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. O ID da rede precisa corresponder ao ID usado pela política de conexão de serviço. Caso contrário, não será possível criar a instância secundária.
• PRIMARY_INSTANCE_PATH: o caminho da instância principal. Por exemplo: projects/my-project/locations/us-central1/instances/my-primary-instance. Você pode escolher qualquer instância no seu projeto como principal, desde que ela não seja secundária.

Exemplo:

gcloud memorystore instances create my-secondary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--primary-instance=projects/my-project/locations/us-central1/instances/my-primary-instance

Console

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

   Memorystore for Valkey

2. Clique na seta de expansão ao lado de uma instância principal. Essa instância é a principal da instância secundária sobre a qual você quer ver informações.

3. Clique na instância secundária. As informações resumidas sobre a instância aparecem.

gcloud

Para conferir informações sobre uma instância secundária, incluindo um campo de associação que lista as instâncias principal e secundária no grupo de replicação, use o comando gcloud memorystore instances describe.

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

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância secundária
• PROJECT_ID: o ID do projeto que contém a instância secundária
• REGION_ID: o ID da região em que a instância secundária está localizada.

Console

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

   Memorystore for Valkey

2. Clique na seta de expansão ao lado de uma instância principal. Essa instância é a principal da instância secundária que você quer fazer failover.

3. Clique na instância secundária.

4. Clique em Promover a principal.

5. Na caixa de diálogo Promover a instância secundária para principal?, insira o ID da instância secundária e clique em Promover.

Depois que a alternância for concluída, você precisará reconectar os aplicativos à nova instância principal.

gcloud

Para fazer um failover, use o comando gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCE_PATH]

Faça as seguintes substituições:

• INSTANCE_ID: o ID da instância secundária que você quer promover a uma instância principal realizando a troca.
• PROJECT_ID: o ID do projeto que contém a instância secundária.
• REGION_ID: o ID da região em que a instância secundária está localizada.

• SECONDARY_INSTANCE_PATH: o caminho da instância secundária. Por exemplo, projects/my-project/locations/us-central1/instances/my-secondary-instance.

  Se você tiver várias instâncias secundárias, separe cada uma delas com vírgulas. Por exemplo, [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance].

Suponha que você tenha as seguintes instâncias contidas no projeto my-project:

• instance-1: essa instância principal está localizada na região us-east1.
• instance-2: essa instância secundária reside na região asia-east1.
• instance-3: essa instância secundária reside na região southamerica-east1.

Você quer inverter as funções de instance-1 e instance-2 para que instance-2 seja a nova instância principal e instance-1 seja uma instância secundária.

Para isso, use o seguinte código:

gcloud memorystore instances update instance-2 \
--project=my-project \
--location=asia-east1 \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-east1/instances/instance-1,instance=projects/my-project/locations/southamerica-east1/instances/instance-3]

Depois que a alternância for concluída, você precisará reconectar os aplicativos à nova instância principal.

Console

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

   Memorystore for Valkey

2. Clique em uma instância principal. É o pai da instância secundária que você está separando da instância principal.

3. No painel lateral, clique na guia Instâncias secundárias.

4. Marque a caixa de seleção ao lado do ID da instância secundária que você está desvinculando da instância principal.

5. Clique em Desvincular do principal.

6. Na caixa de diálogo Desvincular instância secundária?, insira o ID da instância secundária e clique em Desvincular.

gcloud

Para remover uma instância secundária, use o comando gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=none \
--clear-primary-instance

Substitua:

• INSTANCE_ID: o ID da instância secundária que você quer remover.
• PROJECT_ID: o ID do projeto que contém a instância secundária
• REGION_ID: a região em que a instância secundária está localizada.

Console

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

   Memorystore for Valkey

2. Clique em uma instância principal. É o pai das instâncias secundárias que você está removendo da instância principal.

3. No painel lateral, clique na guia Instâncias secundárias.

4. Marque as caixas de seleção ao lado dos IDs das instâncias secundárias que você quer desconectar da instância principal.

5. Clique em Desvincular do principal.

6. Na caixa de diálogo Remover instâncias secundárias?, faça o seguinte:

   1. Insira os IDs das instâncias secundárias. Use vírgulas para separar os IDs.

   2. Clique em Desanexar.

gcloud

Para remover várias instâncias secundárias, use o comando gcloud memorystore instances update.

gcloud memorystore instances update PRIMARY_INSTANCE_ID \
--project=PROJECT_ID \
--location=PRIMARY_INSTANCE_REGION_ID \
--remove-cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCES] \
--cross-instance-replication-config-role=none

Faça as seguintes substituições:

• PRIMARY_INSTANCE_ID: o ID da instância principal.
• PROJECT_ID: o ID do projeto que contém as instâncias secundárias.
• PRIMARY_INSTANCE_REGION_ID: o ID da região em que a instância principal está localizada.
• SECONDARY_INSTANCES: as instâncias secundárias que você quer remover. Use vírgulas para separar os IDs das instâncias. Cada instância secundária precisa ter este formato: projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID.

Exemplo:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--remove-cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-west4/instances/my-secondary-instance-1,instance=projects/my-project/locations/asia-southeast2/instances/my-secondary-instance-2] \
--cross-instance-replication-config-role=none

Também é possível remover instâncias secundárias da instância principal especificando uma lista de instâncias que você não quer remover. O Memorystore para Valkey desconecta todas as instâncias que não estão incluídas nessa lista.

Suponha que você tenha as seguintes instâncias secundárias:

• instance-1: esta instância está localizada na região us-east1.
• instance-2: esta instância está na região asia-east1.

Você quer remover as duas instâncias secundárias de my-primary-instance. Essa instância principal está localizada na região us-central1 e contida no projeto my-project.

Para separar as instâncias secundárias, use o seguinte código:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-secondary-instances=[]
--cross-instance-replication-config-role=none

Neste exemplo, como o valor nulo [] é atribuído ao parâmetro --cross-instance-replication-config-secondary-instances, o Memorystore para Valkey desconecta todas as instâncias secundárias da instância principal.