Szybki start: tworzenie plików Bicep za pomocą programu Visual Studio Code
Ten przewodnik Szybki start przeprowadzi Cię przez proces tworzenia pliku Bicep przy użyciu programu Visual Studio Code. Utworzysz konto magazynu i sieć wirtualną. Dowiesz się również, jak rozszerzenie Bicep zapewnia bezpieczeństwo typów, walidację składni i autouzupełnianie w celu uproszczenia programowania.
Program Visual Studio obsługuje podobne środowisko tworzenia. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie plików Bicep za pomocą programu Visual Studio .
Wymagania wstępne
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto .
Aby skonfigurować środowisko na potrzeby programowania aplikacji Bicep, zobacz Instalowanie narzędzi Bicep. Po wykonaniu tych kroków masz zainstalowany program Visual Studio Code i rozszerzenie Bicep. Masz również najnowszą wersję interfejsu wiersza polecenia platformy Azure lub moduł azure PowerShell.
Dodawanie fragmentu kodu zasobu
Program Visual Studio Code z rozszerzeniem Bicep udostępnia wstępnie zdefiniowane fragmenty kodu w celu uproszczenia programowania. W tym przewodniku Szybki start dodasz fragment kodu, który tworzy sieć wirtualną.
Uruchom program Visual Studio Code i utwórz nowy plik o nazwie main.bicep. W pliku main.bicep wpisz vnet, wybierz pozycję res-vnet z listy, a następnie naciśnij TAB lub ENTER.
Napiwek
Jeśli nie widzisz tych opcji funkcji IntelliSense w programie Visual Studio Code, upewnij się, że zainstalowano rozszerzenie Bicep zgodnie z wymaganiami wstępnymi. Jeśli rozszerzenie zostało zainstalowane, daj usłudze językowej Bicep trochę czasu na uruchomienie po otwarciu pliku Bicep. Zwykle zaczyna się szybko i nie będziesz mieć opcji IntelliSense do momentu jego uruchomienia. Powiadomienie w prawym dolnym rogu wskazuje, że usługa jest uruchamiana. Gdy to powiadomienie zniknie, usługa jest uruchomiona.
Plik Bicep zawiera teraz następujący kod:
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2019-11-01' = {
name: 'name'
location: location
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'
}
}
]
}
}
W tym fragmencie kodu znajdziesz wszystkie niezbędne wartości do zdefiniowania sieci wirtualnej. Możesz zauważyć dwa podkreślenia curly. Żółty oznacza ostrzeżenie związane z nieaktualną wersją interfejsu API, a czerwone podkreślenie oznacza błąd spowodowany brakującą definicją parametru. Linter Bicep sprawdza pliki Bicep pod kątem błędów składni i naruszeń najlepszych rozwiązań. Umieść kursor na @2019-11-01
okienku podręcznym z wyświetlonym okienkiem Użyj nowszej wersji interfejsu API dla elementu "Microsoft.Network/virtualNetworks". Wybierz pozycję Szybka poprawka w okienku podręcznym, a następnie wybierz pozycję Zamień na 2024-05-01 , aby zaktualizować wersję interfejsu API.
Alternatywnie usuń @2019-11-01
element i zastąp go ciągiem @
. Wybierz najnowszą wersję interfejsu API.
Naprawisz błąd brakującej definicji parametru w następnej sekcji.
Możesz również zmodyfikować ten kod, aby spełnić wymagania. Na przykład ponieważ name
nie jest wyraźną nazwą sieci wirtualnej, możesz zmienić name
właściwość na exampleVnet
:
name: 'exampleVNet'
Dodawanie parametru
Fragment kodu dodany w ostatniej sekcji pomija definicję parametru , location
zgodnie z czerwoną podkreśleniami. W górnej części pliku dodaj:
param location
Po dodaniu miejsca po lokalizacji zwróć uwagę, że funkcja IntelliSense oferuje typy danych, które są dostępne dla parametru. Wybierz ciąg.
Nadaj parametrowi wartość domyślną:
param location string = resourceGroup().location
Poprzedni wiersz przypisuje lokalizację grupy zasobów do zasobu sieci wirtualnej. Aby uzyskać więcej informacji na temat funkcji używanej w wartości domyślnej, zobacz resourceGroup()
.
W górnej części pliku dodaj kolejny parametr nazwy konta magazynu (który zostanie utworzony w dalszej części przewodnika Szybki start) z wartością domyślną:
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
Aby uzyskać więcej informacji, zobacz Interpolacja i uniqueString()
.
Ten parametr działa prawidłowo, ale konta magazynu mają limity długości nazwy. Nazwa musi zawierać co najmniej 3 i nie więcej niż 24 znaki. Te wymagania można określić, dodając dekoratory do parametru .
Dodaj wiersz powyżej parametru i wpisz @. Zobaczysz dostępne dekoratory. Zwróć uwagę, że istnieją dekoratory zarówno dla minLength , jak i maxLength.
Dodaj zarówno dekoratory, jak i określ limity znaków (np. 3 i 24 poniżej):
@minLength(3)
@maxLength(24)
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
Możesz również dodać opis parametru. Dołącz informacje ułatwiające osobom wdrażającym plik Bicep, aby zrozumieć, którą wartość należy podać:
@minLength(3)
@maxLength(24)
@description('Provide a name for the storage account. Use only lowercase letters and numbers. The name must be unique across Azure.')
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
Parametry są gotowe do użycia.
Dodaj zasób
Zamiast używać fragmentu kodu do zdefiniowania konta magazynu, użyj funkcji IntelliSense, aby ustawić wartości. Funkcja IntelliSense ułatwia ten krok niż ręczne wpisywanie wartości.
Aby zdefiniować zasób, użyj słowa kluczowego resource
. Poniżej sieci wirtualnej wpisz storageAccount zasobów:
resource storageAccount
storageAccount to symboliczna nazwa wdrażanego zasobu. Możesz użyć tej nazwy, aby odwołać się do zasobu w innych częściach pliku Bicep.
Po dodaniu spacji po nazwie symbolicznej zostanie wyświetlona lista typów zasobów. Kontynuuj wpisywanie pliku storageacc , dopóki nie będzie można wybrać go z dostępnych opcji.
Po wybraniu pozycji Microsoft.Storage/storageAccounts zostaną wyświetlone dostępne wersje interfejsu API. Wybierz najnowszą wersję. Na poniższym zrzucie ekranu znajduje się 2023-05-01.
Po pojedynczym cudzysłowie dla typu zasobu dodaj = i spację. Zostaną wyświetlone opcje dodawania właściwości do zasobu. Wybierz pozycję required-properties(wymagane właściwości).
Ta opcja dodaje wszystkie właściwości typu zasobu, które są wymagane do wdrożenia. Po wybraniu tej opcji konto magazynu ma następujące właściwości:
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
name:
location:
sku: {
name:
}
kind:
}
Prawie wszystko jest gotowe, a następnym krokiem jest podanie wartości dla tych właściwości.
Ponownie funkcja IntelliSense pomaga. Ustaw name
wartość storageAccountName
, czyli parametr zawierający nazwę konta magazynu. Dla location
parametru ustaw wartość location
, czyli parametr, który został utworzony wcześniej. Podczas dodawania sku.name
funkcji i kind
funkcja IntelliSense przedstawia prawidłowe opcje.
Aby dodać opcjonalne właściwości obok wymaganych właściwości, umieść kursor w żądanej lokalizacji i naciśnij Ctrl+Spacja. Poniższy zrzut ekranu przedstawia sposób, w jaki funkcja IntelliSense sugeruje dostępne właściwości:
Po zakończeniu masz:
@minLength(3)
@maxLength(24)
@description('Provide a name for the storage account. Use only lowercase letters and numbers. The name must be unique across Azure.')
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
param location string = resourceGroup().location
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2024-05-01' = {
name: 'exampleVNet'
location: location
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'
}
}
]
}
}
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
name: storageAccountName
location: location
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
}
Aby uzyskać więcej informacji na temat składni Bicep, zobacz Bicep file structure and syntax (Struktura i składnia pliku Bicep).
Wizualizowanie zasobów
Narzędzie Bicep Visualizer przedstawia graficzną reprezentację zasobów w pliku.
Wybierz przycisk Bicep Visualizer w prawym górnym rogu, aby otworzyć narzędzie:
Ten wizualizator przedstawia zasoby zdefiniowane w pliku Bicep i łączniki między ich zależnościami. Dwa zasoby zdefiniowane w tym przewodniku Szybki start nie mają relacji zależnej, więc nie ma między nimi łącznika:
Wdrażanie pliku Bicep
Kliknij prawym przyciskiem myszy plik Bicep w programie Visual Studio Code, a następnie wybierz polecenie Wdróż plik Bicep.
W polu tekstowym Wprowadź nazwę wdrożenia wpisz deployStorageAndVNet, a następnie naciśnij ENTER.
W polu listy Wybierz grupę zasobów u góry wybierz pozycję Utwórz nową grupę zasobów.
Wprowadź exampleRG jako nazwę grupy zasobów, a następnie naciśnij ENTER.
Wybierz lokalizację dla grupy zasobów, wybierz pozycję Środkowe stany USA lub wybraną lokalizację, a następnie naciśnij ENTER.
W obszarze Wybierz plik parametrów wybierz pozycję Brak.
Utworzenie zasobów może potrwać kilka minut. Aby uzyskać więcej informacji, zobacz Wdrażanie plików Bicep za pomocą programu Visual Studio Code.
Możesz również użyć interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby wdrożyć plik Bicep:
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageAccountName=uniquename
Po zakończeniu wdrażania powinien zostać wyświetlony komunikat opisujący, że wdrożenie zakończyło się pomyślnie.
Czyszczenie zasobów
Gdy zasoby platformy Azure nie są już potrzebne, użyj interfejsu wiersza polecenia platformy Azure lub modułu Azure PowerShell, aby usunąć grupę zasobów szybkiego startu.
az group delete --name exampleRG
Następne kroki
Zapoznaj się z modułami platformy Learn dla aplikacji Bicep.