你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure Developer CLI 创建环境

  • 项目

在本文中，你将安装 Azure Developer CLI (AZD)，通过将应用基础结构预配到 Azure 部署环境来创建新的部署环境，并将应用代码部署到预配的部署环境中。

Azure Developer CLI (AZD) 是一种开源工具，可加快应用程序从本地开发环境到 Azure 所需的时间。 AZD 提供最佳做法和适合开发人员的命令，这些命令映射到工作流的关键阶段，无论你是在终端、编辑器或集成开发环境 (IDE) 还是在 CI/CD 中工作均是如此。

若要了解如何设置 AZD 以与 Azure 部署环境配合使用，请参阅将 Azure Developer CLI 与 Azure 部署环境配合使用。

先决条件

你应该：

准备使用 AZD

首次使用 AZD 时，需要完成一些一次性设置任务。 这些任务包括安装 Azure Developer CLI、登录到 Azure 帐户，以及为 Azure 部署环境启用 AZD 支持。

安装适用于 Visual Studio Code 的 Azure Developer CLI 扩展

安装 azd 时，azd 工具安装在 azd 范围内而非全局安装，并且会在 azd 卸载时随之删除。 可以在 Visual Studio Code 中或从命令行安装 azd。

要在 Visual Studio Code 中启用 Azure Developer CLI 功能，请安装 Azure Developer CLI 扩展版本 v0.8.0-alpha.1-beta.3173884。 选择活动栏中的“扩展”图标，搜索 Azure Developer CLI，然后选择“安装”。

Visual Studio Code 的屏幕截图，其中显示了命令面板中的“登录”命令。

使用 Azure Developer CLI 登录

通过登录来访问 Azure 资源。 启动登录时，将打开一个浏览器窗口，并提示你登录到 Azure。 登录后，终端会显示已登录到 Azure 的消息。

使用命令面板登录到 AZD：

Visual Studio Code 的屏幕截图，其中显示了“扩展”窗格，并突出显示了“Azure Developer CLI”和“安装”。

从命令面板发出的命令的输出显示在 azd dev 终端中，如下例所示：

azd dev 终端的屏幕截图，其中显示了按任意键关闭消息。

为 ADE 启用 AZD 支持

可使用标准命令（如 azd up 或 azd provision）将 AZD 配置为预配资源并将资源部署到部署环境。 当 platform.type 设置为 devcenter 时，所有 AZD 远程环境状态和预配都将使用开发人员中心组件。 AZD 使用开发人员中心目录中定义的基础结构模板之一进行资源预配。 在此配置中，不会使用本地模板中的 infra 文件夹。

Visual Studio Code 的屏幕截图，其中显示了命令面板中的“启用支持”命令。

基于现有代码创建环境

准备就绪之后，可以创建要在其中操作的环境。 可从本地文件夹中的代码开始，也可克隆现有存储库。 此示例使用本地文件夹中的代码创建环境。

初始化新应用程序

初始化新应用程序时会创建 AZD 与你的应用程序配合使用所需的文件和文件夹。

AZD 使用 azure.yaml 文件来定义环境。 azure.yaml 文件定义并描述应用和及其所使用的 Azure 资源的类型。 要详细了解 azure.yaml，请参阅 Azure Developer CLI 的 azure.yaml 架构。

  1. 在 Visual Studio Code 中，打开包含应用程序代码的文件夹。

  2. 打开命令面板，输入 Azure Developer CLI init，然后从列表中选择“Azure Developer CLI (azd): init”。

    Visual Studio Code 命令面板的屏幕截图，其中突出显示了“Azure Developer CLI (azd): init”。

  3. 在模板列表中，要继续操作而不选择模板，请按 Enter 两次。

  4. 在 AZD 终端中，选择“使用当前目录中的代码”。

    Visual Studio Code 中 AZD 终端的屏幕截图，其中显示了“在当前目录中使用代码”提示。

  5. azd init 标识应用代码中定义的服务，并提示你确认并继续、删除服务或添加服务。 选择“确认并继续初始化应用”。

    屏幕截图显示提示确认并继续、删除服务或添加服务的 AZD init 提示。

  6. azd init 会继续收集信息来配置应用。 对于此示例应用程序，系统会提示你输入 MongoDB 数据库实例的名称以及服务侦听的端口。

    屏幕截图显示数据库名称的 azd init 提示。

  7. 为本地 AZD 环境输入名称。

    屏幕截图显示 azd init 提示“输入新环境名称”。

  8. azd init 显示你有权访问的项目的列表。 选择适用于你的环境的项目

    屏幕截图显示 azd init 提示“选择项目”。

  9. azd init 显示项目中的环境定义的列表。 选择环境定义。

    屏幕截图显示 azd init 提示“选择环境定义”。

    AZD 会在项目的根目录中创建项目资源，包括 azure.yaml 文件。

将基础结构预配到 Azure 部署环境

准备就绪后，可将本地环境预配到 Azure 中的 Azure 部署环境远程环境中。 此过程将预配在开发人员中心目录中的环境定义中定义的基础结构和资源。

  1. 在资源管理器中，右键单击 azure.yaml，然后选择 Azure Developer CLI (azd) >“预配 Azure 资源(provision)”。

    屏幕截图为突出显示了“azure.yaml”的 Visual Studio Code，以及突出显示了“Azure Developer CLI”和“预配环境”的 AZD 上下文菜单。

  2. AZD 将扫描 Azure 部署环境以查找可以访问的项目。 在 AZD 终端，选择或输入以下信息：

    1. 集成
    2. 环境定义
    3. 环境类型
    4. 位置

  3. AZD 指示 ADE 根据你在上一步中提供的信息创建新环境。

  4. 你可在 Azure 门户或开发人员门户中查看创建的资源。

列出现有环境（可选）

可通过列出现有环境来验证是否已创建环境。

  1. 在资源管理器中，右键单击 azure.yaml，然后选择 Azure Developer CLI (azd) >“查看本地和远程环境(env list)”。

    屏幕截图为突出显示了“azure.yaml”的 Visual Studio Code，以及突出显示了“Azure Developer CLI”和“查看本地和远程环境”的 AZD 上下文菜单。

    系统会提示你选择项目和环境定义。

将代码部署到 Azure 部署环境

预配环境后，可将代码部署到环境。

  1. 在资源管理器中，右键单击 azure.yaml，然后选择 Azure Developer CLI (azd) >“部署 Azure 资源(deploy)”。

    屏幕截图为突出显示了“azure.yaml”的 Visual Studio Code，以及突出显示了“Azure Developer CLI”和“部署到 Azure”的 AZD 上下文菜单。

  2. 可通过选择 AZD 终端中列出的终结点 URL 来验证是否已部署代码。

清理资源

完成环境部署之后，可删除 Azure 资源。

在资源管理器中，右键单击 azure.yaml，然后选择 Azure Developer CLI (azd) >“删除部署和资源(down)”。

屏幕截图为突出显示了“azure.yaml”的 Visual Studio Code，以及突出显示了“Azure Developer CLI”和“删除部署和资源(向下)”的 AZD 上下文菜单。

出现提示时，请按 y 以确认要删除环境。

相关内容