Inicio rápido: Crear e implementar una pila de implementación con Bicep
En este inicio rápido se describe cómo crear una pila de implementación.
Prerrequisitos
- Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
- La versión 12.0.0 o posterior de Azure PowerShell o la versión 2.61.0 o posterior de la CLI de Azure.
- Visual Studio Code con la extensión de Bicep.
Creación de un archivo de Bicep
Crear un archivo de Bicep para crear una cuenta de almacenamiento y una red virtual.
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'
}
}
]
}
}
Guarde el archivo de Bicep como main.bicep.
Crear una pila de implementación
En este inicio rápido, creará la pila de implementación en el ámbito del grupo de recursos. También puede crear la pila de implementación en el ámbito de la suscripción o en el ámbito del grupo de administración. Para obtener más información, consulte Crear pilas de implementación.
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'
Para obtener más información sobre action-on-unmanage y deny-setting-mode, consulte Pilas de implementación.
Comprobar la implementación
Para enumerar las pilas de implementación implementadas en el nivel de grupo de recursos:
az stack group show \
--resource-group 'demoRg' \
--name 'demoStack'
La salida muestra dos recursos administrados, que son una cuenta de almacenamiento y una red virtual:
{
"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"
}
También puede comprobar la implementación mediante la enumeración de los recursos administrados en la pila de implementación:
az stack group show \
--name 'demoStack' \
--resource-group 'demoRg' \
--output 'json'
La salida es parecida a esta:
{
"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"
}
Una vez creada una pila, puede acceder y ver tanto la propia pila como los recursos administrados asociados a ella a través de Azure Portal. Vaya al grupo de recursos donde se ha implementado la pila y podrá acceder a toda la información y configuración pertinentes.
Actualización de pila de implementación
Para actualizar una pila de implementación, puede modificar el archivo de Bicep subyacente y volver a ejecutar el comando Crear una pila de implementación.
Edite main.bicep para cambiar el nombre de la SKU a Standard_GRS desde Standard_LRS:
Ejecute el siguiente comando:
az stack group create \
--name 'demoStack' \
--resource-group 'demoRg' \
--template-file './main.bicep' \
--action-on-unmanage 'detachAll' \
--deny-settings-mode 'none'
En Azure Portal, compruebe las propiedades de la cuenta de almacenamiento para confirmar el cambio.
Utilizando el mismo método, puede agregar un recurso a la pila de implementación o quitar un recurso administrado de la pila de implementación. Para obtener más información, consulte Incorporación de recursos a una pila de implementación y Eliminación de recursos administrados de una pila de implementación.
Eliminar la pila de implementación
Para eliminar la pila de implementación y los recursos administrados:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'deleteAll'
Para eliminar la pila de implementación, pero conservar los recursos administrados:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg' \
--action-on-unmanage 'detachAll'
Para obtener más información, consulte Eliminar pilas de implementación.
El comando Quitar quita exclusivamente los recursos administrados y los grupos de recursos administrados. Todavía es responsable de eliminar los grupos de recursos que la pila de implementación no administra.
Limpieza de recursos
Eliminar el grupo de recursos no administrado.
az group delete \
--name 'demoRg'