Démarrage rapide : créer et déployer une pile de déploiement avec Bicep à partir des specs de modèle
Ce guide de démarrage rapide explique comment créer une pile de déploiement à partir d’une spécification de modèle.
Prérequis
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Azure PowerShell version 12.0.0 ou ultérieure ou Azure CLI version 2.61.0 ou ultérieure.
- Visual Studio Code avec l’extension Bicep.
Créer un fichier Bicep
Créez un fichier Bicep pour créer un compte de stockage et un réseau virtuel.
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'
}
}
]
}
}
Enregistrez le fichier Bicep sous main.bicep.
Créer une spec de modèle
Créez une spécification de modèle avec la commande suivante.
az group create \
--name 'templateSpecRG' \
--location 'centralus'
az ts create \
--name 'stackSpec' \
--version '1.0' \
--resource-group 'templateSpecRG' \
--location 'centralus' \
--template-file 'main.bicep'
Le format de l’ID de spécification du modèle est /subscriptions/<subscription-id>/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0.
Créer une pile de déploiement
Créez une pile de déploiement à partir de la spécification de modèle.
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'
Pour plus d’informations sur action-on-unmanage et sur deny-setting-mode, consultez Piles de déploiement.
Vérifier le déploiement
Pour répertorier les piles de déploiement déployées au niveau de l’abonnement :
az stack group show \
--resource-group 'demoRg' \
--name 'demoStack'
La sortie montre deux ressources managées : un compte de stockage et un réseau virtuel :
{
"actionOnUnmanage": {
"managementGroups": "detach",
"resourceGroups": "detach",
"resources": "detach"
},
"debugSetting": null,
"deletedResources": [],
"denySettings": {
"applyToChildScopes": false,
"excludedActions": null,
"excludedPrincipals": null,
"mode": "none"
},
"deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT30.5642429S",
"error": null,
"failedResources": [],
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
"queryString": null,
"relativePath": null,
"resourceGroup": "templateSpecRG",
"uri": null
},
"type": "Microsoft.Resources/deploymentStacks"
}
Vous pouvez également vérifier le déploiement en listant les ressources managées dans la pile de déploiement :
az stack group show \
--name 'demoStack' \
--resource-group 'demoRg' \
--output 'json'
Le résultat ressemble à ce qui suit :
{
"actionOnUnmanage": {
"managementGroups": "detach",
"resourceGroups": "detach",
"resources": "detach"
},
"debugSetting": null,
"deletedResources": [],
"denySettings": {
"applyToChildScopes": false,
"excludedActions": null,
"excludedPrincipals": null,
"mode": "none"
},
"deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT30.5642429S",
"error": null,
"failedResources": [],
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
"queryString": null,
"relativePath": null,
"resourceGroup": "templateSpecRG",
"uri": null
},
"type": "Microsoft.Resources/deploymentStacks"
}
Suppression la pile de déploiement
Pour supprimer la pile de déploiement et les ressources managées :
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'deleteAll'
Pour supprimer la pile de déploiement, mais détachez les ressources managées. Par exemple :
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'detachAll'
Pour plus d’informations, voir Supprimer les piles de déploiement.
Nettoyer les ressources
La commande de suppression supprime uniquement les ressources managées et les groupes de ressources managés. Vous devez toujours supprimer le groupe de ressources.
az group delete \
--name 'demoRg'
Pour supprimer les spécifications du modèle et le groupe de ressources :
az group delete \
--name 'templateSpecRG'
Étapes suivantes
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour