Skip to content

Commit f495899

Browse files
committed
Added networking acess for replicas
1 parent 25aeff5 commit f495899

File tree

2 files changed

+18
-6
lines changed

2 files changed

+18
-6
lines changed
Loading

articles/cosmos-db/mongodb/vcore/quickstart-cross-region-replica-portal.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.date: 06/12/2024
1515

1616
[!INCLUDE[MongoDB vCore](~/reusable-content/ce-skilling/azure/includes/cosmos-db/includes/appliesto-mongodb-vcore.md)]
1717

18-
In this quickstart, you create a cluster replica in another region for an Azure Cosmos DB for MongoDB vCore cluster for disaster recovery (DR) purposes. This replica cluster stores a copy of all of your MongoDB resources - databases, collections, and documents - in another Azure region. The replica cluster provides a unique endpoint for various tools and SDKs to connect to and could be promoted to become available for writes in case of the primary region outage.
18+
In this quickstart, you create a cluster replica in another region for an Azure Cosmos DB for MongoDB vCore cluster for disaster recovery (DR) purposes. This replica cluster stores a copy of all of your MongoDB resources - databases, collections, and documents - in another Azure region. The replica cluster provides a unique endpoint for various tools and SDKs to connect to and could be promoted to become available for writes if there's a primary region outage.
1919

2020
> [!IMPORTANT]
2121
> Cross-region replication in Azure Cosmos DB for MongoDB vCore is currently in preview.
@@ -122,7 +122,7 @@ Get the connection string you need to connect to the primary (read-write) cluste
122122

123123
1. From the Azure Cosmos DB for MongoDB vCore primary cluster page, select the **Connection strings** navigation menu option under **Settings**.
124124

125-
:::image type="content" source="media/quickstart-cross-region-replication/select-connection-strings-option.png" alt-text="Screenshot of the connection strings page in the cluster propteries.":::
125+
:::image type="content" source="media/quickstart-cross-region-replication/select-connection-strings-option.png" alt-text="Screenshot of the connection strings page in the cluster properties.":::
126126

127127
1. Copy the value from the **Connection string** field.
128128

@@ -195,15 +195,27 @@ db.dogs.find();
195195
db.cats.find();
196196
```
197197

198-
## Connect to read replica cluster in another region and read data
199-
200-
Get the connection string for the read cluster replica in another region.
198+
## Enable access to replica cluster
201199

202200
1. From the Azure Cosmos DB for MongoDB vCore *primary* cluster page, select the **Global distribution (preview)** page under **Settings**.
203201

204-
:::image type="content" source="media/quickstart-cross-region-replication/global-distribution-page-on-primary-cluster.png" alt-text="Screenshot of the global distribution preview page in the primary cluster propteries.":::
202+
:::image type="content" source="media/quickstart-cross-region-replication/global-distribution-page-on-primary-cluster.png" alt-text="Screenshot of the global distribution preview page in the primary cluster properties.":::
205203

206204
1. Select *cluster replica name* to open the read cluster replica properties in the Azure portal.
205+
206+
1. On the MongoDB vCore replica cluster page, under **Settings**, select **Networking**.
207+
208+
1. On the **Networking** page, select **Add current client IP address** to create a firewall rule with the public IP address of your computer, as perceived by the Azure system.
209+
210+
:::image type="content" source="media/quickstart-cross-region-replication/cluster-networking-adding-firewall-rule.png" alt-text="Screenshot of the networking page on read replica cluster.":::
211+
212+
Verify your IP address before saving this configuration. In some situations, the IP address observed by Azure portal differs from the IP address used when accessing the Internet and Azure services. You can also select add 0.0.0.0 - 255.255.255.255 firewall rule to allow not just your IP, but the whole Internet to access the cluster. In this situation, clients still must log in with the correct username and password to use the cluster.
213+
214+
1. Select Save on the toolbar to save the settings. It might take a few minutes for the updated networking settings to become effective.
215+
216+
## Connect to read replica cluster in another region and read data
217+
218+
Get the connection string for the read cluster replica in another region.
207219

208220
1. On the replica cluster sidebar, under **Cluster management**, select **Connection strings**.
209221

0 commit comments

Comments
 (0)