Cvičení – vytvoření šablon Bicep

Dokončeno

Je čas vytvořit první šablonu Bicep. Po provedení této lekce se dozvíte, jak rozšíření Bicep ve VS Code zjednodušuje vývoj tím, že poskytuje bezpečnost typů, ověřování syntaxe a automatické dokončování.

Požadavky

Abyste mohli postupovat podle tohoto návodu, budete muset mít přístup k předplatnému Azure. Potřebujete také:

  • VS Code.
  • Rozhraní příkazového řádku Azure.
  • Rozšíření Bicep pro VS Code

Vytvoření první šablony

Otevřete VS Code a vytvořte nový soubor s názvem main.bicep. Až to bude hotové, otevřete soubor a začněte psát úložiště. Měla by se zobrazit nabídka, ze které vyberte první možnost res-storage stisknutím klávesy Enter nebo Tab. Měli byste skončit fragmentem kódu, který vypadá takto:

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

Tento soubor ale nasadí účet služby Azure Storage, musíme ho upravit, aby byl připravený k nasazení. Nejprve přidáme dva parametry, jeden pro název, protože by měl být jedinečný a druhý pro umístění.

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

Hodnota, kterou přiřadíte k parametrům, je výchozí hodnota, která z parametrů činí volitelné. Vlastnost storageName name nahraďte a vzhledem k tomu, že se umístění už používá, můžete pokračovat nasazením.

Vizualizace prostředků

VS Code můžete použít k vizualizaci prostředků definovaných v souboru Bicep. Klikněte na tlačítko vizualizéru v pravém horním rohu:

Snímek obrazovky s funkcí VS Code, která představuje prostředky Bicep

Kompilace souboru

Abyste ho mohli nasadit, nemusíte soubor kompilovat, ale je dobré vědět, jak to můžete udělat.

V editoru VS Code otevřete integrovaný terminál tak, že kliknete pravým tlačítkem na soubor Bicep a vyberete nabídku Otevřít v integrovaném terminálu .

Příkaz sestavení použijte následujícím způsobem:

az bicep build -f ./main.bicep

Podívejte se na výslednou šablonu ARM a porovnejte je.

Nasazení souboru Bicep

Teď je čas nasadit soubor Bicep, který jste vytvořili. Ve stejném terminálu spusťte následující příkazy:

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

Poznámka:

uniqueName Nahraďte jedinečným názvem, ale můžete také ignorovat zadání parametru, protože má výchozí hodnotu.

Po dokončení nasazení se zobrazí zpráva, že nasazení bylo úspěšné.

Snímek obrazovky s výstupem zprávy o úspěšném nasazení

Další kroky

Teď, když jste se naučili vytvořit základní šablonu a nasadit ji, přejděte k další lekci, kde se dozvíte více o konstruktorech v souboru Bicep.