Démarrage rapide : Créer et déployer une pile de déploiement avec Bicep
Ce guide de démarrage rapide explique comment créer une pile de déploiement.
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 pile de déploiement
Dans ce guide de démarrage rapide, vous créez la pile de déploiement dans l’étendue du groupe de ressources. Vous pouvez également créer la pile de déploiement au niveau de l’étendue de l’abonnement ou du groupe d’administration. Pour plus d’informations, consultez la section Créer des piles de déploiement.
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'
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 du groupe de ressources :
az stack group show \
--resource-group 'demoRg' \
--name 'demoStack'
La sortie montre deux ressources managées, à savoir 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/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"
}
Vous pouvez également vérifier le déploiement en répertoriant 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/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"
}
Une fois qu’une pile est créée, vous pouvez accéder à la pile elle-même et aux ressources managées associées et les afficher par le biais du portail Azure. Accédez au groupe de ressources où la pile a été déployée pour pouvoir accéder à l’ensemble des informations et paramètres appropriés.
Mettre à jour la pile de déploiement
Pour mettre à jour une pile de déploiement, vous pouvez modifier le fichier Bicep sous-jacent et réexécuter la commande de création d’une pile de déploiement.
Modifiez le fichier main.bicep pour remplacer le nom de la référence SKU Standard_LRS par Standard_GRS :
Exécutez la commande suivante :
az stack group create \
--name 'demoStack' \
--resource-group 'demoRg' \
--template-file './main.bicep' \
--action-on-unmanage 'detachAll' \
--deny-settings-mode 'none'
À partir du portail Azure, vérifiez les propriétés du compte de stockage pour confirmer la modification.
À l’aide de la même méthode, vous pouvez ajouter une ressource à la pile de déploiement ou supprimer une ressource managée de la pile de déploiement. Pour plus d’informations, consultez les sections Ajouter des ressources à une pile de déploiement et Supprimer des ressources managées d’une pile de déploiement.
Supprimer 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 tout en conservant les ressources managées :
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'detachAll'
Pour plus d’informations, voir Supprimer les piles de déploiement.
La commande de suppression supprime exclusivement les ressources managées et les groupes de ressources managées. Vous restez responsable de la suppression des groupes de ressources qui ne sont pas managés par la pile de déploiement.
Nettoyer les ressources
Supprimez le groupe de ressources non managées.
az group delete \
--name 'demoRg'