Rychlý Start: vytvoření souborů bicep pomocí Visual Studio Code

Tento rychlý Start vás provede kroky pro vytvoření souboru bicep s Visual Studio Code. Vytvoříte účet úložiště a virtuální síť. Naučíte se také, jak rozšíření bicep zjednodušuje vývoj tím, že poskytuje bezpečnost typů, ověřování syntaxe a automatického dokončování.

Požadavky

Pokud předplatné Azure ještě nemáte, napřed si vytvořte 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ů budete mít Visual Studio Code a rozšíření Bicep. máte také nejnovější rozhraní příkazového řádku Azure CLI nebo nejnovější modul Azure PowerShell.

Přidat fragment prostředků

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 poskytnutím předem definovaných fragmentů. V tomto rychlém startu přidáte fragment kódu, který vytvoří virtuální síť.

Do Main. bicep zadejte VNet. Ze seznamu vyberte res-VNet a potom TAB nebo ENTER.

Váš soubor bicep nyní 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 ale můžete upravit tak, aby splňoval vaše požadavky. Nejedná se například o name skvělý název virtuální sítě. Změňte name 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

Nyní přidáme parametr pro název účtu úložiště. V horní části souboru přidejte:

param storageName

Když přidáte místo za úložištěm, Všimněte si, že technologie IntelliSense nabízí datové typy, které jsou k dispozici pro tento parametr. Vyberte řetězec.

Máte následující parametr:

param storageName string

Tento parametr funguje správně, ale účty úložiště mají omezení délky názvu. Název musí mít aspoň 3 znaky a nesmí být delší než 24 znaků. Tyto požadavky můžete zadat přidáním dekoratéry do parametru.

Přidejte řádek nad parametr a zadejte @ . Zobrazí se dostupné dekoratéry. Všimněte si, že jsou dekoratéryy pro minLength i MaxLength.

Přidejte oba dekoratéry 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 nasazují soubor bicep, rozumí hodnotě, která se má 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

Namísto použití fragmentu k definování účtu úložiště použijeme IntelliSense k nastavení hodnot. Technologie IntelliSense tento krok je mnohem jednodušší než ruční zadání hodnot.

K definování prostředku použijte resource klíčové slovo. Pod vaší virtuální sítí zadejte exampleStorage prostředků:

resource exampleStorage

exampleStorage je symbolický název pro prostředek, který nasazujete. Tento název můžete použít k odkazování na prostředek v jiných částech souboru bicep.

Když přidáte mezeru po symbolickém názvu, zobrazí se seznam typů prostředků. Pokračujte v zadávání úložiště , dokud ho nebudete moct vybrat z dostupných možností.

Po výběru položky Microsoft. Storage /storageAccounts, zobrazí se dostupné verze rozhraní API. Vyberte 2021-02-01.

Po jednoduchých uvozovkách pro daný typ prostředku přidejte = a vložte 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@2021-02-01' = {
  name:
  location:
  sku: {
    name:
  }
  kind:

}

Už jste téměř hotovi. Pouze poskytněte hodnoty pro tyto vlastnosti.

Technologie IntelliSense vám zase pomůže. Nastavte name na storageName , což je parametr, který obsahuje název účtu úložiště. Pro location nastavte ji na 'eastus' . Při přidávání názvu a druhu SKU prezentuje technologie IntelliSense platné možnosti.

Po dokončení máte následující:

@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 levém horním rohu vyberte tlačítko Vizualizér a otevřete Vizualizér bicep.

Vizualizér zobrazuje prostředky definované v souboru bicep s informacemi o závislostech prostředků. Tyto dva prostředky definované v tomto rychlém startu nemají vztah závislostí, takže mezi těmito dvěma prostředky se nezobrazuje konektor.

Nasazení souboru bicep

Pokud chcete nasadit soubor, který jste vytvořili, otevřete PowerShell nebo Azure CLI. pokud chcete použít Visual Studio Code terminálu integrated, vyberte ctrl + ` kombinaci kláves. Změní aktuální adresář na místo, kde se nachází soubor bicep.

az group create --name exampleRG --location eastus

az deployment group create --resource-group exampleRG --template-file main.bicep --parameters storageName=uniquename

New-AzResourceGroup -Name exampleRG -Location eastus

New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -storageName "uniquename"

Po dokončení nasazení by se měla zobrazit zpráva oznamující, že nasazení proběhlo úspěšně.

Vyčištění prostředků

pokud už prostředky azure nepotřebujete, odstraňte pomocí modulu azure CLI nebo Azure PowerShell skupinu prostředků pro rychlý start.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Další kroky