https://github.com/Azure-Samples/cosmos-db-nosql-dotnet-quickstart

Quickstart application template for Azure Cosmos DB for NoSQL and .NET
https://github.com/Azure-Samples/cosmos-db-nosql-dotnet-quickstart

azd-templates azure azure-dev cosmos-db dotnet

Last synced: 3 months ago
JSON representation

Quickstart application template for Azure Cosmos DB for NoSQL and .NET

• Host: GitHub
• URL: https://github.com/Azure-Samples/cosmos-db-nosql-dotnet-quickstart
• Owner: Azure-Samples
• License: mit
• Created: 2023-10-06T14:16:34.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-18T01:01:24.000Z (3 months ago)
• Last Synced: 2024-10-20T08:35:23.518Z (3 months ago)
• Topics: azd-templates, azure, azure-dev, cosmos-db, dotnet
• Language: Bicep
• Homepage: https://learn.microsoft.com/azure/cosmos-db/nosql/quickstart-dotnet
• Size: 209 KB
• Stars: 5
• Watchers: 23
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

        
---

page_type: sample

name: "Quickstart: Azure Cosmos DB for NoSQL and Azure SDK for .NET"

description: This is a simple ASP.NET web application to illustrate common basic usage of Azure Cosmos DB for NoSQL and the Azure SDK for .NET.

urlFragment: template

languages:

- csharp

- azdeveloper

products:

- azure-cosmos-db

---

# Quickstart: Azure Cosmos DB for NoSQL client library for .NET

This is a simple Blazor web application to illustrate common basic usage of Azure Cosmos DB for NoSQL's client library for .NET. This sample application accesses an existing account, database, and container using the [`Microsoft.Azure.Cosmos`](https://www.nuget.org/packages/Microsoft.Azure.Cosmos) and  [`Azure.Identity`](https://www.nuget.org/packages/Azure.Identity) libraries from NuGet.

### Prerequisites

- [Docker](https://www.docker.com/)

- [Azure Developer CLI](https://aka.ms/azd-install)

- [.NET SDK 8.0](https://dotnet.microsoft.com/download/dotnet/8.0) 

### Quickstart

1. Log in to Azure Developer CLI.

    ```bash

    azd auth login

    ```

    > [!TIP]

    > This is only required once per-install.

1. Initialize this template (`cosmos-db-nosql-dotnet-quickstart`) using `azd init`

    ```bash

    azd init --template cosmos-db-nosql-dotnet-quickstart

    ```

1. Ensure that **Docker** is running in your environment.

1. Use `azd up` to provision your Azure infrastructure and deploy the web application to Azure.

    ```bash

    azd up

    ```

1. Observed the deployed web application

    ![Screenshot of the deployed web application.](assets/web.png)

1. (Optionally) Run this web application locally in the `src/web` folder: 

    ```dotnetcli

    dotnet watch run

    ```

    > [!IMPORTANT]

    > When your Azure infrastructure is provisioned, the endpoint for your deployed Azure Cosmos DB for NoSQL account is automatically saved in the .NET user secrets store to make debugging easier. For more information, see [safe storage of app secrets in development](https://learn.microsoft.com/aspnet/core/security/app-secrets).