Share via

Inicio rápido: Crear e implementar una pila de implementación con Bicep

  • Artículo

En este inicio rápido se describe cómo crear una pila de implementación.

Prerrequisitos

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 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' \
  --deny-settings-mode 'none'

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/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"
}

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.

Captura de pantalla de una pila de implementación en Azure Portal.

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' \
  --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' \
  --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. No es válido usar delete-resource-groups por sí solo. delete-resource-groups se debe usar junto con delete-resources.

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'

Pasos siguientes

Pilas de implementación