Ćwiczenie — tworzenie szablonów Bicep

  • 3 min

Nadszedł czas, aby utworzyć pierwszy szablon Bicep. Po wykonaniu tej lekcji dowiesz się, jak rozszerzenie Bicep w programie VS Code upraszcza programowanie, zapewniając bezpieczeństwo typów, walidację składni i autouzupełnianie.

Wymagania wstępne

Aby to zrobić, musisz mieć dostęp do subskrypcji platformy Azure. Musisz również mieć następujące elementy:

  • Kod programu VS.
  • Interfejs wiersza polecenia platformy Azure.
  • Rozszerzenie Bicep dla programu VS Code.

Tworzenie pierwszego szablonu

Otwórz program VS Code i utwórz nowy plik o nazwie main.bicep. Po zakończeniu otwórz plik i rozpocznij wpisywanie w magazynie. Powinno zostać wyświetlone menu, z którego wybierz pierwszą opcję res-storage , naciskając klawisz Enter lub Tab. Powinien pojawić się fragment kodu, który wygląda następująco:

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

Ten plik wdroży jednak konto usługi Azure Storage, musimy zmodyfikować plik, aby był gotowy do wdrożenia. Najpierw dodajmy dwa parametry, jedną dla nazwy, ponieważ powinna być unikatowa, a druga dla lokalizacji.

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

Wartość przypisana do parametrów jest wartością domyślną, która sprawia, że parametry są opcjonalne. Zastąp właściwość name wartością storageName i ponieważ lokalizacja jest już używana, dobrze jest przejść do wdrożenia.

Wizualizowanie zasobów

Za pomocą programu VS Code można wizualizować zasoby zdefiniowane w pliku Bicep. Kliknij przycisk wizualizatora w prawym górnym rogu:

Zrzut ekranu przedstawiający funkcję programu VS Code umożliwiającą przedstawienie zasobów Bicep.

Kompilowanie pliku

Nie musisz kompilować pliku, aby móc go wdrożyć, ale dobrze jest wiedzieć, jak to zrobić.

Otwórz zintegrowany terminal w programie VS Code, klikając prawym przyciskiem myszy plik Bicep i wybierając menu Otwórz w zintegrowanym terminalu.

Użyj polecenia kompilacji w następujący sposób:

az bicep build -f ./main.bicep

Możesz przyjrzeć się wynikowemu szablonowi usługi ARM i porównać te dwa.

Wdrażanie pliku Bicep

Teraz nadszedł czas na wdrożenie utworzonego pliku Bicep. W tym samym terminalu uruchom następujące polecenia:

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

Uwaga

Zastąp element uniqueName unikatową nazwą, ale możesz również zignorować podanie parametru, ponieważ ma wartość domyślną.

Po zakończeniu wdrażania zostanie wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Zrzut ekranu przedstawiający dane wyjściowe komunikatu o powodzeniu wdrożenia.

Następne kroki

Teraz, gdy wiesz już, jak utworzyć podstawowy szablon i wdrożyć go, przejdź do następnej lekcji, aby dowiedzieć się więcej o konstrukcjach w pliku Bicep.