什么是 Azure 蓝图（预览版）？

正如工程师或建筑师使用蓝图勾勒出项目的设计参数一样，通过 Azure 蓝图，云架构师和中心信息技术组同样可以定义一组可重复的 Azure 资源，这些资源实现并遵守组织的标准、模式和要求。 通过 Azure 蓝图，开发团队可以快速生成和构建新环境，并确信这些生成的环境符合组织规定，还可以使用一组有助于加快开发和交付过程的内置组件（如网络）。

蓝图是一种声明性方法，用于协调各个资源模板和其他项目的部署，例如：

• 角色分配
• 策略任务分配
• Azure 资源管理器模板（ARM 模板）
• 资源组

Azure 蓝图服务由全球分布的 Azure Cosmos DB 提供支持。 蓝图对象将复制到多个 Azure 区域。 无论 Azure 蓝图将资源部署到哪个区域，此复制提供的对蓝图对象的访问都具有低延迟、高可用性和一致性。

与 ARM 模板的不同之处

此服务旨在帮助进行环境设置。 此设置通常包括一组资源组、策略、角色分配和 ARM 模板部署。 蓝图是一个将这些 artifact 类型整合在一起的软件包，并允许你对该软件包进行组合和版本控制，包括通过持续集成和持续交付（CI/CD）管道。 最终，每一项都可通过一次可审计且可跟踪的操作分配到某个订阅中。

几乎所有要包含在 Azure 蓝图中部署的内容都可以使用 ARM 模板完成。 但是，ARM 模板是 Azure 中不原生存在的文档 - 每个模板均存储在本地、源代码管理或模板（预览版）中。 该模板用于部署一个或多个 Azure 资源，但部署了这些资源后，资源与模板之间就不再存在有效的连接或关系。

使用 Azure 蓝图，蓝图定义（应该部署的对象）和蓝图分配（已部署的对象）之间的关系仍然存在 。 此连接支持改进部署的跟踪和审核。 Azure 蓝图也能一次性升级由同一蓝图管理的多个订阅。

无需在 ARM 模板和蓝图之间进行选择。 每个蓝图都可以包含零个或多个 ARM 模板 构件。 此支持意味着可以在 Azure 蓝图中重复使用以前开发和维护 ARM 模板库的工作成果。

与 Azure Policy 的不同之处

蓝图是一个包或容器，用于组合与 Azure 云服务、安全性和设计的实现相关的一组针对目标的标准、模式和要求，这些标准、模式和要求可以重复使用以确保一致性和符合性。

策略是默认允许和显式拒绝系统，侧重于部署期间的资源属性，用于现有资源。 它会验证订阅中的资源是否符合要求和标准，以此为云治理提供支持。

如果在蓝图中包含策略，则可以在分配蓝图期间创建适当的模式或设计。 纳入该策略可确保只能对环境进行已批准或预期内的更改，从而保障持续符合蓝图的设计意图。

策略可以作为蓝图定义中众多项目之一包含在内。 蓝图还支持在策略和计划中使用参数。

蓝图定义

蓝图由工件组成。 Azure 蓝图目前支持将以下资源用作构件：

蓝图定义所在位置

创建蓝图定义时，将定义蓝图的保存位置。 蓝图可以保存到你具有参与者访问权限的管理组或订阅。 如果该位置是管理组，则该蓝图可分配到该管理组下的任何子订阅。

蓝图参数

蓝图可以将参数传递给策略/计划或 ARM 模板。 将 artifact 添加到蓝图时，作者可以决定是为每个蓝图分配提供预先定义的值，还是允许每个蓝图分配在分配时提供值。 这种灵活性提供了这样的选项：为蓝图的所有用途定义一个预先确定的值，或者在分配时再作出该决定。

有关更多信息，请参阅蓝图参数。

蓝图发布

首次创建蓝图时，将视其为处于“草稿”模式。 当它可以被分配时，需要将其发布。 发布需要定义“版本”字符串（字母、数字和连字符，最大长度为 20 个字符）以及可选的“更改注释” 。 版本可将其与同一蓝图后续的更改区分开来，并允许对每个版本进行分配。 这种版本控制也意味着，可将同一蓝图的不同版本分配给同一订阅。 当对蓝图进行其他更改时，已发布版本仍然存在，未发布的更改也仍然存在。 更改完成后，更新后的蓝图将以新的唯一版本发布，现在也可以被分配。

蓝图分配

可将蓝图的每个已发布版本（名称长度上限为 90 个字符）分配给现有的管理组或订阅。 在门户中，该蓝图会将 Version 默认为最近 Published 的版本。 如果存在项目参数或蓝图参数，则在分配过程中定义参数。

Azure 蓝图中的权限

通过Azure基于角色的访问控制（Azure RBAC）管理蓝图权限。

无需专用Azure RBAC 权限即可读取或查看蓝图定义。 蓝图定义旨在由他们管理的主体发现，因此租户中任何经过身份验证的主体都可以列出和读取管理组范围的蓝图定义、其版本及其项目（包括通过 REST API），即使对该管理组没有角色分配也是如此。 读取存储在订阅中的蓝图定义需要对该订阅具有读取访问权限。 创建、发布、分配、更新和删除蓝图始终需要本文中所述的权限。

要创建蓝图，帐户需要以下权限：

• Microsoft.Blueprint/blueprints/write - 创建蓝图定义
• Microsoft.Blueprint/blueprints/artifacts/write - 在蓝图定义上创建项目
• Microsoft.Blueprint/blueprints/versions/write - 发布蓝图

要删除蓝图，帐户需要以下权限：

• Microsoft.Blueprint/blueprints/delete
• Microsoft.Blueprint/blueprints/artifacts/delete
• Microsoft.Blueprint/blueprints/versions/delete

要分配或取消分配蓝图，帐户需要以下权限：

• Microsoft.Blueprint/blueprintAssignments/write - 分配蓝图
• Microsoft.Blueprint/blueprintAssignments/delete - 取消分配蓝图

以下内置角色可用：

若这些内置角色不适合安全需求，请考虑创建自定义角色。

命名限制

某些字段存在以下限制：

Azure 蓝图停用

Azure 蓝图（预览版）将于 2027 年 1 月 31 日停用，从 2026 年 7 月 31 日开始分阶段停用。 请在停用日期之前将蓝图定义和分配迁移到Azure 部署堆栈（推荐）和模板规范。 有关分阶段时间线、影响和迁移指南，请参阅：

• Azure 蓝图停用
• Azure 蓝图停用常见问题解答
• 将Azure 蓝图迁移到模板规格
• 迁移到部署堆栈

后续步骤

• 创建蓝图 - 门户。
• 创建蓝图 - PowerShell。
• 创建蓝图 - REST API。