Skip to content

Commit 480bc6d

Browse files
committed
Portal quick start minor updates
1 parent ca2d4f6 commit 480bc6d

File tree

4 files changed

+17
-13
lines changed

4 files changed

+17
-13
lines changed
65.2 KB
Loading
126 KB
Loading
14 KB
Loading

articles/cosmos-db/mongodb/vcore/quickstart-portal.md

Lines changed: 17 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.reviewer: sidandrews
99
ms.service: cosmos-db
1010
ms.subservice: mongodb-vcore
1111
ms.topic: quickstart
12-
ms.date: 08/28/2023
12+
ms.date: 06/20/2024
1313
---
1414

1515
# Quickstart: Create an Azure Cosmos DB for MongoDB vCore cluster by using the Azure portal
@@ -55,32 +55,38 @@ Create a MongoDB cluster by using Azure Cosmos DB for MongoDB vCore.
5555
| **Cluster tier** | M30 Tier, 2 vCores, 8-GiB RAM |
5656
| **Storage per shard** | 128 GiB |
5757

58-
1. Leave the **High availability** option unselected. In the high availability (HA) acknowledgment section, select **I understand**. Finally, select **Save** to persist your changes to the cluster tier.
58+
1. Unselect **High availability** option. In the high availability (HA) acknowledgment section, select **I understand**. Finally, select **Save** to persist your changes to the cluster tier.
5959

6060
:::image type="content" source="media/quickstart-portal/configure-scale.png" alt-text="Screenshot of cluster tier and scale options for a cluster.":::
61+
62+
You can always turn HA on after cluster creation for additional layer of protection from failures.
6163

6264
1. Back on the cluster page, enter the following information:
6365

6466
| Setting | Value | Description |
6567
| --- | --- | --- |
6668
| Subscription | Subscription name | Select the Azure subscription that you wish to use for this Azure Cosmos DB for MongoDB cluster. |
67-
| Resource Group | Resource group name | Select a resource group, or select **Create new**, then enter a unique name for the new resource group. |
68-
| Cluster Name | A unique name | Enter a name to identify your Azure Cosmos DB for MongoDB cluster. The name is used as part of a fully qualified domain name (FQDN) with a suffix of *documents.azure.com*, so the name must be globally unique. The name can only contain lowercase letters, numbers, and the hyphen (-) character. The name must also be between 3-44 characters in length. |
69+
| Resource group | Resource group name | Select a resource group, or select **Create new**, then enter a unique name for the new resource group. |
70+
| Cluster name | A unique name | Enter a name to identify your Azure Cosmos DB for MongoDB cluster. The name is used as part of a fully qualified domain name (FQDN) with a suffix of *mongocluster.cosmos.azure.com*, so the name must be globally unique. The name can only contain lowercase letters, numbers, and the hyphen (-) character. The name must also be between 3 and 40 characters in length. |
6971
| Location | The region closest to your users | Select a geographic location to host your Azure Cosmos DB for MongoDB cluster. Use the location that is closest to your users to give them the fastest access to the data. |
70-
| MongoDB version | Version of MongoDB to run in your cluster | This value is set to a default of **5.0** |
72+
| MongoDB version | Version of MongoDB to run in your cluster | This value is set to a default of the latest available MongoDB version. |
7173
| Admin username | Provide a username to access the cluster | This user is created on the cluster as a user administrator. |
7274
| Password | Use a unique password to pair with the username | Password must be at least eight characters and at most 128 characters. |
7375

7476
:::image type="content" source="media/quickstart-portal/configure-cluster.png" alt-text="Screenshot of various configuration options for a cluster.":::
7577

78+
1. Leave **Access to global distribution (preview)** and **Free tier** unselected.
79+
80+
1. Select **Next: Global distribution (preview)**.
81+
7682
1. Select **Next: Networking**.
7783

78-
1. In the **Networking** section, select **Allow public access from Azure services**. Additionally, add a firewall rule to give your client device or applications access to the cluster.
84+
1. In the **Firewall rules** section on the **Networking** tab, select **Allow public access from Azure services and resources within Azure to this cluster**. Additionally, add a firewall rule to give your client device or applications access to the cluster.
7985

80-
:::image type="content" source="media/quickstart-portal/configure-cluster.png" alt-text="Screenshot of networking and firewall options for a cluster.":::
86+
:::image type="content" source="media/quickstart-portal/networking-settings-at-provisioning.png" alt-text="Screenshot of networking and firewall options for a cluster.":::
8187

8288
> [!NOTE]
83-
> In many corporate environments, developer machine IPs are hidden due to a VPN. In these cases, it's recommended to start with allowing access to all IPs for connection testing initially before refining the allow-list.
89+
> In many corporate environments, developer machine IP addresses are hidden due to a VPN or other corporate network settings. In these cases, it's recommended to start with allowing access to all IP addresses by adding the 0.0.0.0 - 255.255.255.255 firewall rule for connection testing initially before refining the allow-list.
8490
8591
1. Select **Review + create**.
8692

@@ -96,14 +102,12 @@ Get the connection string you need to connect to this cluster using your applica
96102

97103
1. From the Azure Cosmos DB for MongoDB vCore cluster page, select the **Connection strings** navigation menu option.
98104

99-
:::image type="content" source="media/quickstart-portal/select-connection-strings-option.png" alt-text="Screenshot of the connection strings option on the page for a cluster.":::
100-
101-
1. Record the value from the **Connection string** field.
105+
:::image type="content" source="media/quickstart-portal/cluster-connection-string.png" alt-text="Screenshot of the connection strings option on the page for a cluster.":::
102106

103-
:::image type="content" source="media/quickstart-portal/connection-string-value.png" alt-text="Screenshot of the connection string credential for a cluster.":::
107+
1. Copy or record the value from the **Connection string** field.
104108

105109
> [!IMPORTANT]
106-
> The connection string in the portal does not include the username and password values. You must replace the `<user>` and `<password>` placeholders with the credentials you used when you originally created the cluster.
110+
> The connection string in the portal does not include the username and password values. You must replace the `<user>` and `<password>` placeholders with the credentials you entered when you created the cluster.
107111
108112
## Clean up resources
109113

0 commit comments

Comments
 (0)