Skip to content

Commit 35c0c28

Browse files
authored
Merge pull request #268816 from sajeetharan/Vercel_new_accounts
adding updates
2 parents b4dc8c9 + 787a855 commit 35c0c28

File tree

8 files changed

+26
-14
lines changed

8 files changed

+26
-14
lines changed
99.8 KB
Loading
85 KB
Loading
65.3 KB
Loading
79.2 KB
Loading
32.8 KB
Loading
71.7 KB
Loading
92.4 KB
Loading

articles/cosmos-db/vercel-integration.md

Lines changed: 26 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -21,50 +21,62 @@ This documentation is designed for developers seeking to effectively combine the
2121

2222
This integration enables developers to apply the benefits of a versatile and high-performance NoSQL database, while capitalizing on Vercel's serverless architecture and development platform.
2323

24-
There are two ways to integrate Cosmos DB
24+
There are two ways to integrate Azure Cosmos DB.
2525

2626
- [Via Vercel Integrations Marketplace](https://vercel.com/integrations/azurecosmosdb)
2727
- Via Command Line
2828

2929
## Integrate Cosmos DB with Vercel via Integration Marketplace
3030

31-
Use this guide if you have already identified the Vercel project(s) or want to integrate an existing vercel project with
31+
Use this guide if you have already identified the Vercel projects or want to integrate an existing vercel project with
3232

3333
## Prerequisites
3434

3535
- Vercel Account with Vercel Project – [Learn how to create a new Vercel Project](https://vercel.com/docs/concepts/projects/overview#creating-a-project)
3636

3737
- Azure Cosmos DB - [Quickstart: Create an Azure Cosmos DB account](../cosmos-db/nosql/quickstart-portal.md) or Create a free [Try Cosmos DB Account](https://aka.ms/trycosmosdbvercel)
3838

39-
- Some basic knowledge on Next.js, React and TypeScript
39+
- Some basic knowledge on Next.js, React, and TypeScript
4040

4141
## Steps for Integrating Azure Cosmos DB with Vercel
4242

4343
1. Select Vercel Projects for the Integration with Azure Cosmos DB. After you have the prerequisites ready, visit the Cosmos DB [integrations page on the Vercel marketplace](https://vercel.com/integrations/azurecosmosdb) and select Add Integration
4444

4545
:::image type="content" source="./media/integrations/vercel/add-integration.png" alt-text="Screenshot shows the Azure Cosmos DB integration page on Vercel's marketplace." lightbox="./media/integrations/vercel/add-integration.png":::
4646

47-
2. Choose All projects or Specific projects for the integration. In this guide we proceed by choosing specific projects, select continue
47+
2. Choose All projects or Specific projects for the integration. In this guide we proceed by choosing specific projects. Select Install to continue.
4848

4949
:::image type="content" source="./media/integrations/vercel/continue.png" alt-text="Screenshot shows to select vercel projects." lightbox="./media/integrations/vercel/continue.png":::
5050

51-
3. Next screen will show the required permissions for the integration, select Add Integration
51+
3. Sign in to your existing Microsoft account, or if you don’t have one, create a new account as depicted in next step.
5252

53-
:::image type="content" source="./media/integrations/vercel/permissions.png" alt-text="Screenshot shows the permissions required for the integration." lightbox="./media/integrations/vercel/permissions.png":::
53+
:::image type="content" source="./media/integrations/vercel/sign-in.png" alt-text="Screenshot shows to log in to Azure account." lightbox="./media/integrations/vercel/sign-in.png":::
5454

55-
4. Log in to Azure using your credentials to select the existing Azure Cosmos DB account for the integration
55+
4. Click on 'create one' to create a new Microsoft account.
56+
> [!NOTE]
57+
> Microsoft account is different from an Azure Cosmos DB account. We will be creating an Azure Cosmos DB account in following steps
58+
>
59+
:::image type="content" source="./media/integrations/vercel/create-new.png" alt-text="Screenshot shows to create new Microsoft Account." lightbox="./media/integrations/vercel/create-new.png":::
5660

57-
:::image type="content" source="./media/integrations/vercel/sign-in.png" alt-text="Screenshot shows to login to Azure account." lightbox="./media/integrations/vercel/sign-in.png":::
61+
5. If you want to use an existing Azure Cosmos DB account, choose the existing Directory, subscription and the Azure Cosmos DB Account(Skip to step 9) . To create a new Azure Try Cosmos DB account, click on 'Create new account'.
62+
63+
:::image type="content" source="./media/integrations/vercel/create-new-azure-cosmosdb.png" alt-text="Screenshot shows to create new Azure Try Cosmos DB Account." lightbox="./media/integrations/vercel/create-new-azure-cosmosdb.png":::
5864

59-
5. Choose a Directory, subscription and the Azure Cosmos DB Account
65+
6. Select API type (currently only NOSQL and MongoDB API are supported) and click on 'Create Account'.
6066

61-
6. Verify Vercel Projects
67+
:::image type="content" source="./media/integrations/vercel/select-api.png" alt-text="Screenshot shows to select the type of API of the Azure Cosmos DB account." lightbox="./media/integrations/vercel/select-api.png":::
6268

63-
:::image type="content" source="./media/integrations/vercel/projects.png" alt-text="Screenshot shows to verify the vercel projects for the integration." lightbox="./media/integrations/vercel/projects.png":::
69+
7. After the successful Try Azure Cosmos DB account creation, click on 'Continue'
6470

65-
7. Select Integrate
71+
:::image type="content" source="./media/integrations/vercel/account-continue.png" alt-text="Screenshot shows to continue with the integration." lightbox="./media/integrations/vercel/account-continue.png":::
6672

67-
:::image type="content" source="./media/integrations/vercel/integrate.png" alt-text="Screenshot shows to confirm the integration." lightbox="./media/integrations/vercel/integrate.png":::
73+
8. Click on 'Accept' in the pop-up to access the Try Azure Cosmos DB account. (Mandatory to complete the Integration).
74+
75+
:::image type="content" source="./media/integrations/vercel/accept.png" alt-text="Screenshot shows to accept the access." lightbox="./media/integrations/vercel/accept.png":::
76+
77+
9. Select Integrate and you're done.
78+
79+
:::image type="content" source="./media/integrations/vercel/integrate-new.png" alt-text="Screenshot shows to confirm the integration." lightbox="./media/integrations/vercel/integrate-new.png":::
6880

6981
## Integrate Cosmos DB with Vercel via npm & Command Line
7082

@@ -88,7 +100,7 @@ Use this guide if you have already identified the Vercel project(s) or want to i
88100

89101
- COSMOSDB_CONNECTION_STRING - You need your Cosmos DB connection string. You can find these in the Azure portal in the keys section.
90102

91-
- COSMOSDB_DATABASE_NAME - Name of the database you plan to use. This should already exist in the Cosmos DB account.
103+
- COSMOSDB_DATABASE_NAME - Name of the database you plan to use. This should already exist in the Azure Cosmos DB account.
92104

93105
- COSMOSDB_CONTAINER_NAME - Name of the container you plan to use. This should already exist in the previous database.
94106

0 commit comments

Comments
 (0)