Sdílet prostřednictvím


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ř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].

Snímek obrazovky s přidáním fragmentu kódu pro virtuální síť

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.

Snímek obrazovky s přidáním typu řetězce do parametru

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.

Snímek obrazovky s přidáním dekorátorů k parametru

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í.

Snímek obrazovky s výběrem účtů úložiště pro typ prostředku

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.

Snímek obrazovky s výběrem verze rozhraní API pro typ prostředku

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.

Snímek obrazovky s přidáním požadovaných vlastností

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

Další kroky