Rychlý start: Vytváření souborů Bicep pomocí editoru Visual Studio Code

Tento rychlý start vás provede postupem vytvoření souboru Bicep pomocí editoru Visual Studio Code. 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 sadě Visual Studio. Viz Rychlý start: Vytváření souborů Bicep pomocí sady Visual Studio.

Požadavky

Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.

Informace o nastavení prostředí pro vývoj bicep najdete v tématu Instalace nástrojů Bicep. Po dokončení těchto kroků budete mít Visual Studio Code a rozšíření Bicep. Máte také nejnovější Azure CLI nebo nejnovější modul Azure PowerShell.

Přidání fragmentu kódu prostředku

Spusťte Visual Studio Code a vytvořte nový soubor s názvem main.bicep.

VS Code 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 pak stiskněte klávesu Tab nebo Enter.

Přidání fragmentu kódu pro virtuální síť

Tip

Pokud v editoru VS Code tyto možnosti IntelliSense 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 nesstartuje. Oznámení v pravém dolním rohu znamená, že se služba spouští. 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: resourceGroup().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 není name skvělý název pro virtuální síť. name Změňte vlastnost na examplevnet.

name: 'examplevnet'

Tento soubor Bicep můžete nasadit, ale před nasazením přidáme parametr a účet úložiště.

Přidání parametru

Teď přidáme parametr pro název účtu úložiště. 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.

Přidání typu řetězce do parametru

Máte následující parametr:

param storageName string

Tento parametr funguje správně, ale pro účty úložiště platí omezení týkající se délky názvu. Název musí mít 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řidání dekorátorů k parametru

Přidejte oba dekorátory a určete limity znaků, jak je znázorněno níže:

@minLength(3)
@maxLength(24)
param storageName string

Můžete také přidat popis parametru . Zahrnout informace, které lidem nasazující 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

Váš parametr je připravený k použití.

Přidat prostředek

Místo použití fragmentu kódu 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í storage , dokud ho nebudete moct vybrat z dostupných možností.

Jako typ prostředku vyberte účty úložiště.

Po výběru Microsoft. Úložiště/storageAccounts– zobrazí se dostupné verze rozhraní API. Vyberte 2021-02-01.

Jako typ prostředku vyberte verzi rozhraní API.

Za jednoduchou uvozovku pro typ prostředku přidejte = a mezeru. Zobrazí se možnosti pro přidání vlastností k prostředku. Vyberte required-properties (požadované vlastnosti).

Přidání požadovaných vlastností

Tato možnost přidá všechny vlastnosti pro typ prostředku, které se vyžadují 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@2021-02-01' = {
  name:
  location:
  sku: {
    name:
  }
  kind:

}

Už jste téměř hotovi. Stačí zadat hodnoty těchto vlastností.

Opět vám pomůže intellisense. Nastavte name na storageName, což je parametr, který obsahuje název účtu úložiště. Nastavte locationho na 'eastus'. Při přidávání názvu a druhu skladové položky intellisense zobrazí platné možnosti.

Po dokončení budete mít:

@minLength(3)
@maxLength(24)
param storageName string

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2019-11-01' = {
  name: 'examplevnet'
  location: resourceGroup().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@2021-02-01' = {
  name: storageName
  location: 'eastus'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}

Další informace o syntaxi Bicep najdete v tématu Struktura Bicep.

Vizualizace prostředků

Můžete zobrazit reprezentaci prostředků v souboru.

Výběrem tlačítka vizualizéru v pravém horním rohu otevřete Vizualizér Bicep.

Vizualizér Bicep

Vizualizér zobrazí prostředky definované v souboru Bicep s informacemi o závislostech prostředků. Dva prostředky definované v tomto rychlém startu nemají vztah závislostí, takže mezi těmito dvěma prostředky nevidíte konektor.

Nasazení souboru Bicep

  1. Klikněte pravým tlačítkem na soubor Bicep uvnitř VSCode a pak vyberte Deploy Bicep file (Nasadit soubor Bicep).

    Snímek obrazovky s nasazením souboru Bicep

  2. V seznamu Vybrat skupinu prostředků v horní části vyberte Vytvořit novou skupinu prostředků.

  3. Jako název skupiny prostředků zadejte exampleRG a stiskněte [ENTER].

  4. Vyberte umístění skupiny prostředků a stiskněte klávesu [ENTER].

  5. V části Vybrat soubor parametrů vyberte Žádný.

    Snímek obrazovky se souborem parametrů pro výběr

  6. Zadejte jedinečný název účtu úložiště a stiskněte [ENTER]. Pokud se zobrazí chybová zpráva s informací, že účet úložiště je už zabraný, používá se zadaný název úložiště. Zadejte název, který bude pravděpodobně jedinečný.

  7. V části Vytvořit soubor parametrů z hodnot použitých v tomto nasazení? vyberte Ne.

Vytvoření prostředků chvíli trvá. Další informace najdete v tématu Nasazení souborů Bicep pomocí editoru Visual Studio Code.

Soubor Bicep můžete nasadit také 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