Verstehen der Bereitstellungsreihenfolge in Azure Blueprint
Wichtig
Am 11. Juli 2026 läuft Blueprints (Vorschau) aus. Migrieren Sie Ihre vorhandenen Blaupausendefinitionen und -zuweisungen zu Vorlagenspezifikationen und Bereitstellungsstapeln. Blaupausenartefakte müssen in ARM-JSON-Vorlagen oder Bicep-Dateien konvertiert werden, die zum Definieren von Bereitstellungsstapeln verwendet werden. Informationen zum Erstellen eines Artefakts als ARM-Ressource finden Sie unter:
Azure Blueprints bestimmt mit einer Reihenfolge, die Abfolge der Ressourcenerstellung beim Verarbeiten der Zuweisung einer Blaupausendefinition. In diesem Artikel werden die folgenden Konzepte erläutert:
- Verwendete Standardreihenfolge
- Vorgehensweise zum Anpassen der Reihenfolge
- Verarbeitung der angepassten Reihenfolge
In den JSON-Beispielen gibt es Variablen, die Sie durch Ihre eigenen Werte ersetzen müssen:
- Ersetzen Sie
{YourMG}
durch den Namen Ihrer Verwaltungsgruppe.
Standardreihenfolge
Wenn die Blaupausendefinition keine Anweisung zum Bereitstellen von Artefakten enthält oder gleich NULL ist, wird die folgende Reihenfolge verwendet:
- Rollenzuweisungsartefakte auf Abonnementebene werden nach Artefaktnamen sortiert
- Richtlinienzuweisungsartefakte auf Abonnementebene werden nach Artefaktnamen sortiert
- Artefakte von Azure Resource Manager-Vorlagen (ARM-Vorlagen) auf Abonnementebene werden nach Artefaktnamen sortiert
- Ressourcengruppenartefakte (und untergeordnete Artefakte) werden nach Platzhalternamen sortiert
In jedem Artefakt vom Typ Ressourcengruppe wird für Artefakte, die innerhalb dieser Ressourcengruppe erstellt werden, die folgende Reihenfolge verwendet:
- Einer Ressourcengruppe untergeordnete Rollenzuweisungsartefakte werden nach Artefaktnamen sortiert
- Einer Ressourcengruppe untergeordnete Richtlinienzuweisungsartefakte werden nach Artefaktnamen sortiert
- Einer Ressourcengruppe untergeordnete Artefakte von Azure Resource Manager-Vorlagen (ARM-Vorlagen) werden nach Artefaktnamen sortiert
Hinweis
Die Verwendung von artifacts() erzeugt eine implizite Abhängigkeit von dem betreffenden Artefakt.
Anpassen der Reihenfolge
Beim Erstellen großer Blaupausendefinitionen müssen Ressourcen ggf. in einer bestimmten Reihenfolge erstellt werden. Im gängigsten Anwendungsmuster dieses Szenarios enthält eine Blaupausendefinition mehrere ARM-Vorlagen. Für diesen Fall ermöglicht Azure Blueprints das Definieren der Reihenfolge.
Zum Angeben der Reihenfolge wird im JSON-Code eine Eigenschaft vom Typ dependsOn
definiert. Die Blaupausendefinition für Ressourcengruppen und Artefaktobjekte unterstützen diese Eigenschaft.
dependsOn
ist ein Zeichenfolgenarray von Artefaktnamen, das das jeweilige Artefakt im Vorfeld für seine Erstellung benötigt.
Hinweis
Beim Erstellen von Blaupausenobjekten erhält jede Artefaktressource ihren Namen vom Dateinamen (bei Verwendung von PowerShell) oder dem URL-Endpunkt (bei Verwendung der REST-API). resourceGroup-Verweise in Artefakten müssen mit denen in der Blaupausendefinition übereinstimmen.
Beispiel: Sortierte Ressourcengruppe
Diese exemplarische Blaupausendefinition verfügt über eine Ressourcengruppe mit benutzerdefinierter Reihenfolge (mittels Deklarierung eines Werts für dependsOn
) sowie über eine Standardressourcengruppe. In diesem Fall wird das Artefakt namens assignPolicyTags vor der Ressourcengruppe ordered-rg verarbeitet.
standard-rg wird gemäß der Standardreihenfolge verarbeitet.
{
"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"
}
Beispiel: Artefakt mit benutzerdefinierter Reihenfolge
Bei diesem Beispiel handelt es sich um ein Richtlinienartefakt, das von einer ARM-Vorlage abhängt. In der Standardreihenfolge wird ein Richtlinienartefakt vor der ARM-Vorlage erstellt. Bei Verwendung dieser Reihenfolge kann das Richtlinienartefakt warten, bis die ARM-Vorlage erstellt wurde.
{
"properties": {
"displayName": "Assigns an identifying tag",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/2a0e14a6-b0a6-4fab-991a-187a4f81c498",
"resourceGroup": "standard-rg",
"dependsOn": [
"customTemplate"
]
},
"kind": "policyAssignment",
"type": "Microsoft.Blueprint/artifacts"
}
Beispiel: Von einer Ressourcengruppe abhängiges Vorlagenartefakt auf Abonnementebene
In diesem Beispiel wird eine Abhängigkeit einer auf Abonnementebene bereitgestellten ARM-Vorlage von einer Ressourcengruppe erstellt. Bei der Standardreihenfolge werden die Artefakte auf Abonnementebene vor allen Ressourcengruppen und untergeordneten Artefakten in diesen Ressourcengruppen erstellt. Die Ressourcengruppe wird in der Blaupausendefinition wie folgt definiert:
"resourceGroups": {
"wait-for-me": {
"metadata": {
"description": "Resource Group that is deployed prior to the subscription level template artifact"
}
}
}
Das Vorlagenartefakt auf Abonnementebene, das von der Ressourcengruppe wait-for-me abhängig ist, wird wie folgt definiert:
{
"properties": {
"template": {
...
},
"parameters": {
...
},
"dependsOn": ["wait-for-me"],
"displayName": "SubLevelTemplate",
"description": ""
},
"kind": "template",
"type": "Microsoft.Blueprint/blueprints/artifacts"
}
Verarbeiten der benutzerdefinierten Reihenfolge
Beim Erstellen wird eine topologische Sortierung verwendet, um das Abhängigkeitsdiagramm der Blaupausenartefakte zu erstellen. Die Überprüfung stellt sicher, dass alle Abhängigkeitsebenen zwischen Ressourcengruppen und Artefakten unterstützt werden.
Wird eine Artefaktabhängigkeit deklariert, die keine Änderung der Standardreihenfolge zur Folge hat, wird keine Änderung vorgenommen.
Ein Beispiel wäre etwa eine Ressourcengruppe, die von einer Richtlinie auf Abonnementebene abhängt. Ein weiteres Beispiel wäre eine untergeordnete Richtlinienzuweisung der Ressourcengruppe „standard-rg“, die von der untergeordneten Rollenzuweisung der Ressourcengruppe „standard-rg“ abhängt. In beiden Fällen würde dependsOn
die Standardreihenfolge nicht ändern, sodass keine Änderungen anfallen würden.
Nächste Schritte
- Erfahren Sie mehr über den Lebenszyklus von Blaupausen.
- Machen Sie sich mit der Verwendung statischer und dynamischer Parameter vertraut.
- Erfahren Sie, wie Sie Ressourcen in Blaupausen sperren können.
- Lernen Sie, wie Sie vorhandene Zuweisungen aktualisieren.
- Beheben Sie Probleme bei der Blaupausenzuweisung mithilfe des allgemeinen Leitfadens zur Problembehandlung.