Inicio rápido: Creación e implementación de una pila de implementación con Bicep desde especificaciones de plantilla (versión preliminar)
En este inicio rápido se describe cómo crear una pila de implementación a partir de una especificación de plantilla.
Prerrequisitos
- Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
- La versión 10.1.0 o posterior de Azure PowerShell o la versión 2.50.0 o posterior de la CLI de AWS.
- 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@2022-09-01' = {
name: storageAccountName
location: resourceGroupLocation
kind: 'StorageV2'
sku: {
name: 'Standard_LRS'
}
}
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-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 especificación de plantilla
Cree una especificación de plantilla con el siguiente comando.
az group create \
--name 'templateSpecRG' \
--location 'centralus'
az ts create \
--name 'stackSpec' \
--version '1.0' \
--resource-group 'templateSpecRG' \
--location 'centralus' \
--template-file 'main.bicep'
El formato del identificador de especificación de plantilla es /subscriptions/<subscription-id>/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0
.
Creación de una pila de implementación
Creación de una pila de implementación a partir de la especificación de plantilla.
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 \
--deny-settings-mode 'none'
Comprobar la implementación
Para enumerar las pilas de implementación implementadas en el nivel de suscripción:
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/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Resources/deployments/demoStack-2023-06-08-14-58-28-fd6bb",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT30.1685405S",
"error": null,
"failedResources": [],
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/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/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
"resourceGroup": "demoRg",
"status": "managed"
}
],
"systemData": {
"createdAt": "2023-06-08T14:58:28.377564+00:00",
"createdBy": "johndole@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-06-08T14:58:28.377564+00:00",
"lastModifiedBy": "johndole@contoso.com",
"lastModifiedByType": "User"
},
"tags": null,
"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/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-2023-06-05-20-55-48-38d09",
"deploymentScope": null,
"description": null,
"detachedResources": [],
"duration": "PT29.006353S",
"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/vnetzu6pnx54hqubm",
"resourceGroup": "demoRg",
"status": "managed"
},
{
"denyStatus": "none",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storezu6pnx54hqubm",
"resourceGroup": "demoRg",
"status": "managed"
}
],
"systemData": {
"createdAt": "2023-06-05T20:55:48.006789+00:00",
"createdBy": "johndole@contoso.com",
"createdByType": "User",
"lastModifiedAt": "2023-06-05T20:55:48.006789+00:00",
"lastModifiedBy": "johndole@contoso.com",
"lastModifiedByType": "User"
},
"tags": null,
"template": null,
"templateLink": null,
"type": "Microsoft.Resources/deploymentStacks"
}
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' \
--delete-all
Si ejecuta los comandos Eliminar sin los parámetros delete all, los recursos administrados se desasocian, pero no se eliminan. Por ejemplo:
az stack group delete \
--name 'demoStack' \
--resource-group 'demoRg'
Los parámetros siguientes se pueden usar para controlar la desasociación y el eliminado.
--delete-all
: Elimina recursos y grupos de recursos.--delete-resources
: Elimina solo los recursos.--delete-resource-groups
: Elimina solo los grupos de recursos.
Para obtener más información, consulte Eliminar pilas de implementación.
Limpieza de recursos
El comando Quitar quita solo los recursos administrados y los grupos de recursos administrados. Todavía tiene que eliminar el grupo de recursos.
az group delete --name 'demoRg'