Understand the deployment sequence in Azure Blueprints
Článok
Dôležité
On July 11, 2026, Blueprints (Preview) will be deprecated. Migrate your existing blueprint definitions and assignments to Template Specs and Deployment Stacks. Blueprint artifacts are to be converted to ARM JSON templates or Bicep files used to define deployment stacks. To learn how to author an artifact as an ARM resource, see:
Azure Blueprints uses a sequencing order to determine the order of resource creation when
processing the assignment of a blueprint definition. This article explains the following concepts:
The default sequencing order that is used
How to customize the order
How the customized order is processed
There are variables in the JSON examples that you need to replace with your own values:
{YourMG} - Replace with the name of your management group
Default sequencing order
If the blueprint definition contains no directive for the order to deploy artifacts or the directive
is null, then the following order is used:
Subscription level role assignment artifacts sorted by artifact name
Subscription level policy assignment artifacts sorted by artifact name
Subscription level Azure Resource Manager template (ARM templates) artifacts sorted by
artifact name
Resource group artifacts (including child artifacts) sorted by placeholder name
Within each resource group artifact, the following sequence order is used for artifacts to be
created within that resource group:
Resource group child role assignment artifacts sorted by artifact name
Resource group child policy assignment artifacts sorted by artifact name
Resource group child Azure Resource Manager template (ARM templates) artifacts sorted by
artifact name
Poznámka
Use of artifacts() creates an implicit dependency
on the artifact being referred to.
Customizing the sequencing order
When composing large blueprint definitions, it may be necessary for resources to be created in a
specific order. The most common use pattern of this scenario is when a blueprint definition includes
several ARM templates. Azure Blueprints handles this pattern by allowing the sequencing order to be
defined.
The ordering is accomplished by defining a dependsOn property in the JSON. The blueprint
definition, for resource groups, and artifact objects support this property. dependsOn is a string
array of artifact names that the particular artifact needs to be created before it's created.
Poznámka
When creating blueprint objects, each artifact resource gets its name from the filename, if using
PowerShell, or the URL endpoint, if
using REST API. resourceGroup references in
artifacts must match those defined in the blueprint definition.
Example - ordered resource group
This example blueprint definition has a resource group that has defined a custom sequencing order by
declaring a value for dependsOn, along with a standard resource group. In this case, the artifact
named assignPolicyTags will be processed before the ordered-rg resource group.
standard-rg will be processed per the default sequencing order.
JSON
{
"properties": {
"description": "Example blueprint with custom sequencing order",
"resourceGroups": {
"ordered-rg": {
"dependsOn": [
"assignPolicyTags"
],
"metadata": {
"description": "Resource Group that waits for 'assignPolicyTags' creation"
}
},
"standard-rg": {
"metadata": {
"description": "Resource Group that follows the standard sequence ordering"
}
}
},
"targetScope": "subscription"
},
"type": "Microsoft.Blueprint/blueprints"
}
Example - artifact with custom order
This example is a policy artifact that depends on an ARM template. By default ordering, a policy
artifact would be created before the ARM template. This ordering allows the policy artifact to wait
for the ARM template to be created.
Example - subscription level template artifact depending on a resource group
This example is for an ARM template deployed at the subscription level to depend on a resource
group. In default ordering, the subscription level artifacts would be created before any resource
groups and child artifacts in those resource groups. The resource group is defined in the blueprint
definition like this:
JSON
"resourceGroups": {
"wait-for-me": {
"metadata": {
"description": "Resource Group that is deployed prior to the subscription level template artifact"
}
}
}
The subscription level template artifact depending on the wait-for-me resource group is defined
like this:
During the creation process, a topological sort is used to create the dependency graph of the
blueprints artifacts. The check makes sure each level of dependency between resource groups and
artifacts is supported.
If an artifact dependency is declared that wouldn't alter the default order, then no change is made.
An example is a resource group that depends on a subscription level policy. Another example is a
resource group 'standard-rg' child policy assignment that depends on resource group 'standard-rg'
child role assignment. In both cases, the dependsOn wouldn't have altered the default sequencing
order and no changes would be made.
As a Microsoft Azure solutions architect, you advise stakeholders and translate business requirements into designs for Azure solutions that align with the Azure Well-Architected Framework and Cloud Adoption Framework for Azure.