Rychlý start: Vytváření souborů Bicep pomocí sady Visual Studio
Tento rychlý start vás provede postupem vytvoření souboru Bicep pomocí sady Visual Studio. Vytvoříte účet úložiště a virtuální síť. Dozvíte se také, jak rozšíření Bicep zjednodušuje vývoj tím, že poskytuje bezpečnost typů, ověřování syntaxe a automatické dokončování.
Podobné prostředí pro vytváření obsahu je také podporováno v editoru Visual Studio Code. Viz Rychlý start: Vytváření souborů Bicep pomocí editoru Visual Studio Code.
Požadavky
- Předplatné Azure. Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.
- Visual Studio verze 17.3.0 preview 3 nebo novější. Viz Visual Studio Preview.
- Rozšíření Visual Studio Bicep. Viz Visual Studio Marketplace.
- Nasazení souboru Bicep vyžaduje buď nejnovější Azure CLI, nebo nejnovější modul Azure PowerShell.
Přidání fragmentu prostředku
Spusťte Visual Studio a vytvořte nový soubor s názvem main.bicep.
Visual Studio s rozšířením Bicep zjednodušuje vývoj tím, že poskytuje předdefinované fragmenty kódu. V tomto rychlém startu přidáte fragment kódu, který vytvoří virtuální síť.
V souboru main.bicep zadejte vnet. V seznamu vyberte res-vnet a stiskněte [TAB] nebo [ENTER].
Tip
Pokud tyto možnosti IntelliSense v sadě Visual Studio nevidíte, ujistěte se, že jste nainstalovali rozšíření Bicep, jak je uvedeno v požadavcích. Pokud jste nainstalovali rozšíření, dejte službě jazyka Bicep nějaký čas, aby se spustila po otevření souboru Bicep. Obvykle se spustí rychle, ale nebudete mít k dispozici možnosti IntelliSense, dokud se nesstartuje.
Soubor Bicep teď obsahuje následující kód:
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2023-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'
}
}
]
}
}
Tento fragment kódu obsahuje všechny hodnoty, které potřebujete k definování virtuální sítě. Tento kód však můžete upravit tak, aby splňoval vaše požadavky. Například name není skvělý název pro virtuální síť.
name Změňte vlastnost na exampleVnet.
name: 'exampleVnet'
Umístění oznámení má červené složené podtržení. To značí problém. Najeďte myší na umístění. Chybová zpráva: Název "umístění" v aktuálním kontextu neexistuje. V další části vytvoříme parametr umístění.
Přidání parametrů
Teď přidáme dva parametry pro název účtu úložiště a umístění. Na začátek souboru přidejte:
param storageName
Když přidáte mezeru za storageName, všimněte si, že intellisense nabízí datové typy, které jsou k dispozici pro parametr. Vyberte řetězec.
Máte následující parametr:
param storageName string
Tento parametr funguje bez problémů, ale účty úložiště mají omezení na délku názvu. Název musí obsahovat alespoň 3 znaky a nesmí být delší 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 existují dekorátory pro minLength i maxLength.
Přidejte obě dekorátory a určete omezení znaků, jak je znázorněno níže:
@minLength(3)
@maxLength(24)
param storageName string
Můžete také přidat popis parametru. Zahrňte informace, které lidem, kteří nasazují soubor Bicep, pomůžou pochopit hodnotu, kterou mají poskytnout.
@minLength(3)
@maxLength(24)
@description('Provide a name for the storage account. Use only lower case letters and numbers. The name must be unique across Azure.')
param storageName string
Parametr názvu účtu úložiště je připravený k použití.
Přidejte další parametr umístění:
param location string = resourceGroup().location
Přidat prostředek
Místo použití fragmentu k definování účtu úložiště použijeme k nastavení hodnot intellisense. 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íť zadejte příklad prostředkuÚložiště:
resource exampleStorage
exampleStorage 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 2021-09-01 nebo nejnovější verzi rozhraní API. Doporučujeme používat nejnovější verzi rozhraní API.
Za jednoduchou uvozovku pro typ prostředku přidejte = mezeru. Zobrazí se možnosti pro 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 exampleStorage 'Microsoft.Storage/storageAccounts@2023-04-01' = {
name: 1
location: 2
sku: {
name: 3
}
kind: 4
}
Kód má čtyři zástupné symboly. Pomocí klávesy [TAB] je projděte a zadejte hodnoty. Opět vám pomůže intellisense. Nastavte name na storageName, což je parametr, který obsahuje název účtu úložiště. V případě locationnastavte hodnotu na location. Při přidávání názvu a druhu skladové položky intellisense zobrazí platné možnosti.
Až budete hotovi, budete mít:
@minLength(3)
@maxLength(24)
@description('Provide a name for the storage account. Use only lower case letters and numbers. The name must be unique across Azure.')
param storageName string
param location string = resourceGroup().location
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2023-11-01' = {
name: storageName
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 exampleStorage 'Microsoft.Storage/storageAccounts@2023-04-01' = {
name: storageName
location: location
sku: {
name: 'Standard_LRS'
}
kind: 'StorageV2'
}
Další informace o syntaxi Bicep najdete v tématu Struktura Bicep.
Nasazení souboru Bicep
Nasazení souborů Bicep zatím nejde ze sady Visual Studio provést. Soubor Bicep můžete nasadit pomocí Azure CLI nebo Azure PowerShell:
az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageName=uniquename
Po dokončení nasazení by se měla zobrazit zpráva oznamující, že nasazení bylo úspěšné.
Vyčištění prostředků
Pokud už prostředky Azure nepotřebujete, odstraňte skupinu prostředků Rychlý start pomocí azure CLI nebo modulu Azure PowerShell.
az group delete --name exampleRG