Merge pull request #261822 from seesharprun/cosmos-quickstarts-refresh

Cosmos DB | Refresh NoSQL developer quickstarts

Author: v-dirichards

.openpublishing.publish.config.json

@@ -998,12 +998,36 @@
       "branch": "main",
       "branch_mapping": {}
     },
+    {
+      "path_to_root": "cosmos-db-nosql-nodejs-quickstart",
+      "url": "https://github.com/azure-samples/cosmos-db-nosql-nodejs-quickstart",
+      "branch": "main",
+      "branch_mapping": {}
+    },
     {
       "path_to_root": "cosmos-db-nosql-python-samples",
       "url": "https://github.com/azure-samples/cosmos-db-nosql-python-samples",
       "branch": "main",
       "branch_mapping": {}
     },
+    {
+      "path_to_root": "cosmos-db-nosql-python-quickstart",
+      "url": "https://github.com/azure-samples/cosmos-db-nosql-python-quickstart",
+      "branch": "main",
+      "branch_mapping": {}
+    },
+    {
+      "path_to_root": "cosmos-db-nosql-java-quickstart",
+      "url": "https://github.com/azure-samples/cosmos-db-nosql-java-quickstart",
+      "branch": "main",
+      "branch_mapping": {}
+    },
+    {
+      "path_to_root": "cosmos-db-nosql-go-quickstart",
+      "url": "https://github.com/azure-samples/cosmos-db-nosql-go-quickstart",
+      "branch": "main",
+      "branch_mapping": {}
+    },
     {
       "path_to_root": "cosmos-db-mongodb-dotnet-samples",
       "url": "https://github.com/azure-samples/cosmos-db-mongodb-dotnet-samples",

articles/cosmos-db/.openpublishing.redirection.cosmos-db.json

@@ -6240,6 +6240,16 @@
       "redirect_url": "/azure/cosmos-db/postgresql/how-to-configure-authentication",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/cosmos-db/nosql/quickstart-java-spring-data.md",
+      "redirect_url": "/azure/cosmos-db/nosql/quickstart-java",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/cosmos-db/nosql/quickstart-spark.md",
+      "redirect_url": "/azure/cosmos-db/nosql/quickstart-python",
+      "redirect_document_id": false
+    },
     {
       "source_path_from_root": "/articles/cosmos-db/migration-choices.md",
       "redirect_url": "/azure/cosmos-db",

articles/cosmos-db/nosql/TOC.yml

@@ -2,30 +2,32 @@
   href: index.yml
 - name: Quickstarts
   items:
-    - name: Develop app - .NET
+    - name: .NET
       href: quickstart-dotnet.md
-    - name: Develop app - Node.js
+      displayName: Quickstart, ASP.NET, Blazor, AZD, Azure Developer CLI
+    - name: Node.js
       href: quickstart-nodejs.md
-    - name: Develop app - Java
+      displayName: Quickstart, Node.js, JavaScript, Express, AZD, Azure Developer CLI
+    - name: Java
       href: quickstart-java.md
-    - name: Develop app - Spring Data
-      href: quickstart-java-spring-data.md
-    - name: Develop app - Python
+      displayName: Quickstart, Spring, Spring Data, AZD, Azure Developer CLI
+    - name: Python
       href: quickstart-python.md
-    - name: Develop app - Spark v3
-      href: quickstart-spark.md
-    - name: Develop app - Go
+      displayName: Quickstart, Spark, AZD, Azure Developer CLI
+    - name: Go
       href: quickstart-go.md
-    - name: Create resources - Azure portal
+      displayName: Quickstart, AZD, Azure Developer CLI
+    - name: Portal
       href: quickstart-portal.md
-    - name: Create resources - Bicep template
-      displayName: ARM, Resource Manager, Template, Bicep
+      displayName: Quickstart, Azure portal
+    - name: Bicep
+      displayName: Quickstart, ARM, Azure Resource Manager, Template, Bicep
       href: quickstart-template-bicep.md
-    - name: Create resources - JSON template
-      displayName: ARM, Resource Manager, Template, JSON
+    - name: ARM template
+      displayName: Quickstart, ARM, Azure Resource Manager, Template, JSON
       href: quickstart-template-json.md
-    - name: Create resources - Terraform template
-      displayName: ARM, Resource Manager, Template, Terraform
+    - name: Terraform
+      displayName: Quickstart, ARM, Azure Resource Manager, Template, Terraform
       href: quickstart-terraform.md
 - name: Tutorials
   items:

articles/cosmos-db/nosql/includes/media/quickstart/dev-web-application.png

@@ -0,0 +1,14 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+---
+
+Application requests to most Azure services must be authorized. Use the `DefaultAzureCredential` type as the preferred way to implement a passwordless connection between your applications and Azure Cosmos DB for NoSQL. `DefaultAzureCredential` supports multiple authentication methods and determines which method should be used at runtime.
+
+> [!IMPORTANT]
+> You can also authorize requests to Azure services using passwords, connection strings, or other credentials directly. However, this approach should be used with caution. Developers must be diligent to never expose these secrets in an unsecure location. Anyone who gains access to the password or secret key is able to authenticate to the database service. `DefaultAzureCredential` offers improved management and security benefits over the account key to allow passwordless authentication without the risk of storing keys.

articles/cosmos-db/nosql/includes/quickstart/dev-auth-primer.md

@@ -0,0 +1,30 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+zone_pivot_groups: azure-cosmos-db-quickstart-env
+---
+
+::: zone pivot="devcontainer-codespace,devcontainer-vscode"
+
+When you no longer need the sample application or resources, remove the corresponding deployment and all resources.
+
+```azurecli
+azd down
+```
+
+::: zone-end
+
+::: zone pivot="devcontainer-codespace"
+
+In GitHub Codespaces, delete the running codespace to maximize your storage and core entitlements.
+
+::: zone-end
+
+::: zone pivot="devcontainer-vscode"
+
+::: zone-end

articles/cosmos-db/nosql/includes/quickstart/dev-cleanup.md

@@ -0,0 +1,25 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+zone_pivot_groups: azure-cosmos-db-quickstart-env
+---
+
+::: zone pivot="devcontainer-codespace"
+
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- [GitHub account](https://docs.github.com//get-started/quickstart/creating-an-account-on-github)
+
+::: zone-end
+
+::: zone pivot="devcontainer-vscode"
+
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- [Azure Developer CLI](/azure/developer/azure-developer-cli/install-azd)
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+
+::: zone-end

articles/cosmos-db/nosql/includes/quickstart/dev-prereqs.md

@@ -0,0 +1,11 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+---
+
+The sample code in the template uses a database named `cosmicworks` and container named `products`. The `products` container contains details such as name, category, quantity, a unique identifier, and a sale flag for each product. The container uses the `/category` property as a logical partition key.

articles/cosmos-db/nosql/includes/quickstart/dev-sample-primer.md

@@ -0,0 +1,18 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+---
+
+> [!div class="op_single_selector"]
+>
+> - [.NET](../../quickstart-dotnet.md)
+> - [JavaScript/Node.js](../../quickstart-nodejs.md)
+> - [Java](../../quickstart-java.md)
+> - [Python](../../quickstart-python.md)
+> - [Go](../../quickstart-go.md)
+>

articles/cosmos-db/nosql/includes/quickstart/dev-selector.md

@@ -0,0 +1,63 @@
+---
+author: seesharprun
+ms.author: sidandrews
+ms.service: cosmos-db
+ms.subservice: nosql
+ms.topic: include
+ms.date: 01/08/2024
+ms.custom: include file
+zone_pivot_groups: azure-cosmos-db-quickstart-env
+---
+
+::: zone pivot="devcontainer-codespace"
+
+> [!IMPORTANT]
+> GitHub accounts include an entitlement of storage and core hours at no cost. For more information, see [included storage and core hours for GitHub accounts](https://docs.github.com/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#monthly-included-storage-and-core-hours-for-personal-accounts).
+
+::: zone-end
+
+::: zone pivot="devcontainer-vscode"
+
+::: zone-end
+
+1. Open a terminal in the root directory of the project.
+
+1. Authenticate to the Azure Developer CLI using `azd auth login`. Follow the steps specified by the tool to authenticate to the CLI using your preferred Azure credentials.
+
+    ```azurecli
+    azd auth login
+    ```
+
+1. Use `azd init` to initialize the project.
+
+    ```azurecli
+    azd init
+    ```
+
+1. During initialization, configure a unique environment name.
+
+    > [!TIP]
+    > The environment name will also be used as the target resource group name. For this quickstart, consider using `msdocs-cosmos-db-nosql`.
+
+1. Deploy the Azure Cosmos DB for NoSQL account using `azd up`. The Bicep templates also deploy a sample web application.
+
+    ```azurecli
+    azd up
+    ```
+
+1. During the provisioning process, select your subscription and desired location. Wait for the provisioning process to complete. The process can take **approximately five minutes**.
+
+1. Once the provisioning of your Azure resources is done, a URL to the running web application is included in the output.
+
+    ```output
+    Deploying services (azd deploy)
+    
+      (✓) Done: Deploying service web
+    - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
+    
+    SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
+    ```
+
+1. Use the URL in the console to navigate to your web application in the browser. Observe the output of the running app.
+
+    :::image type="content" source="../media/quickstart/dev-web-application.png" alt-text="Screenshot of the running web application.":::