创建模板结构

已完成

Azure Developer CLI (azd) 有助于你使用 azd init 命令和初学者模板为应用生成新模板。 在本单元中,创建一个新模板的基本基架或结构,对于本模块的其余部分,你将以该模板为基础进行生成。

  1. 在本地计算机上的空目录中,运行 azd init 命令。

    azd init
    
  2. 命令输出显示用于初始化 azd 模板的三种不同的选项:

  • 使用当前目录中的代码:分析应用代码,为你创建和配置某些模板资产。

  • 选择模板:选择包含基本文件夹结构、基础设施即代码文件和其他样板配置文件的现有入门模板,以简化模板的创建流程。

  • 创建最小项目:生成要开始使用的最低配置文件。

    创建 Azure 开发人员 CLI 模板概述 文档中详细了解这些不同的选择。

  1. 选择 选择模板 选项,azd 显示预配置的可用模板列表。

  2. 搜索 Starter,然后从结果列表中选择 Starter - Bicep 选项。 Azure Developer CLI 还支持使用 Terraform(如果你喜欢该选项)。 Terraform 支持目前处于 alpha 状态,必须手动启用

  3. 当系统提示输入环境名称时,请输入“azdlearn”或你选择的名称。 环境名称会影响 Azure 中预配资源的命名。

  4. 在当前目录内创建一组文件夹:

    初学者模板结构。

注意

你可能已经注意到,azd init 命令还提供了一个名为“Minimal”的项目模板,其中包含了尽可能简单的模板结构。 但是,所选的“初学者 - Bicep”模板包含其他基架代码,这些代码非常有用,但仍与技术无关,因此它通常是入门的绝佳选择。

生成的文件夹提供 azd 模板的所有基本构建基块:

  • .azure - 包含模板 Azure 环境的基本设置(例如环境名称)的文件夹。
  • .devcontainer - 包含用于在开发容器环境中运行模板的配置文件的文件夹。
  • infra - 包含模板基础结构即代码的初学者 Bicep 文件的文件夹。 如果选择了 Terraform 初学者模板,则此文件夹将改为包含 Terraform 文件。
  • azure.yaml - 描述应用程序的各部分如何映射到 Azure 中的各服务的文件。
  • .gitignore - 一个初学者 .gitignore 文件,用于从 git 版本控制中排除不需要的文件。
  • README.md - 一个入门级README文件,为模板用户提供通用指导。

此初学者模板包含创建自己的 azd 模板所需的大部分内容。 在接下来的几个单元中,了解如何更新这些现有文件并添加新资产以生成完整的模板。