Quickstart: Een implementatiestack maken en implementeren met Bicep
In deze quickstart wordt beschreven hoe u een implementatiestack maakt.
Vereisten
- Een Azure-account met een actief abonnement. Gratis een account maken
- Azure PowerShell versie 12.0.0 of hoger of Azure CLI versie 2.61.0 of hoger.
- Visual Studio Code met de Bicep-extensie.
Een Bicep-bestand maken
Maak een Bicep-bestand om een opslagaccount en een virtueel netwerk te maken.
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'
}
}
]
}
}
Sla het Bicep-bestand op als main.bicep.
Een implementatiestack maken
In deze quickstart maakt u de implementatiestack op het bereik van de resourcegroep. U kunt ook de implementatiestack maken op het abonnementsbereik of het bereik van de beheergroep. Zie Implementatiestacks maken voor meer informatie.
az group create \
--name 'demoRg' \
--location 'centralus'
az stack group create \
--name demoStack \
--resource-group 'demoRg' \
--template-file './main.bicep' \
--action-on-unmanage 'detachAll' \
--deny-settings-mode 'none'
Zie Implementatiestacks voor meer informatie over action-on-unmanage endeny-setting-mode.
De implementatie controleren
De geïmplementeerde implementatiestacks weergeven op het niveau van de resourcegroep:
az stack group show \
--resource-group 'demoRg' \
--name 'demoStack'
De uitvoer toont twee beheerde resources: één opslagaccount en één virtueel netwerk:
{
"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-24051714epybc",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT32.5330364S",
"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-17T14:50:18.382948+00:00",
"createdBy": "johndoe@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2024-05-17T14:50:18.382948+00:00",
"lastModifiedBy": "johndoe@contoso.com",
"lastModifiedByType": "User"
},
"tags": {},
"template": null,
"templateLink": null,
"type": "Microsoft.Resources/deploymentStacks"
}
U kunt de implementatie ook controleren door de beheerde resources in de implementatiestack weer te verlenen:
az stack group show \
--name 'demoStack' \
--resource-group 'demoRg' \
--output 'json'
De uitvoer is vergelijkbaar met:
{
"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-24051714epybc",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT32.5330364S",
"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-17T14:50:18.382948+00:00",
"createdBy": "johndoe@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2024-05-17T14:50:18.382948+00:00",
"lastModifiedBy": "johndoe@contoso.com",
"lastModifiedByType": "User"
},
"tags": {},
"template": null,
"templateLink": null,
"type": "Microsoft.Resources/deploymentStacks"
}
Zodra een stack is gemaakt, kunt u de stack zelf en de bijbehorende beheerde resources openen en weergeven via Azure Portal. Navigeer naar de resourcegroep waar de stack is geïmplementeerd en u hebt toegang tot alle relevante informatie en instellingen.
De implementatiestack bijwerken
Als u een implementatiestack wilt bijwerken, kunt u het onderliggende Bicep-bestand wijzigen en de opdracht implementatiestack maken opnieuw uitvoeren.
Edit main.bicep to change the sku name to Standard_GRS from Standard_LRS:
Voer de volgende opdracht uit:
az stack group create \
--name 'demoStack' \
--resource-group 'demoRg' \
--template-file './main.bicep' \
--action-on-unmanage 'detachAll' \
--deny-settings-mode 'none'
Controleer in Azure Portal de eigenschappen van het opslagaccount om de wijziging te bevestigen.
Met dezelfde methode kunt u een resource toevoegen aan de implementatiestack of een beheerde resource uit de implementatiestack verwijderen. Zie Resources toevoegen aan een implementatiestack en Beheerde resources verwijderen uit een implementatiestack voor meer informatie.
De implementatiestack verwijderen
De implementatiestack en de beheerde resources verwijderen:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'deleteAll'
De implementatiestack verwijderen, maar de beheerde resources behouden:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'detachAll'
Zie Implementatiestacks verwijderen voor meer informatie.
Met de opdracht Verwijderen worden uitsluitend beheerde resources en beheerde resourcegroepen verwijderd. U bent nog steeds verantwoordelijk voor het verwijderen van de resourcegroepen die niet worden beheerd door de implementatiestack.
Resources opschonen
Verwijder de niet-beheerde resourcegroep.
az group delete \
--name 'demoRg'