Work with cross-region replication

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click a primary cluster. The primary cluster is the parent of the secondary cluster that you're creating.

3. In the side panel, click the Secondary clusters tab.

4. Click Add secondary cluster.

5. In the Add secondary clusters window, make the following changes:

   1. In the Cluster ID field, enter the ID of the secondary cluster that you're creating. The ID must be 1 to 63 characters and use only lowercase letters, numbers, or hyphens. It must start with a lowercase letter, end with a lowercase letter or number, and be unique in its region.

   2. From the Region menu, select the region where you want the secondary cluster to be located.

   3. In the Zonal availability section, select one of the following options:

      • If you want all of the shards and replicas of the cluster to be distributed across three zones of the region where Memorystore for Redis Cluster creates the cluster, then select the Multi-zone option.

        For example, if the region that you select is us-central1, and you select the Multi-zone option, then Memorystore for Redis Cluster distributes the cluster's shards and replicas across the us-central1-a, us-central1-b, and us-central1-c zones. In case of a zonal failure, the nodes in the cluster failover to the replicas.

      • If you want all of the shards and replicas of the cluster to be located in one zone of the region where Memorystore for Redis Cluster creates the cluster, select the Single zone option, and then select the zone from the Zone menu.

        By using a single zone, you reduce network costs. However, in case of a zonal failure, failover doesn't occur.

   4. From the Replicas menu, select the number of replicas (per shard) for the cluster. You can have zero, one, or two replicas.

   5. From the Network menu, select a network for the cluster. For more information about networking for Memorystore for Redis Cluster, see Networking overview.

6. Click Add secondary cluster.

gcloud

To create a secondary cluster, use the gcloud redis clusters create command.

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

Make the following replacements:

• CLUSTER_ID: the ID of the secondary cluster that you're creating. The ID must be 1 to 63 characters and use only lowercase letters, numbers, or hyphens. It must start with a lowercase letter, end with a lowercase letter or number, and be unique in its region.
• PROJECT_ID: the ID of the project where you want to create the secondary cluster. This is the same project where the primary cluster is located.
• REGION_ID: the ID of the region where you want the secondary cluster to be located.
• NETWORK: the network used to create the cluster. It must use this format: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. The network ID that you use must match the network ID that the service connection policy uses. Otherwise, you can't create the secondary cluster.
• PRIMARY_CLUSTER_PATH: the path of the primary cluster. For example: projects/my-project/locations/us-central1/clusters/my-primary-cluster. You can choose any cluster in your project to be the primary cluster, as long as it's not a secondary cluster.

For example:

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

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click the expander arrow next to a primary cluster. This cluster is the parent of the secondary cluster about which you want to view information.

3. Click the secondary cluster. Summary information about the cluster appears.

gcloud

To view information about a secondary cluster, including a membership field that lists the primary and secondary clusters in the replication group, use the gcloud redis clusters describe command.

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

Make the following replacements:

• CLUSTER_ID: the ID of the secondary cluster
• REGION_ID: the ID of the region where the secondary cluster is located

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click the expander arrow next to a primary cluster. This cluster is the parent of the secondary cluster that you want to switchover.

3. Click the secondary cluster.

4. Click Promote to Primary.

5. In the Promote secondary cluster to primary? dialog, enter the ID of the secondary cluster, and then click Promote.

After the switchover is complete, you must reconnect your applications to the new primary cluster.

gcloud

To perform a switchover, use the gcloud redis clusters switchover command.

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

Make the following replacements:

• CLUSTER_ID: the ID of the secondary cluster that you want to switchover
• PROJECT_ID: your project ID
• REGION_ID: the ID of the region where the secondary cluster is located

After the switchover is complete, you must reconnect your applications to the new primary cluster.

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click a primary cluster. This is the parent of the secondary cluster that you're detaching from the primary cluster.

3. In the side panel, click the Secondary clusters tab.

4. Select the checkbox next to the ID of the secondary cluster that you're detaching from the primary cluster.

5. Click Detach from Primary.

6. In the Detach secondary cluster? dialog, enter the ID of the secondary cluster, and then click Detach.

gcloud

To detach a secondary cluster, use the gcloud redis clusters detach command.

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

Make the following replacements:

• CLUSTER_ID: the ID of the secondary cluster that you want to detach
• PROJECT_ID: your project ID
• REGION_ID: the ID of the region where the secondary cluster is located

Console

1. In the Google Cloud console, go to the Memorystore for Redis Cluster page.

   Memorystore for Redis Cluster

2. Click a primary cluster. This is the parent of the secondary clusters that you're detaching from the primary cluster.

3. In the side panel, click the Secondary clusters tab.

4. Select the checkboxes next to the IDs of the secondary clusters that you're detaching from the primary cluster.

5. Click Detach from Primary.

6. In the Detach secondary clusters? dialog, do the following:

   1. Enter the IDs of the secondary clusters. Use commas to separate the IDs.

   2. Click Detach.

gcloud

To detach multiple secondary clusters, use the gcloud redis clusters detach-secondaries command.

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

Make the following replacements:

• PRIMARY_CLUSTER_ID: the ID of the primary cluster.
• SECONDARY_CLUSTERS: the secondary clusters that you want to detach. Use commas to separate the cluster IDs. Each secondary cluster must have this format: projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID.
• PROJECT_ID: your project ID.
• PRIMARY_CLUSTER_REGION: the ID of the region where your primary cluster is located.

For example:

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