浏览 Azure 开发人员 CLI 初始化工作流

2025-05-30

Azure 开发人员 CLI （azd）提供了一组命令，用于简化在 Azure 上开发、预配和部署应用。该 azd init 命令帮助您生成用于和 azd一起工作的文件和配置，从而设置新的或现有的项目。本文介绍可用的不同初始化工作流，以及如何为开发方案选择最佳选项。

初始化工作流

azd init 命令支持多个工作流，以准备您的应用与 azd 配合工作：

使用当前目录中的代码：分析现有应用代码库以生成适当的 azd 配置文件和资源。
选择模板：克隆azd模板并从模板库初始化模板。
创建最小项目：将基本 azure.yaml 文件初始化为从头开始构建自己的 azd 模板的起点。

选择最适合你的项目的方法。在 “创建模板”概述和相关文章中更详细地概述了所有这些流。以下部分提供了每个流的概念性概述。

在当前目录中使用代码

如果已有应用代码库，并且想要准备它以便使用 azdAzure 进行部署，请使用此工作流。

导航到项目的根目录。
运行 azd init 命令：
```
azd init
```

选择 在当前目录中使用代码。 azd 将：

扫描目录以确定应用使用的语言或框架。
选择适当的托管平台，例如 Azure 容器应用。
提示您根据需要添加或删除已发现的服务。

? How do you want to initialize your app? Use code in the current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

选择 “确认并继续初始化应用 ”以完成工作流。 azd 在应用目录中创建以下内容：
- 定义 azure.yaml 应用服务并将其映射到托管资源的文件。
- 用于保存配置设置（例如环境名称）的 .azure 文件夹。
- 为您的应用语言和托管平台配置的.gitignore文件。
（可选）运行 azd up 以创建 Azure 容器应用资源并部署应用。

应用现在构建为模板 azd ，可以继续使用更多 Azure 资源和服务进行开发和扩展。

选择模板

通过此工作流，可以从预生成 azd 模板开始，该模板通常包括应用程序代码和必要的 Azure 基础结构定义。

运行 azd init 命令：
```
azd init
```
注释

还可以使用azd init参数运行--template，以按名称直接初始化模板，并跳过工作流选择。

选择模板。 azd 显示已配置的模板源中的可用模板列表。

? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

键入以筛选结果并搜索 Hello AZD 模板。按 Enter 克隆并初始化模板。
（可选）运行 azd up 以预配模板资源并将其部署到 Azure。

还可以使用初始化的模板作为进一步开发的起点。

创建最小项目

对于想要从最少的设置开始并手动自定义所有内容的高级用户，此选项仅提供基本配置。

运行 azd init 命令：
```
azd init
```
注释

您还可以使用azd init参数运行--minimal以跳过工作流选择。

出现提示时，输入模板的名称 azd ，然后按 Enter。

? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.

仅创建基本 azure.yaml 配置文件。不会添加任何应用程序代码或全面的基础结构模板，因此需要根据要求手动创建或自定义基础结构文件。

（可选）使用 azd add撰写功能开始将 Azure 资源添加到应用。

后续步骤

使用 azd init初始化项目后，可以：

修改生成的基础结构文件以自定义 Azure 资源。
用于 azd provision 在 Azure 中创建所需的资源。
用于 azd deploy 将应用程序代码部署到预配的资源。
了解 Azure 开发人员 CLI 的 up 命令工作流，以便通过单个命令同时进行预配和部署。

通过