Azure 开发人员 CLI 围绕一个功能强大的模板系统设计,可以简化 Azure 资源的部署和预配。 使用开发 azd时,可以选择生成自己的模板,也可以从现有模板的可配置列表中进行选择。 本文介绍如何使用模板列表并配置本地 azd 安装以支持不同的模板列表源。
了解模板源
azd模板源指向一个 JSON 配置文件,该文件描述可用模板的列表及其基本元数据,例如模板源代码的标题、说明和位置(通常是 GitHub 存储库)。 启用模板源时,它定义的模板可通过其他命令使用 azd 。 例如,下面的模板源 JSON 代码片段定义了两个模板:
[
{
"title": "Starter - Bicep",
"description": "A starter template with Bicep as infrastructure provider",
"preview": "./templates/images/test.png",
"website": "https://github.com/Azure/azure-dev",
"author": "Azure Dev",
"source": "https://github.com/Azure-Samples/azd-starter-bicep",
"tags": ["bicep", "msft"]
},
{
"title": "Starter - Terraform",
"description": "A starter template with Terraform as infrastructure provider",
"preview": "./templates/images/test.png",
"website": "https://github.com/Azure/azure-dev",
"author": "Azure Dev",
"source": "https://github.com/Azure-Samples/azd-starter-terraform",
"tags": ["terraform", "msft"]
}
}
azd 允许一次启用多个模板源。 当前有以下模板源选项可供选择:
- awesome-azd - 默认情况下启用的真棒 AZD 库中的模板列表。
- default - 一小组特选模板,用于演示不同的技术堆栈。
- file - 指向模板源 JSON 配置文件的本地/网络路径。
- url - 指向模板源 JSON 配置文件的 HTTP(S) 可寻址路径。
- gh - 指向 GitHub 存储库。
- ade - 指向 Azure 部署环境模板列表。 详细了解 Azure 部署环境的 Azure 开发人员 CLI 支持。
使用模板源
azd 提供了多个命令来配置模板源。
使用 azd template source list 命令列出当前配置的所有模板源:
azd template source list
包含两个已配置的模板源的示例输出:
Key Name Type Location
awesome-azd Awesome AZD awesome-azd https://aka.ms/awesome-azd/templates.json
default Default resource
azd template source add使用命令添加新模板源。 此命令接受以下参数:
- 键:模板源的技术名称。
- --type、-t:模板源类型 - 有效值为 文件、 URL 和 GitHub 的 gh 。
- --location,-l:模板源位置,应为本地网络或 HTTP(S) Web URI。
- --displayName,-n:模板源显示名称(可选),如果省略,将使用 密钥 。
azd template source add <key> --type <file-or-url> --location <your-uri> --displayname <your-display-name>
azd template source remove使用命令删除模板源:
azd template source remove <key>
azd config reset使用命令将模板配置重置回默认设置:
azd config reset
使用模板列表
配置模板源后,使用 azd template list 命令列出这些源中的可用模板:
azd template list
例如,默认安装azd列出了来自 awesome-azd 模板源的以下模板:
Name Source Repository Path
Event Driven Java Application with Azure Service Bus Awesome AZD Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL Awesome AZD Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart Awesome AZD Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript) Awesome AZD Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI Awesome AZD Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps Awesome AZD Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments Awesome AZD Azure-Samples/azd-deployment-environments
Starter - Bicep Awesome AZD Azure-Samples/azd-starter-bicep
Starter - Terraform Awesome AZD Azure-Samples/azd-starter-terraform
...
# Additional templates omitted
--source包含仅列出来自特定源的模板的标志:
azd template list --source <source-name>
若要从显示的列表中初始化模板,请 azd init 运行该命令并提供模板的路径:
azd init --template <path-value>
使用 Azure 部署环境
Azure 开发人员 CLI (azd) 还提供对 Azure 部署环境的支持。 Azure 部署环境(ADE)是预定义订阅中部署的 Azure 资源的预配置集合。 Azure 治理根据环境类型(如沙箱、测试、暂存或生产)应用于这些订阅。 使用 Azure 部署环境,可以强制实施企业安全策略,并提供一组精选的预定义基础结构即代码(IaC)模板。
ADE 集成超出了本文的范围。 了解有关在 Azure 开发人员 CLI 对 Azure 部署环境支持文档中配置ade支持的详细信息。