Microsoft Graph 资源的 Bicep 模板

Microsoft Graph 资源的 Bicep 模板允许你在文件中定义要部署的租户基础结构,例如组或应用程序,然后在整个开发生命周期内使用该文件重复部署基础结构。 该文件使用 Bicep 语言(一种特定于域的语言 (DSL),该语言使用声明性语法来部署资源,通常为 基础结构部署代码 解决方案。

假设你想要从使用 Microsoft Entra ID 保护 Web 应用的Azure 逻辑应用调用自定义 API。 若要为逻辑应用和 Web 应用创建两个应用程序标识,可以在 Bicep 文件中定义 Microsoft Graph 应用程序和服务主体资源,而不是事先手动创建它们。 在同一文件中,可以定义逻辑应用和 Web 应用资源。 然后,可以在开发生命周期内重复部署文件,并确信所有 Azure 和 Microsoft Graph 资源都一致地部署。

重要

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

Microsoft Graph Bicep 扩展

Bicep 最初创建是为了通过 Azure 资源管理器 JSON 模板提供改进的创作体验,以便部署和管理 Azure 资源。 Bicep 扩展性扩展了原始功能,允许 Bicep 模板引用 Azure 资源管理器之外的资源。

使用 Bicep 扩展,新的 Microsoft Graph Bicep 扩展 允许你在 Bicep 模板文件中创作、部署和管理一组有限的 Microsoft Graph 资源(当前 Microsoft Entra ID 资源),以及 Azure 资源。

Microsoft Graph Bicep 扩展

  • Azure 客户可以使用熟悉的工具将 Azure 资源与他们依赖的 Microsoft Graph 资源(例如应用程序和服务主体)结合使用,使用基础结构即代码(IaC)和 DevOps 实践。
  • 它还为现有 Microsoft Graph 客户打开了大门,以便使用 Bicep 模板和 IaC 做法来部署和管理其租户的资源。

Microsoft Graph Bicep 扩展的优点

  • 创作体验:使用 Bicep 扩展 VS Code 创建 Bicep 文件时,可以获得相同的一流创作体验。 编辑器提供丰富的类型安全、智能感知和语法验证。

    Bicep 文件创作示例

    还可以使用 Visual Studio 的 Bicep 扩展在 Visual Studio 中创建 Bicep 文件。

  • 支持 beta 版和 v1.0 API 版本:Microsoft Graph Bicep 扩展允许在同一 Bicep 文件中引用受支持 Microsoft Graph 资源类型的 beta 版本和 v1.0 版本。

  • 可反复效果:在整个开发生命周期内反复部署基础结构,并确保以一致的方式部署资源。 Bicep 文件是幂等的,这意味着,可以多次部署同一文件,并获得处于相同状态的相同资源类型。 可以开发一个文件来表示所需的状态,而无需开发大量的独立文件来表示更新。

  • 业务流程:无需担心有序操作的复杂性。 资源管理器会协调相互依赖的资源的部署,以按正确的顺序创建这些资源。 在可能的情况下,资源管理器将会并行部署资源,因此,其完成速度比串行部署更快。 通过一个命令部署文件,而无需使用多个强制性命令。

开始使用

若要开始使用 Bicep,请执行以下操作:

  1. 了解 Bicep 及其用法。
  2. 安装工具。 请参阅设置 Bicep 开发和部署环境。 或者,可以使用 VS Code Devcontainer/Codespaces 存储库 获取预配置的创作环境。
  3. 完成 Bicep 快速入门和适用于 BicepLearn 模块。

从 Microsoft Graph 开始:

  1. 了解 Microsoft Graph
  2. 了解 Microsoft Graph 中的身份验证和授权原则
  3. 试用 Microsoft Graph 教程

熟悉 Bicep 和 Microsoft Graph 后:

  1. 完成 Microsoft Graph Bicep 快速入门,创作包含 Microsoft Graph 资源的第一个 Bicep 文件,并部署该文件。
  2. 若要了解可用于 Bicep 文件的 Microsoft Graph Bicep 类型,请参阅 Microsoft Graph Bicep 资源参考
  • 快速入门入门,创作包含 Microsoft Graph 资源的第一个 Bicep 文件。