Rychlý start: Vytvoření souborů Bicep pomocí editoru Visual Studio Code
V tomto rychlém startu se dozvíte, jak pomocí editoru Visual Studio Code vytvořit soubor Bicep. Vytvoříte účet úložiště a virtuální síť. Dozvíte se také, jak rozšíření Bicep poskytuje zabezpečení typů, ověřování syntaxe a automatické dokončování pro zjednodušení vývoje.
Visual Studio podporuje podobné prostředí pro vytváření obsahu. Další informace najdete v tématu Rychlý start: Vytvoření souborů Bicep pomocí sady Visual Studio .
Požadavky
Pokud nemáte předplatné Azure, vytvořte si před zahájením bezplatný účet .
Pokud chcete nastavit prostředí pro vývoj bicep, přečtěte si téma Instalace nástrojů Bicep. Po dokončení těchto kroků máte nainstalovaný Visual Studio Code a rozšíření Bicep. Máte také nejnovější verzi Azure CLI nebo modul Azure PowerShellu.
Přidání fragmentu kódu prostředku
Visual Studio Code s rozšířením Bicep poskytuje předdefinované fragmenty kódu pro zjednodušení vývoje. V tomto rychlém startu přidáte fragment kódu, který vytvoří virtuální síť.
Spusťte Visual Studio Code a vytvořte nový soubor s názvem main.bicep. Do souboru main.bicep zadejte virtuální síť, vyberte ze seznamu možnost res-vnet a stiskněte klávesu TAB nebo ENTER.
Tip
Pokud tyto možnosti IntelliSense v editoru Visual Studio Code nevidíte, ujistěte se, že jste nainstalovali rozšíření Bicep podle požadavků. Pokud jste rozšíření nainstalovali, dejte službě jazyka Bicep nějaký čas začít po otevření souboru Bicep. Obvykle se spustí rychle a nebudete mít možnosti IntelliSense, dokud se nespustí. Oznámení v pravém dolním rohu znamená, že služba začíná. Když toto oznámení zmizí, služba je spuštěná.
Váš soubor Bicep teď obsahuje následující kód:
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'
}
}
]
}
}
V tomto fragmentu kódu najdete všechny potřebné hodnoty pro definování virtuální sítě. Můžete si všimnout dvou složených podtržení. Žlutá označuje upozornění související se zastaralou verzí rozhraní API, zatímco červené složených podtržení signalizuje chybu způsobenou chybějící definicí parametru. Nástroj Bicep linter kontroluje chyby syntaxe a porušení osvědčených postupů v souborech Bicep. Najeďte myší na @2019-11-01, automaticky otevírané podokno ukazuje použití novější verze rozhraní API pro Microsoft.Network/virtualNetworks. V místním podokně vyberte Rychlá oprava a pak výběrem možnosti Nahradit 2024-05-01 aktualizujte verzi rozhraní API.
Alternativně odeberte @2019-11-01a nahraďte ho .@ Vyberte nejnovější verzi rozhraní API.
Chybu definice chybějícího parametru opravíte v další části.
Tento kód můžete také upravit tak, aby splňoval vaše požadavky. Například vzhledem k tomu, že name není jasný název virtuální sítě, můžete name změnit vlastnost na exampleVnet:
name: 'exampleVNet'
Přidání parametru
Fragment kódu, který jste přidali v poslední části, vynechá definici parametru, locationjak je uvedeno červeným složeným podtržením. V horní části souboru přidejte:
param location
Když za umístění přidáte mezeru, všimněte si, že IntelliSense nabízí datové typy, které jsou pro parametr k dispozici. Vyberte řetězec.
Dejte parametru výchozí hodnotu:
param location string = resourceGroup().location
Předchozí řádek přiřadí umístění skupiny prostředků k prostředku virtuální sítě. Další informace o funkci použité ve výchozí hodnotě naleznete v tématu resourceGroup().
V horní části souboru přidejte další parametr pro název účtu úložiště (který vytvoříte později v rychlém startu) s výchozí hodnotou:
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
Další informace naleznete v tématu Interpolace a uniqueString().
Tento parametr funguje správně, ale účty úložiště mají omezení délky názvu. Název musí mít alespoň 3 a nesmí obsahovat více než 24 znaků. Tyto požadavky můžete zadat přidáním dekorátorů do parametru.
Přidejte řádek nad parametr a zadejte @. Zobrazí se dostupné dekorátory. Všimněte si, že pro minLength i maxLength existují dekorátory.
Přidejte oba dekorátory a zadejte omezení znaků (např. 3 a 24 níže):
@minLength(3)
@maxLength(24)
param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
Můžete také přidat popis parametru. Uveďte informace, které lidem, kteří nasazují soubor Bicep, abyste pochopili, jakou hodnotu mají poskytnout:
@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)}'
Vaše parametry jsou připravené k použití.
Přidat prostředek
Místo použití fragmentu kódu k definování účtu úložiště použijete IntelliSense k nastavení hodnot. IntelliSense usnadňuje tento krok než ruční zadávání hodnot.
K definování prostředku použijte resource klíčové slovo. Pod virtuální sítí zadejte účet úložiště prostředků:
resource storageAccount
storageAccount je symbolický název prostředku, který nasazujete. Tento název můžete použít k odkazování na prostředek v jiných částech souboru Bicep.
Když za symbolický název přidáte mezeru, zobrazí se seznam typů prostředků. Pokračujte v psaní úložiště, dokud ho nebudete moct vybrat z dostupných možností.
Po výběru Microsoft.Storage/storageAccounts se zobrazí dostupné verze rozhraní API. Vyberte nejnovější verzi. Na následujícím snímku obrazovky je to 2023-05-01.
Za jedinou uvozovku pro typ prostředku přidejte = a mezeru. Zobrazí se možnosti přidání vlastností do prostředku. Vyberte požadované vlastnosti.
Tato možnost přidá všechny vlastnosti pro typ prostředku, které jsou požadovány pro nasazení. Po výběru této možnosti má váš účet úložiště následující vlastnosti:
resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
name:
location:
sku: {
name:
}
kind:
}
Už jste skoro hotovi a dalším krokem je zadání hodnot pro tyto vlastnosti.
IntelliSense vám opět pomůže. Nastavte name na storageAccountNamehodnotu , což je parametr, který obsahuje název účtu úložiště. Pro locationnastavení na locationhodnotu , což je parametr, který jste vytvořili dříve. Při přidávání sku.name a kindzobrazí IntelliSense platné možnosti.
Pokud chcete přidat volitelné vlastnosti vedle požadovaných vlastností, umístěte kurzor na požadované místo a stiskněte klávesu Ctrl+Mezerník. Následující snímek obrazovky ukazuje, jak IntelliSense navrhuje dostupné vlastnosti:
Po dokončení máte:
@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'
}
Další informace o syntaxi Bicep naleznete v tématu Struktura a syntaxe souboru Bicep.
Vizualizace prostředků
Vizualizér Bicep zobrazuje grafické znázornění prostředků v souboru.
Výběrem tlačítka Vizualizér Bicep v pravém horním rohu nástroj otevřete:
Tento vizualizér zobrazuje prostředky definované v souboru Bicep a konektory mezi jejich závislostmi. Dva prostředky definované v tomto rychlém startu nemají závislý vztah, takže mezi nimi není konektor:
Nasazení souboru Bicep
Klikněte pravým tlačítkem myši na soubor Bicep v editoru Visual Studio Code a pak vyberte Nasadit soubor Bicep.
Do textového pole Zadejte název nasazení zadejte deployStorageAndVNet a stiskněte ENTER.
V seznamu Vybrat skupinu prostředků v horní části vyberte Vytvořit novou skupinu prostředků.
Jako název skupiny prostředků zadejte exampleRG a stiskněte klávesu ENTER.
Vyberte umístění pro skupinu prostředků, vyberte USA – střed nebo umístění podle vašeho výběru a stiskněte enter.
V části Vybrat soubor parametrů vyberte Možnost Žádné.
Vytvoření prostředků chvíli trvá. Další informace najdete v tématu Nasazení souborů Bicep pomocí editoru Visual Studio Code.
K nasazení souboru Bicep můžete použít také Azure CLI nebo Azure PowerShell:
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageAccountName=uniquename
Po dokončení nasazení by se měla zobrazit zpráva popisující, že nasazení bylo úspěšné.
Vyčištění prostředků
Pokud už prostředky Azure nepotřebujete, pomocí azure CLI nebo modulu Azure PowerShell odstraňte skupinu prostředků pro rychlý start.
az group delete --name exampleRG
Další kroky
Prozkoumejte moduly Learn pro Bicep.