从新的Azure开发人员 CLI （azd） 模板开始

可以使用不同的创作方法在新的Azure开发人员 CLI （azd） 模板中生成标准文件：

  • 在 azd init 中使用 GitHub Copilot 集成。 内置工作流分析现有项目文件或帮助你规划新项目、创建模板资产并运行预部署验证。
  • 使用另一个 AI 编码助手。 让助手创建相同的 azure.yaml、基础设施即代码、应用程序和支持文件，且不要直接与 azd init 集成。
  • 直接编写这些文件。 当你想要完全控制或不使用 AI 编码助手时，请自行创建和编辑模板资产。

本文主要聚焦于内置的 GitHub Copilot 工作流，因为它提供了与 azd 集成的引导式体验。 无论创作方法如何，在部署前查看并验证每个文件。

Important

azd init 中的 GitHub Copilot 集成目前为预览版。 在正式发布之前，预览功能可能会更改。 有关详细信息，请参阅 azd 功能版本控制和发布策略。

生成的资产是标准、可 azd 编辑的模板文件。 初始化后，可以直接或使用任何 AI 编码助手更新它们。

GitHub Copilot的先决条件

若要使用内置Copilot工作流，需要：

  • Azure开发人员 CLI 1.23.11 或更高版本。
  • 有效的 GitHub Copilot 订阅。
  • Git，用于 azd init 在修改文件之前检查工作树。
  • 交互式终端会话。

如果尚未使用GitHub Copilot进行身份验证，azd系统会提示你登录。

运行azd version以检查已安装Azure开发人员 CLI 版本。

Note

工作流azd init在终端中启动专用 GitHub Copilot 智能体会话。 它不会在 Visual Studio Code 中使用或继续当前处于活动状态的 GitHub Copilot 对话助手 会话。

使用 GitHub Copilot 生成

  1. 在要在其中生成模板的目录中打开终端。

    Note

    该目录可以包含现有应用程序、基础结构项目或新解决方案的初始文件。 如果目录包含未提交的更改， azd 请要求你在继续之前进行确认。 先提交或暂存重要修改。

  2. 运行 azd init：

    azd init

  3. 选择“使用 GitHub Copilot（预览版）进行设置”。

    初始化提示类似于以下示例：

    ? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

  4. 查看请求的工具访问权限，并授予对工作流所需的工具的访问权限。 Copilot使用azd和Azure开发功能来检查项目、创建文件并验证结果。

  5. 如果 azd 提示你配置模型和推理级别，请选择相应的模型和推理级别。

    在第一次运行时，提示符使用以下标签。 可用的模型和推理选项取决于GitHub Copilot帐户和所选模型：

    ? Select AI model
? Select reasoning effort level

  6. 描述要生成的内容。 包括相关要求，例如：

    • 模板是仅包括应用程序代码、基础结构还是两者。
    • 应用程序语言和框架（如果已知）。
    • 要使用的Azure服务和托管平台。
    • 是否使用 Bicep 还是 Terraform。
    • 安全性、网络、扩展和区域要求。

    例如：

    Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.

  7. 回答来自Copilot的任何体系结构或配置问题。 代理为Azure准备项目，生成模板资产，并运行预部署验证。

  8. 查看Copilot创建或更改的文件的整体结构。 确认模板包含解决方案的预期项目配置、基础结构目录、应用程序源和支持资产。

    例如，生成的仅限基础结构的模板可能包含以下关键文件：

    azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep

    有关查看配置和基础结构内容的详细指南，请参阅 “浏览和编辑模板文件”。

预配和部署模板

批准生成的文件后，运行以下命令：

azd up

该命令创建或选择环境azd、预配Azure资源、打包任何应用程序服务并部署它们。 有关详细的命令细目，请参阅 “浏览 azd up 工作流”。

使用另一个创作方法

其他 AI 编码助手未直接连接到 azd init 工作流，但它们可以创建相同的标准模板资产。 你还可以直接编写各项资源。

自行创建这些资产，或要求其他编码助手分析要求并创建这些资产：

  • 定义 azure.yaml 项目和可部署服务的文件。
  • Bicep 或 Terraform 文件，用于预配所需的 Azure 资源。
  • 资源输出和应用程序环境变量。
  • Dockerfile 文件、部署配置以及在需要时使用的配套脚本。

若要在使用另一个代理之前提供最少的起点，请运行：

azd init --minimal

如果使用另一个编码助手，请指示其遵循azure.yaml架构、Azure基础结构安全做法以及Azure开发人员 CLI 模板中所述的模板约定。 如果直接创作文件，请使用与实现指南相同的引用。 在运行 azd up之前查看并验证所有文件。

相关内容

请求帮助

有关如何提交 bug、请求帮助或为 Azure 开发人员 CLI 提出新功能的信息，请访问 troubleshooting and support 页。

  • Last updated on