Skip to content

Commit e9587e2

Browse files
TaojunshenTaojunshen
authored
Merge pull request #6264 from MicrosoftDocs/main
8/29/2024 AM Publish
2 parents 1a17946 + 885ecb4 commit e9587e2

32 files changed

+315
-33
lines changed

‎.openpublishing.publish.config.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,12 @@
5858
"branch": "main",
5959
"branch_mapping": {}
6060
},
61+
{
62+
"path_to_root": "node-essentials",
63+
"url": "https://github.com/MicrosoftDocs/node-essentials",
64+
"branch": "main",
65+
"branch_mapping": {}
66+
},
6167
{
6268
"path_to_root": "js-e2e-azure-function-upload-file",
6369
"url": "https://github.com/Azure-Samples/js-e2e-azure-function-upload-file",

‎articles/azure-developer-cli/azd-templates.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.service: azure-dev-cli
1111

1212
# Azure Developer CLI templates overview
1313

14-
Azure Developer CLI (`azd`) templates are standard code repositories that include sample application code, as well as `azd` configuration and infrastructure files. `azd` templates enable you to provision Azure resources, deploy your application, configure CI/CD pipelines, and more. You can either create your own templates, or get started using an existing template from a template repository such as [Awesome AZD](https://azure.github.io/awesome-azd/). In this article, you'll learn about the following concepts:
14+
Azure Developer CLI (`azd`) templates are regular code repositories that include sample application code, as well as `azd` configuration and infrastructure files. `azd` templates enable you to provision Azure resources, deploy your application, configure CI/CD pipelines, and more. You can either create your own templates, or get started using an existing template from a template repository such as [Awesome AZD](https://azure.github.io/awesome-azd/). In this article, you'll learn about the following concepts:
1515

1616
- How `azd` templates enable you to provision and deploy app resources
1717
- How `azd` templates are structured
@@ -20,7 +20,7 @@ Azure Developer CLI (`azd`) templates are standard code repositories that includ
2020

2121
## Why use Azure Developer CLI templates?
2222

23-
Developers often face many time consuming and challenging tasks when building properly architected and configured environment apps for the cloud. Teams must account for many different concerns in these environments, such as creating resources, applying configurations, setting up monitoring and logging, building CI/CD pipelines, and other tasks. `azd` templates reduce and streamline these responsibilities to help the developer on their journey from local development to a successfully deployed app on Azure.
23+
Developers often face many time consuming and challenging tasks when building properly architected and configured environment aware apps for the cloud. Teams must account for many different concerns in these environments, such as creating resources, applying configurations, setting up monitoring and logging, building CI/CD pipelines, and other tasks. `azd` templates reduce and streamline these responsibilities to help the developer on their journey from local development to a successfully deployed app on Azure.
2424

2525
For example, suppose you work at a company that operates a ticket management and customer communication platform, which requires the following Azure resources:
2626

@@ -61,7 +61,7 @@ For example, a typical `azd` workflow using an existing template includes the fo
6161
6262
## Understand Azure Developer CLI template structure
6363
64-
All `azd` templates share a similar file structure based on `azd` conventions. The minimum required assets generally include the following:
64+
All `azd` templates share a similar file structure based on `azd` conventions. Here are the minimum required assets:
6565
6666
- **`infra` folder** - Contains all of the Bicep or Terraform infrastructure as code files for the `azd` template. `azd` executes these files to create the Azure resources required to host your app.
6767
- **`azure.yaml` file** - A configuration file that defines one or more services in your project and maps them to Azure resources defined in the `infra` folder for deployment. For example, you might define an API service and a web front-end service and map them to different Azure resources for deployment.

‎articles/azure-developer-cli/get-started.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ zone_pivot_groups: azd-languages-set
1414

1515
# Quickstart: Deploy an Azure Developer CLI template
1616

17-
In this quickstart, you'll learn how to provision and deploy app resources to Azure using an [Azure Developer CLI (`azd`) template](/azure/developer/azure-developer-cli/azd-templates) and only a few `azd` commands. `azd` templates are standard code repositories that include your application source code, as well as `azd` configuration and infrastructure files to provision Azure resources. Visit the [What are Azure Developer CLI templates?](/azure/developer/azure-developer-cli/azd-templates) page to learn more about `azd` templates and how they can accelerate your Azure provisioning and deployment process.
17+
In this quickstart, you'll learn how to provision and deploy app resources to Azure using an [Azure Developer CLI (`azd`) template](/azure/developer/azure-developer-cli/azd-templates) and only a few `azd` commands. `azd` templates are standard code repositories that include your application source code, as well as `azd` configuration and infrastructure files to provision Azure resources. To learn more about `azd` templates and how they can accelerate your Azure provisioning and deployment process see [What are Azure Developer CLI templates?](/azure/developer/azure-developer-cli/azd-templates).
1818

1919
## Select and deploy the template
2020

@@ -61,7 +61,7 @@ A local development environment is a great choice for traditional development wo
6161
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
6262
- [Python 3.8](https://www.python.org/downloads/)
6363
- [Node.js with npm (v 16.13.1 LTS)](https://nodejs.org/)
64-
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-nodejs-mongo/blob/main/README.md).
64+
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-python-mongo/blob/main/README.md).
6565

6666
::: zone-end
6767

@@ -70,7 +70,7 @@ A local development environment is a great choice for traditional development wo
7070
- [Install the Azure Developer CLI](./install-azd.md).
7171
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
7272
- [.NET 6.0](https://dotnet.microsoft.com/download/dotnet/6.0)
73-
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-nodejs-mongo/blob/main/README.md).
73+
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-csharp-cosmos-sql/blob/main/README.md).
7474

7575
::: zone-end
7676

@@ -79,7 +79,7 @@ A local development environment is a great choice for traditional development wo
7979
- [Install the Azure Developer CLI](./install-azd.md).
8080
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
8181
- [OpenJDK 17](/java/openjdk/download#openjdk-17)
82-
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-nodejs-mongo/blob/main/README.md).
82+
- [Review the architecture diagram and the Azure resources you'll deploy in the Node.js template README](https://github.com/Azure-Samples/todo-java-mongo/blob/main/README.md).
8383

8484
::: zone-end
8585

@@ -162,6 +162,7 @@ A local development environment is a great choice for traditional development wo
162162
163163
> [!NOTE]
164164
> You can call `azd up` as many times as you like to both provision and deploy updates to your application.
165+
> The deployment may due to a resource being undeployable in the selected region. Because this is a quick start, it is safe to delete the `.azure` directory and try `azd up` again. When asked, select a different region. In a more advanced scenario you could selectively edit files within the `.azure` directory to change the region.
165166
166167
## [Codespaces](#tab/codespaces)
167168
@@ -351,7 +352,7 @@ Once you've provided the necessary parameters and the `azd up` command completes
351352
:::image type="content" source="media/get-started/urls.png" alt-text="Screenshot of command output listing endpoint URLs.":::
352353

353354
> [!NOTE]
354-
> You can call `azd up` as many times as you like to both provision and deploy your application.
355+
> You can run `azd up` as many times as you like to both provision and deploy your application to the same region and with the same configuration values you provided on the first run.
355356
356357
---
357358

@@ -363,6 +364,8 @@ When you no longer need the resources created in this article, run the following
363364
azd down
364365
```
365366

367+
If you want to redeploy to a different region, delete the `.azure` directory before running `azd up` again. In a more advanced scenario you could selectively edit files within the `.azure` directory to change the region.
368+
366369
[!INCLUDE [request-help](includes/request-help.md)]
367370

368371
## Next steps

‎articles/azure-developer-cli/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
title: Azure Developer CLI (azd)
44
summary: |
5-
The Azure Developer CLI (azd) is an open-source tool that accelerates the time it takes for you to get started on Azure. azd provides a set of developer-friendly commands that map to key stages in your workflow (code, build, deploy, monitor). The CLI allows you to work consistently in a repeatable way across the terminal, your editor/integrated development environment, GitHub Actions pipeline, and more.
5+
The Azure Developer CLI (azd) is an open-source tool that accelerates your path from a local development environment to Azure. azd provides a set of developer-friendly commands that map to key stages in your workflow (code, build, deploy, monitor). The CLI allows you to work consistently in a repeatable way across the terminal, your editor/integrated development environment, GitHub Actions pipeline, and more.
66
77
metadata:
88
title: Azure Developer CLI (azd)

‎articles/azure-developer-cli/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.custom: devx-track-azdevcli, build-2023
1111

1212
# What is the Azure Developer CLI?
1313

14-
Azure Developer CLI (`azd`) is an open-source tool that accelerates the time it takes for you to get your application from local development environment to Azure. `azd` provides best practice, developer-friendly commands that map to key stages in your workflow, whether you're working in the terminal, your editor or integrated development environment (IDE), or CI/CD (continuous integration/continuous deployment).
14+
The Azure Developer CLI (azd) is an open-source tool that accelerates your path from a local development environment to Azure. `azd` provides best practice, developer-friendly commands that map to key stages in your workflow, whether you're working in the terminal, your editor or integrated development environment (IDE), or CI/CD (continuous integration/continuous deployment).
1515

1616
You can use `azd` with [extensible blueprint templates](./azd-templates.md) that include everything you need to get an application up and running on Azure. These templates include reusable infrastructure as code assets and proof-of-concept application code that can be replaced with your own app code. You can also [create your own template](./make-azd-compatible.md?pivots=azd-create) or find one to [build upon](./make-azd-compatible.md?pivots=azd-convert).
1717

‎articles/includes/dotnet-all.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -347,6 +347,7 @@
347347
| Microsoft.Azure.DataFactoryTestingFramework.Expressions | NuGet [0.2.7](https://www.nuget.org/packages/Microsoft.Azure.DataFactoryTestingFramework.Expressions/0.2.7) | | |
348348
| Microsoft.Azure.Functions.Worker.OpenTelemetry | NuGet [1.0.0-preview1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.OpenTelemetry/1.0.0-preview1) | | |
349349
| System Net Client Model | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/System.Net.ClientModel/1.0.0-beta.1) | | |
350+
| Unknown Display Name | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.ContentSafety.Extension.Embedded.Text/1.0.0) | | |
350351
| Anomaly Detector | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.AnomalyDetector/1.0.0) | | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.AnomalyDetector_1.0.0-preview.1/sdk/cognitiveservices/AnomalyDetector) |
351352
| App Service | NuGet [0.2.2-alpha](https://www.nuget.org/packages/Microsoft.Azure.AppService/0.2.2-alpha) | | |
352353
| Application Insights | NuGet [0.9.0-preview](https://www.nuget.org/packages/Microsoft.Azure.ApplicationInsights/0.9.0-preview) | | |

‎articles/includes/javascript-all.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@
192192
| Resource Management - Data Box | npm [5.0.0](https://www.npmjs.com/package/@azure/arm-databox/v/5.0.0) | [docs](/javascript/api/overview/azure/arm-databox-readme) | GitHub [5.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/databox/arm-databox) |
193193
| Resource Management - Data Box Edge | npm [2.1.0](https://www.npmjs.com/package/@azure/arm-databoxedge/v/2.1.0) | [docs](/javascript/api/overview/azure/arm-databoxedge-readme) | GitHub [2.1.0](https://github.com/Azure/azure-sdk-for-js/tree/@azure/arm-databoxedge_2.1.0/sdk/databoxedge/arm-databoxedge/) |
194194
| Resource Management - Data Catalog | npm [4.1.0](https://www.npmjs.com/package/@azure/arm-datacatalog/v/4.1.0) | [docs](/javascript/api/overview/azure/arm-datacatalog-readme) | GitHub [4.1.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datacatalog/arm-datacatalog) |
195-
| Resource Management - Data Factory | npm [16.0.0](https://www.npmjs.com/package/@azure/arm-datafactory/v/16.0.0) | [docs](/javascript/api/overview/azure/arm-datafactory-readme) | GitHub [16.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datafactory/arm-datafactory) |
195+
| Resource Management - Data Factory | npm [17.0.0](https://www.npmjs.com/package/@azure/arm-datafactory/v/17.0.0) | [docs](/javascript/api/overview/azure/arm-datafactory-readme) | GitHub [17.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datafactory/arm-datafactory) |
196196
| Resource Management - Data Lake Analytics | npm [1.1.1](https://www.npmjs.com/package/@azure/arm-datalake-analytics/v/1.1.1)<br>npm [2.0.0-beta.4](https://www.npmjs.com/package/@azure/arm-datalake-analytics/v/2.0.0-beta.4) | [docs](/javascript/api/overview/azure/arm-datalake-analytics-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datalake-analytics/arm-datalake-analytics) |
197197
| Resource Management - Data Migration | npm [2.1.1](https://www.npmjs.com/package/@azure/arm-datamigration/v/2.1.1)<br>npm [3.0.0-beta.3](https://www.npmjs.com/package/@azure/arm-datamigration/v/3.0.0-beta.3) | [docs](/javascript/api/overview/azure/arm-datamigration-readme) | GitHub [2.1.1](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datamigration/arm-datamigration) |
198198
| Resource Management - Data Protection | npm [2.1.0](https://www.npmjs.com/package/@azure/arm-dataprotection/v/2.1.0) | [docs](/javascript/api/overview/azure/arm-dataprotection-readme) | GitHub [2.1.0](https://github.com/Azure/azure-sdk-for-js/tree/@azure/arm-dataprotection_2.1.0/sdk/dataprotection/arm-dataprotection/) |

‎articles/includes/javascript-new.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -196,7 +196,7 @@
196196
| Resource Management - Data Box | npm [5.0.0](https://www.npmjs.com/package/@azure/arm-databox/v/5.0.0) | [docs](/javascript/api/overview/azure/arm-databox-readme) | GitHub [5.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/databox/arm-databox) |
197197
| Resource Management - Data Box Edge | npm [2.1.0](https://www.npmjs.com/package/@azure/arm-databoxedge/v/2.1.0) | [docs](/javascript/api/overview/azure/arm-databoxedge-readme) | GitHub [2.1.0](https://github.com/Azure/azure-sdk-for-js/tree/@azure/arm-databoxedge_2.1.0/sdk/databoxedge/arm-databoxedge/) |
198198
| Resource Management - Data Catalog | npm [4.1.0](https://www.npmjs.com/package/@azure/arm-datacatalog/v/4.1.0) | [docs](/javascript/api/overview/azure/arm-datacatalog-readme) | GitHub [4.1.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datacatalog/arm-datacatalog) |
199-
| Resource Management - Data Factory | npm [16.0.0](https://www.npmjs.com/package/@azure/arm-datafactory/v/16.0.0) | [docs](/javascript/api/overview/azure/arm-datafactory-readme) | GitHub [16.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datafactory/arm-datafactory) |
199+
| Resource Management - Data Factory | npm [17.0.0](https://www.npmjs.com/package/@azure/arm-datafactory/v/17.0.0) | [docs](/javascript/api/overview/azure/arm-datafactory-readme) | GitHub [17.0.0](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datafactory/arm-datafactory) |
200200
| Resource Management - Data Lake Analytics | npm [1.1.1](https://www.npmjs.com/package/@azure/arm-datalake-analytics/v/1.1.1)<br>npm [2.0.0-beta.4](https://www.npmjs.com/package/@azure/arm-datalake-analytics/v/2.0.0-beta.4) | [docs](/javascript/api/overview/azure/arm-datalake-analytics-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datalake-analytics/arm-datalake-analytics) |
201201
| Resource Management - Data Migration | npm [2.1.1](https://www.npmjs.com/package/@azure/arm-datamigration/v/2.1.1)<br>npm [3.0.0-beta.3](https://www.npmjs.com/package/@azure/arm-datamigration/v/3.0.0-beta.3) | [docs](/javascript/api/overview/azure/arm-datamigration-readme) | GitHub [2.1.1](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/datamigration/arm-datamigration) |
202202
| Resource Management - Data Protection | npm [2.1.0](https://www.npmjs.com/package/@azure/arm-dataprotection/v/2.1.0) | [docs](/javascript/api/overview/azure/arm-dataprotection-readme) | GitHub [2.1.0](https://github.com/Azure/azure-sdk-for-js/tree/@azure/arm-dataprotection_2.1.0/sdk/dataprotection/arm-dataprotection/) |

‎articles/includes/python-all.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
| Name | Package | Docs | Source |
22
| ---- | ------- | ---- | ------ |
33
| AI Generative | PyPI [1.0.0b8](https://pypi.org/project/azure-ai-generative/1.0.0b8) | [docs](/python/api/overview/azure/ai-generative-readme?view=azure-python-preview&amp;preserve-view=true) | GitHub [1.0.0b8](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-generative_1.0.0b8/sdk/ai/azure-ai-generative/) |
4-
| AI Model Inference | PyPI [1.0.0b3](https://pypi.org/project/azure-ai-inference/1.0.0b3) | [docs](/python/api/overview/azure/ai-inference-readme?view=azure-python-preview&amp;preserve-view=true) | GitHub [1.0.0b3](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-inference_1.0.0b3/sdk/ai/azure-ai-inference/) |
4+
| AI Model Inference | PyPI [1.0.0b4](https://pypi.org/project/azure-ai-inference/1.0.0b4) | [docs](/python/api/overview/azure/ai-inference-readme?view=azure-python-preview&amp;preserve-view=true) | GitHub [1.0.0b4](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-inference_1.0.0b4/sdk/ai/azure-ai-inference/) |
55
| AI Resources | PyPI [1.0.0b8](https://pypi.org/project/azure-ai-resources/1.0.0b8) | [docs](/python/api/overview/azure/ai-resources-readme?view=azure-python-preview&amp;preserve-view=true) | GitHub [1.0.0b8](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-resources_1.0.0b8/sdk/ai/azure-ai-resources/) |
66
| Anomaly Detector | PyPI [3.0.0b6](https://pypi.org/project/azure-ai-anomalydetector/3.0.0b6) | [docs](/python/api/overview/azure/ai-anomalydetector-readme?view=azure-python-preview&amp;preserve-view=true) | GitHub [3.0.0b6](https://github.com/Azure/azure-sdk-for-python/tree/azure-ai-anomalydetector_3.0.0b6/sdk/anomalydetector/azure-ai-anomalydetector/) |
77
| App Configuration | PyPI [1.7.1](https://pypi.org/project/azure-appconfiguration/1.7.1) | [docs](/python/api/overview/azure/appconfiguration-readme) | GitHub [1.7.1](https://github.com/Azure/azure-sdk-for-python/tree/azure-appconfiguration_1.7.1/sdk/appconfiguration/azure-appconfiguration/) |

0 commit comments

Comments
 (0)