Ejercicio: Creación de plantillas de Bicep

  • 3 minutos

Es hora de crear la primera plantilla de Bicep. Después de seguir esta unidad, aprenderá cómo la extensión de Bicep en VS Code simplifica el desarrollo al brindar seguridad de tipos, validación de sintaxis y la función de autocompletar.

Prerrequisitos

Para continuar, deberá tener acceso a una suscripción de Azure. También debe tener instalado:

  • VS Code.
  • CLI de Azure.
  • Extensión de Bicep para VS Code.

Creación de la primera plantilla

Abra VS Code y cree un archivo denominado main.bicep. Cuando termine, abra el archivo y empiece a escribir "almacenamiento". Debería aparecer un menú en el que debe seleccionar la primera opción res-storage presionando Entrar o la tecla Tab. Debe terminar con un fragmento similar a este:

resource storageaccount 'Microsoft.Storage/storageAccounts@2021-02-01' = {
    name: 'name'
    location: location
    kind: 'StorageV2'
    sku: {
        name: 'Premium_LRS'
    }
}

Este archivo implementará una cuenta de Azure Storage; sin embargo, es necesario modificar el archivo para que esté listo para la implementación. En primer lugar, agreguemos dos parámetros, uno para el nombre (ya que debe ser único) y otro para la ubicación.

param storageName string = 'stg${uniqueString(resourceGroup().id)}'
param location string = resourceGroup().location

El valor que asigna a los parámetros es el valor predeterminado que hace que los parámetros sean opcionales. Reemplace la propiedad name por storageName y, como ya se usa la ubicación, puede seguir con la implementación.

Visualización de recursos

Puede usar VS Code para visualizar los recursos definidos en el archivo de Bicep. Haga clic en el botón del visualizador que se encuentra en la esquina superior derecha:

Captura de pantalla de la característica de VS Code para realizar una representación de los recursos de Bicep.

Compilación del archivo

No es necesario compilar el archivo para poder implementarlo, pero es útil saber hacerlo.

Haga clic con el botón derecho en el archivo de Bicep y seleccione el menú Abrir en terminal integrado para abrir el terminal integrado en VS Code.

Use el comando build como se indica a continuación:

az bicep build -f ./main.bicep

No dude en echar un vistazo a la plantilla de ARM resultante y comparar las dos.

Implementación del archivo de Bicep

Ahora es momento de implementar el archivo de Bicep que creó. En el mismo terminal, ejecute estos comandos:

az group create --name Bicep --location eastus
az deployment group create --resource-group Bicep --template-file main.bicep --parameters storageName=uniqueName

Nota:

Reemplace uniqueName por un nombre único, aunque también puede omitir el parámetro porque ya tiene un valor predeterminado.

Una vez que finalice la implementación, recibirá un mensaje que indicará que la implementación se realizó correctamente.

Captura de pantalla de la salida del mensaje correcta de la implementación.

Pasos siguientes

Ahora que aprendió a crear una plantilla básica e implementarla, vaya a la unidad siguiente para obtener más información sobre las construcciones de un archivo de Bicep.