Övning – Skapa Bicep-mallar

  • 3 minuter

Det är dags att skapa din första Bicep-mall. När du har följt den här lektionen får du lära dig hur Bicep-tillägget i VS Code förenklar utvecklingen genom att tillhandahålla typsäkerhet, syntaxvalidering och automatisk komplettering.

Förutsättningar

Om du vill följa med måste du ha åtkomst till en Azure-prenumeration. Du måste också ha:

  • VS Code.
  • Azure CLI.
  • Bicep-tillägget för VS Code.

Skapa din första mall

Öppna VS Code och skapa en ny fil med namnet main.bicep. När det är klart, öppna filen och skriv "storage". Du bör se en meny och välja det första alternativet res-storage genom att trycka på Retur eller Tabb. Du bör få ett kodstycke som ser ut så här:

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

Den här filen distribuerar ett Azure Storage-konto, men vi måste ändra filen för att göra den redo för distribution. Först ska vi lägga till två parametrar, en för namnet eftersom det ska vara unikt och en för platsen.

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

Det värde som du tilldelar parametrarna är standardvärdet som gör parametrarna valfria. Ersätt namnfältet med storageName och eftersom platsen redan är i bruk kan du gå vidare med distributionen.

Visualisera resurser

Du kan använda VS Code för att visualisera de resurser som definierats i Bicep-filen. Klicka på visualiserarknappen i det övre högra hörnet:

Skärmbild av VS Code-funktionen för att göra en representation av Bicep-resurser.

Kompilera filen

Du behöver inte kompilera filen för att kunna distribuera den, men det är bra att veta hur du kan göra det.

Öppna den integrerade terminalen i VS Code genom att högerklicka på din Bicep-fil och välja menyn Öppna i integrerad terminal.

Använd build-kommandot på följande sätt:

az bicep build -f ./main.bicep

Ta gärna en titt på den resulterande ARM-mallen och jämför de två.

Distribuera Bicep-filen

Nu är det dags att distribuera den Bicep-fil som du har skapat. Kör följande kommandon i samma terminal:

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

Not

Ersätt uniqueName med ett unikt namn, men du kan också ignorera att ange parametern eftersom den har ett standardvärde.

När distributionen är klar får du ett meddelande som anger att distributionen lyckades.

Skärmbild av meddelandet om att distributionen lyckades.

Nästa steg

Nu när du har lärt dig hur du skapar en grundläggande mall och distribuerar den går du vidare till nästa enhet för att lära dig mer om konstruktionerna i en Bicep-fil.