Schnellstart: Erstellen und Bereitstellen eines Bereitstellungsstapels mit Bicep aus Vorlagenspezifikationen
In diesem Schnellstart wird beschrieben, wie Sie einen Bereitstellungsstapel aus einer Vorlagenspezifikation erstellen.
Voraussetzungen
- Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
- Azure PowerShell Version 12.0.0 oder höher oder Azure CLI Version 2.61.0 oder höher.
- Visual Studio Code mit der Bicep-Erweiterung.
Erstellen einer Bicep-Datei
Erstellen Sie eine Bicep-Datei, um ein Speicherkonto und ein virtuelles Netzwerk zu erstellen.
param resourceGroupLocation string = resourceGroup().location
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
param vnetName string = 'vnet${uniqueString(resourceGroup().id)}'
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' = {
name: storageAccountName
location: resourceGroupLocation
kind: 'StorageV2'
sku: {
name: 'Standard_LRS'
}
}
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2023-11-01' = {
name: vnetName
location: resourceGroupLocation
properties: {
addressSpace: {
addressPrefixes: [
'10.0.0.0/16'
]
}
subnets: [
{
name: 'Subnet-1'
properties: {
addressPrefix: '10.0.0.0/24'
}
}
{
name: 'Subnet-2'
properties: {
addressPrefix: '10.0.1.0/24'
}
}
]
}
}
Speichern Sie die Bicep-Datei als main.bicep.
Erstellen von Vorlagenspezifikationen
Erstellen Sie eine Vorlagenspezifikation mit dem folgenden Befehl.
az group create \
--name 'templateSpecRG' \
--location 'centralus'
az ts create \
--name 'stackSpec' \
--version '1.0' \
--resource-group 'templateSpecRG' \
--location 'centralus' \
--template-file 'main.bicep'
Das Format der Vorlagenspezifikations-ID ist /subscriptions/<subscription-id>/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0
.
Erstellen eines Bereitstellungsstapels
Erstellen Sie einen Bereitstellungsstapel aus der Vorlagenspezifikation.
az group create \
--name 'demoRg' \
--location 'centralus'
id=$(az ts show --name 'stackSpec' --resource-group 'templateSpecRG' --version '1.0' --query 'id')
az stack group create \
--name demoStack \
--resource-group 'demoRg' \
--template-spec $id \
--action-on-unmanage 'detachAll' \
--deny-settings-mode 'none'
Weitere Informationen zu action-on-unmanage
und deny-setting-mode
finden Sie unter Bereitstellungsstapel.
Überprüfen der Bereitstellung
So listen Sie die bereitgestellten Bereitstellungsstapel auf Abonnementebene auf
az stack group show \
--resource-group 'demoRg' \
--name 'demoStack'
Die Ausgabe zeigt zwei verwaltete Ressourcen – ein Speicherkonto und ein virtuelles Netzwerk:
{
"actionOnUnmanage": {
"managementGroups": "detach",
"resourceGroups": "detach",
"resources": "detach"
},
"debugSetting": null,
"deletedResources": [],
"denySettings": {
"applyToChildScopes": false,
"excludedActions": null,
"excludedPrincipals": null,
"mode": "none"
},
"deploymentId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT30.5642429S",
"error": null,
"failedResources": [],
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack",
"location": null,
"name": "demoStack",
"outputs": null,
"parameters": {},
"parametersLink": null,
"provisioningState": "succeeded",
"resourceGroup": "demoRg",
"resources": [
{
"denyStatus": "none",
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
}
],
"systemData": {
"createdAt": "2024-05-17T16:07:51.172012+00:00",
"createdBy": "johndoe@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2024-05-17T16:07:51.172012+00:00",
"lastModifiedBy": "johndoe@contoso.com",
"lastModifiedByType": "User"
},
"tags": {},
"template": null,
"templateLink": {
"contentVersion": null,
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
"queryString": null,
"relativePath": null,
"resourceGroup": "templateSpecRG",
"uri": null
},
"type": "Microsoft.Resources/deploymentStacks"
}
Sie können die Bereitstellung auch überprüfen, indem Sie die verwalteten Ressourcen im Bereitstellungsstapel auflisten:
az stack group show \
--name 'demoStack' \
--resource-group 'demoRg' \
--output 'json'
Die Ausgabe sieht in etwa wie folgt aus:
{
"actionOnUnmanage": {
"managementGroups": "detach",
"resourceGroups": "detach",
"resources": "detach"
},
"debugSetting": null,
"deletedResources": [],
"denySettings": {
"applyToChildScopes": false,
"excludedActions": null,
"excludedPrincipals": null,
"mode": "none"
},
"deploymentId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT30.5642429S",
"error": null,
"failedResources": [],
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack",
"location": null,
"name": "demoStack",
"outputs": null,
"parameters": {},
"parametersLink": null,
"provisioningState": "succeeded",
"resourceGroup": "demoRg",
"resources": [
{
"denyStatus": "none",
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
}
],
"systemData": {
"createdAt": "2024-05-17T16:07:51.172012+00:00",
"createdBy": "johndoe@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2024-05-17T16:07:51.172012+00:00",
"lastModifiedBy": "johndoe@contoso.com",
"lastModifiedByType": "User"
},
"tags": {},
"template": null,
"templateLink": {
"contentVersion": null,
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
"queryString": null,
"relativePath": null,
"resourceGroup": "templateSpecRG",
"uri": null
},
"type": "Microsoft.Resources/deploymentStacks"
}
Löschen des Bereitstellungsstapels
So löschen Sie den Bereitstellungsstapel und die verwalteten Ressourcen
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'deleteAll'
So löschen Sie den Bereitstellungsstapel, trennen aber die verwalteten Ressourcen. Zum Beispiel:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'detachAll'
Weitere Informationen finden Sie unter Löschen von Bereitstellungsstapeln.
Bereinigen von Ressourcen
Mit dem remove-Befehl werden nur die verwalteten Ressourcen und verwalteten Ressourcengruppen entfernt. Sie müssen die Ressourcengruppe weiterhin löschen.
az group delete \
--name 'demoRg'
So löschen Sie die Vorlagenspezifikation und die Ressourcengruppe:
az group delete \
--name 'templateSpecRG'