通过 Visual Studio Code 部署 Bicep 文件

可以将 Visual Studio Code 与 Bicep 扩展配合使用来部署 Bicep 文件。 Bicep 扩展提供了两个选项用于在 Visual Studio Code 中部署 Bicep 文件 - 部署窗格部署命令。 在创作过程中,部署窗格的快速反馈、验证和假设分析功能可以帮助快速进行迭代,而部署命令则适用于无需关注的一键式部署体验。

部署窗格

部署窗格在 VS Code 中提供了一个交互式 UI,可以访问您的 Azure 帐户来进行验证、部署和假设操作,提供即时反馈,无需离开 VS Code 编辑器。

若要使用部署窗格,请按照以下步骤操作:

  1. 在 VS Code 中打开.bicep.bicepparam文件。

  2. 有两种方法可以打开部署窗格:

    • 选择右上角的“显示部署窗格”按钮,如以下屏幕截图所示:

      打开的部署窗格按钮的屏幕截图。

      默认情况下,VS Code 会在一侧打开部署窗格。 若要在新选项卡中打开它,请在选择按钮时按住 Alt

    • 打开部署窗格的另一种方法是通过命令面板。 按 Ctrl+Shift+P,然后选择“显示部署窗格”或“显示部署窗格到侧边”

      命令面板中显示部署窗格的屏幕截图。

    部署窗格如以下屏幕截图所示:

    Visual Studio Code 中初始部署窗格的屏幕截图。

  3. 选择 “选取范围 ”以定义部署范围。 身份验证后,可以选择所需的部署的订阅和资源组。

  4. 如果为 .bicep 文件打开了部署窗格,请填写所需的参数值,或选择“ 选取 JSON 参数文件 ”以选择 JSON 参数文件。

    在 Visual Studio Code 的部署窗格中选取参数文件的屏幕截图。

  5. 选择所需的动作 - 部署验证假设

    • 部署:部署到 Azure,结果包括定义的输出显示在部署窗格中。

      以下屏幕截图显示了成功的部署。 可以选择蓝色地球图标以查看 Azure 门户中的部署或单个资源。

      Visual Studio Code 中部署窗格的屏幕截图。

    • 验证:对 Azure 执行 Bicep 文件的运行时验证,确保资源、参数和策略在实际部署环境中正确。 与仅执行脱机验证的 linter 不同,此验证与 Azure 交互以检测潜在的部署问题。

      以下屏幕截图显示了验证失败的示例。

      Visual Studio Code 中部署窗格验证错误的屏幕截图。

    • What-if:直接从部署窗格执行 What-If 分析。 该窗格显示结果,展示计划中的更改。 这与 Azure PowerShell 和 Azure CLI 中的 what-if 命令执行的功能相同。 有关详细信息,请参阅 Bicep 部署 what-if 操作

你可以在迭代修改 .bicep 或 .bicepparam 文件时保持部署窗格打开。 如果您保存并重新运行上述操作之一,操作将针对更新后的文件运行。

部署命令

你可以部署到任何范围。 本文介绍如何部署到资源组。

在 Visual Studio Code 中打开的 Bicep 文件中,有三种方式可以找到该命令:

  • 右键单击资源管理器窗格中的 Bicep 文件名,而不是“OPEN EDITORS”下的文件名

    在资源管理器窗格中的“上下文”菜单中部署 Bicep 文件的屏幕截图。

  • 右键单击 Bicep 文件内的任意位置,然后选择“部署 Bicep 文件”

  • “视图”菜单中选择“命令面板”,然后选择“Bicep:部署 Bicep 文件”

    上下文菜单中“部署 Bicep 文件”的屏幕截图。

选择命令后,按照向导输入值:

  1. 如果未登录,请按照提示中的说明完成登录过程。

    登录的屏幕截图。

    注意

    Visual Studio Code 中的 Bicep 部署命令使用新的内置 身份验证 API 来管理身份验证。 它不使用 bicepconfig.json 中的云配置文件。 若要登录到自定义云,请选择“管理>设置>扩展>Microsoft 帐户>Microsoft 主权云”。 目前不支持多个登录帐户。

  2. 选择或创建资源组。

  3. 选择参数文件或“无”以输入参数值:

    选择参数文件的屏幕截图。

  4. 如果选择“无”,请输入参数值:

    “输入参数值”的屏幕截图。

    输入值后,可以选择根据此部署中使用的值创建参数文件:

    创建参数文件的屏幕截图。

    如果选择“是”,将在同一文件夹中创建名为 <Bicep-file-name>.parameters.json 的参数文件。

有关 Visual Studio Code 命令以及如何使用 Visual Studio Code 创建 Bicep 文件的更多信息,请参阅使用 Visual Studio Code 创建 Bicep 文件

后续步骤