快速入门:安装 Bicep 工具

在部署 Microsoft Graph Bicep 类型之前,必须设置创作和部署环境。 本文介绍如何安装以下工具,这些工具在本文档的快速入门和教程中使用:

  • 创作:Visual Studio Code (VS Code) 和 Bicep 扩展
    • 确保 Bicep 版本 v0.29.45 或更高版本
  • 部署:Azure CLI

或者,可以使用 Visual Studio 和 Bicep 扩展进行创作,使用 Azure PowerShell 进行部署。 有关详细信息,请参阅安装 Bicep 工具

重要

Microsoft Graph Bicep 目前为预览版。 有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款,请参阅 Microsoft Azure 预览版的补充使用条款

VS Code 和 Bicep 扩展

若要创建 Bicep 文件,需要一个很好的 Bicep 编辑器。 我们建议:

  • Visual Studio Code - 如果尚未安装 Visual Studio Code,请安装

  • 用于 Visual Studio Code 的 Bicep 扩展。 装有 Bicep 扩展的 Visual Studio Code 提供语言支持和资源自动完成功能。 该扩展有助于你创建和验证 Bicep 文件。

    要安装该扩展,请在“扩展”选项卡或 Visual Studio Marketplace 中搜索“bicep”。

    选择“安装” 。

    安装 Bicep 扩展的屏幕截图。

要验证是否已安装该扩展,请打开任何文件扩展名为 .bicep 的文件。 在右下角,应该会看到语言模式更改为 Bicep。

Bicep 语言模式的屏幕截图。

如果在安装过程中出现错误,请参阅排查 Bicep 安装问题

Azure CLI

将 Azure CLI 与 Bicep 配合使用时,你具有部署反向编译 Bicep 文件所需的一切。 在执行需要 Bicep CLI 的命令时,Azure CLI 会自动安装 Bicep CLI。

必须安装 Azure CLI 2.20.0 或更高版本。 要安装或更新 Azure CLI,请参阅:

要验证当前的版本,请运行:

az --version

若要验证 Bicep CLI 安装,请使用:

az bicep version

要升级到最新版本,请使用:

az bicep upgrade

有关更多命令,请参阅 Bicep CLI

重要

Azure CLI 安装独立的 Bicep CLI 实例。 此实例不会与你手动安装的任何版本发生冲突。 Azure CLI 不会将 Bicep CLI 添加到你的路径。

已设置 Bicep 环境。 现在可以继续创作一个 Bicep 文件,该文件声明Microsoft Graph 资源,并在交互模式下部署该文件。

下一步