Cvičení – definování prostředků v šabloně Bicep

  • 12 min

Poznámka:

Při prvním aktivaci sandboxu a přijetí podmínek je váš účet Microsoft přidružený k novému adresáři Azure s názvem Microsoft Learn Sandbox. Také jste přidáni do speciálního předplatného s názvem Concierge Subscription.

Pro váš web toy-launch se rozhodnete nejprve vytvořit testování konceptu vytvořením základní šablony Bicep. V tomto cvičení vytvoříte účet úložiště, Aplikace Azure plán služby a aplikaci. Později šablonu upravíte, aby byla opakovaně použitelná.

Během tohoto procesu:

  • Vytvořte šablonu, která definuje jeden prostředek účtu úložiště, který obsahuje pevně zakódované hodnoty.
  • Zřiďte infrastrukturu a ověřte výsledek.
  • Přidejte do šablony plán služby App Service a aplikaci.
  • Znovu zřiďte infrastrukturu, abyste viděli nové prostředky.

V tomto cvičení se používá rozšíření Bicep pro Visual Studio Code. Nezapomeňte toto rozšíření do Visual Studio Codu nainstalovat.

Vytvoření šablony Bicep, která obsahuje účet úložiště

  1. Otevřete Visual Studio Code.

  2. Vytvořte nový soubor s názvem main.bicep.

  3. Uložte prázdný soubor tak, aby Visual Studio Code načítal nástroje Bicep.

    Můžete vybrat možnost Uložit jako soubor>nebo vybrat Kombinaci kláves Ctrl+S ve Windows (⌘+S v systému macOS). Nezapomeňte si zapamatovat, kam jste soubor uložili. Můžete například chtít vytvořit složku šablon , do které chcete soubor uložit.

  4. Do souboru přidejte následující kód Bicep. Šablonu nasadíte brzy. Místo kopírování a vkládání je vhodné zadat kód sami, abyste viděli, jak vám nástroje pomáhají psát soubory Bicep.

    resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'toylaunchstorage'
  location: 'eastus'
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

    Tip

    Bicep je striktní na místo, kam vkládáte konce řádků, proto se ujistěte, že neukládejte konce řádků na různá místa, než je uvedeno tady.

    Všimněte si, že Visual Studio Code při psaní automaticky navrhne názvy vlastností. Rozšíření Bicep pro Visual Studio Code rozumí prostředkům, které definujete v šabloně, a obsahuje seznam dostupných vlastností a hodnot, které můžete použít.

  5. Aktualizujte název účtu úložiště na toylaunchstorage něco, co bude pravděpodobně jedinečné, protože každý účet úložiště potřebuje globálně jedinečný název. Ujistěte se, že název je 3 až 24 znaků a obsahuje jenom malá písmena a číslice.

    Důležité

    Tento krok nepřeskočte. Pokud to uděláte, soubor Bicep se úspěšně nenasadí.

  6. Uložte změny souboru.

Nasazení šablony Bicep do Azure

Pokud chcete tuto šablonu nasadit do Azure, musíte se přihlásit ke svému účtu Azure z terminálu editoru Visual Studio Code. Ujistěte se, že jste nainstalovali Azure CLI, a nezapomeňte se přihlásit pomocí stejného účtu, který jste použili k aktivaci sandboxu.

  1. V nabídce Terminal (Terminál) vyberte New Terminal (Nový terminál). Okno terminálu se obvykle otevře v dolní polovině obrazovky.

  2. Pokud je prostředí zobrazené na pravé straně okna terminálu Bash, je otevřené správné prostředí a můžete přejít k další části.

    Snímek obrazovky okna terminálu editoru Visual Studio Code se zobrazenou možností Bash

  3. Pokud se zobrazí jiné prostředí než Bash, vyberte šipku rozevíracího seznamu prostředí a pak vyberte Azure Cloud Shell (Bash).

    Snímek obrazovky okna terminálu editoru Visual Studio Code s rozevíracím seznamem prostředí terminálu a vybranou možností Výchozí git Bash

  4. V seznamu terminálových prostředí vyberte Bash.

    Snímek obrazovky okna terminálu editoru Visual Studio Code s vybraným terminálem Bash

  5. V terminálu přejděte do adresáře, do kterého jste šablonu uložili. Pokud jste například šablonu uložili do složky templates , můžete použít tento příkaz:

    cd templates

Instalace Bicep

Spuštěním následujícího příkazu se ujistěte, že máte nejnovější verzi Bicep:

az bicep install && az bicep upgrade

Přihlášení k Azure

  1. V terminálu editoru Visual Studio Code se přihlaste k Azure spuštěním následujícího příkazu:

    az login

  2. V prohlížeči, který se otevře, se přihlaste ke svému účtu Azure.

    V terminálu editoru Visual Studio Code se zobrazí seznam předplatných přidružených k tomuto účtu.

  3. Nastavte výchozí předplatné pro všechny příkazy Azure CLI, které spustíte v této relaci.

    az account set --subscription "Concierge Subscription"

    Poznámka:

    Pokud jste nedávno použili více než jeden sandbox, může se v terminálu zobrazit více než jedna instance předplatného Concierge. V tomto případě použijte následující dva kroky k nastavení jednoho jako výchozího předplatného. Pokud předchozí příkaz proběhl úspěšně a zobrazí se jenom jedno předplatné Concierge, přeskočte následující dva kroky.

  4. Získejte ID předplatného Concierge Subscription.

     az account list \
   --refresh \
   --query "[?contains(name, 'Concierge Subscription')].id" \
   --output table

  5. Nastavte výchozí předplatné pomocí ID předplatného. Nahraďte {ID vašeho předplatného} za ID nejnovějšího předplatného Concierge Subscription.

    az account set --subscription {your subscription ID}

Nastavení výchozí skupiny prostředků

Když použijete Azure CLI, můžete v tomto cvičení nastavit výchozí skupinu prostředků a vynechat parametr ze zbývajících příkazů Azure CLI. Nastavte výchozí hodnotu na skupinu prostředků, která je pro vás vytvořená v prostředí sandboxu.

az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"

Nasazení šablony do Azure

Spuštěním následujícího příkazu z terminálu v editoru Visual Studio Code nasaďte šablonu Bicep do Azure. Dokončení příkazu může trvat minutu nebo dvě a pak se zobrazí úspěšné nasazení. Pokud se zobrazí upozornění na pevně zakódované umístění, můžete ho ignorovat. Umístění opravíte později v modulu. Je bezpečné pokračovat a nasazení bude úspěšné.

az deployment group create --template-file main.bicep

V terminálu uvidíte Running....

Pokud chcete tuto šablonu nasadit do Azure, přihlaste se ke svému účtu Azure z terminálu editoru Visual Studio Code. Ujistěte se, že jste nainstalovali Azure PowerShell, a přihlaste se ke stejnému účtu, který aktivoval sandbox.

  1. V nabídce Terminal (Terminál) vyberte New Terminal (Nový terminál). Okno terminálu se obvykle otevře v dolní polovině obrazovky.

  2. Pokud je prostředí zobrazené na pravé straně okna terminálu powershell nebo pwsh, otevře se správné prostředí a můžete přejít k další části.

    Snímek obrazovky okna terminálu editoru Visual Studio Code s možností pwsh zobrazenou v rozevíracím seznamu prostředí

  3. Pokud se zobrazí jiné prostředí než PowerShell nebo pwsh, vyberte šipku rozevíracího seznamu prostředí a pak vyberte PowerShell.

    Snímek obrazovky okna terminálu editoru Visual Studio Code se zobrazeným rozevíracím seznamem prostředí terminálu a vybranou možností PowerShellu

  4. V seznamu terminálových prostředí vyberte PowerShell nebo pwsh.

    Snímek obrazovky okna terminálu editoru Visual Studio Code s vybraným terminálem PowerShellu

  5. V terminálu přejděte do adresáře, do kterého jste šablonu uložili. Pokud jste například šablonu uložili do složky templates , můžete použít tento příkaz:

    Set-Location -Path templates

Instalace rozhraní příkazového řádku Bicep

Pokud chcete použít Bicep z Azure PowerShellu, nainstalujte rozhraní příkazového řádku Bicep.

Přihlášení k Azure přes Azure PowerShell

  1. V terminálu editoru Visual Studio Code spusťte následující příkaz:

    Connect-AzAccount

    Otevře se prohlížeč, abyste se mohli přihlásit ke svému účtu Azure.

  2. Po přihlášení k Azure se v terminálu zobrazí seznam předplatných přidružených k tomuto účtu.

    Pokud jste aktivovali sandbox, zobrazí se předplatné s názvem Concierge Subscription . Použijte ho pro zbytek cvičení.

  3. Nastavte výchozí předplatné pro všechny příkazy Azure PowerShellu, které spustíte v této relaci.

    $context = Get-AzSubscription -SubscriptionName 'Concierge Subscription'
Set-AzContext $context

    Poznámka:

    Pokud jste nedávno použili více než jeden sandbox, může se v terminálu zobrazit více než jedna instance předplatného Concierge. V tomto případě použijte následující dva kroky k nastavení jednoho jako výchozího předplatného. Pokud předchozí příkaz proběhl úspěšně a zobrazí se jenom jedno předplatné Concierge, přeskočte následující dva kroky.

  4. Zjistěte ID předplatného. Spuštěním následujícího příkazu zobrazíte seznam vašich předplatných a jejich ID. Concierge SubscriptionVyhledejte a zkopírujte ID z druhého sloupce. Vypadá to jako aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e.

    Get-AzSubscription

  5. Změňte své aktivní předplatné na Concierge Subscription. Nezapomeňte nahradit {ID vašeho předplatného} za id, které jste zkopírovali.

    $context = Get-AzSubscription -SubscriptionId {Your subscription ID}
Set-AzContext $context

Nastavení výchozí skupiny prostředků

Výchozí skupinu prostředků můžete nastavit a vynechat parametr ze zbývajících příkazů Azure PowerShellu v tomto cvičení. Nastavte tuto výchozí hodnotu na skupinu prostředků vytvořenou pro vás v sandboxovém prostředí.

Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>

Nasazení šablony do Azure

Nasaďte šablonu do Azure pomocí následujícího příkazu Azure PowerShellu v terminálu. Dokončení příkazu může trvat minutu nebo dvě a zobrazí se úspěšné nasazení. Pokud se zobrazí upozornění na pevně zakódované umístění, můžete ho ignorovat. Umístění opravíte později v modulu. Je bezpečné pokračovat a nasazení bude úspěšné.

New-AzResourceGroupDeployment -TemplateFile main.bicep

Ověření nasazení

Při prvním nasazení šablony Bicep můžete pomocí webu Azure Portal ověřit, jestli se nasazení úspěšně dokončilo, a zkontrolovat výsledky.

  1. Přejděte na web Azure Portal a ujistěte se, že jste v předplatném sandboxu:

    1. V pravém horním rohu stránky vyberte svůj avatar.
    2. Vyberte Přepnout adresář. V seznamu vyberte adresář Microsoft Learn Sandbox.

  2. Na levém panelu vyberte Skupiny prostředků.

  3. Vyberte [název skupiny prostředků sandboxu].

  4. V přehledu vidíte, že jedno nasazení bylo úspěšné. Možná budete muset rozbalit oblast Základy , abyste viděli nasazení.

    Snímek obrazovky s rozhraním webu Azure Portal pro přehled skupiny prostředků s oddílem nasazení, který ukazuje, že jedno bylo úspěšné

  5. Pokud chcete zobrazit podrobnosti o nasazení, vyberte možnost označující 1 úspěšné nasazení.

    Snímek obrazovky s rozhraním webu Azure Portal pro nasazení se seznamem nasazení a úspěšným stavem

  6. Vyberte nasazení označované jako hlavní , abyste viděli, které prostředky byly nasazeny, a pak vyberte Podrobnosti nasazení a rozbalte ho. V tomto případě existuje jeden účet úložiště s názvem, který jste zadali.

    Snímek obrazovky s rozhraním webu Azure Portal pro konkrétní nasazení se seznamem jednoho prostředku účtu úložiště

  7. Nechte stránku v prohlížeči otevřenou. Nasazení znovu zkontrolujete později.

Nasazení můžete ověřit také z příkazového řádku. Provedete to spuštěním následujícího příkazu Azure CLI:

az deployment group list --output table

Nasazení můžete ověřit také z příkazového řádku. Provedete to spuštěním následujícího příkazu Azure PowerShellu:

Get-AzResourceGroupDeployment -ResourceGroupName <rgn>[sandbox resource group name]</rgn> | Format-Table

Přidání plánu služby App Service a aplikace do šablony Bicep

V předchozím úkolu jste zjistili, jak vytvořit šablonu obsahující jeden prostředek a nasadit ji. Teď jste připraveni nasadit další prostředky, včetně závislosti. V této úloze přidáte do šablony Bicep plán služby App Service a aplikaci.

  1. V souboru main.bicep v editoru Visual Studio Code přidejte do dolní části souboru následující kód:

    resource appServicePlan 'Microsoft.Web/serverfarms@2023-12-01' = {
  name: 'toy-product-launch-plan-starter'
  location: 'eastus'
  sku: {
    name: 'F1'
  }
}

resource appServiceApp 'Microsoft.Web/sites@2023-12-01' = {
  name: 'toy-product-launch-1'
  location: 'eastus'
  properties: {
    serverFarmId: appServicePlan.id
    httpsOnly: true
  }
}

  2. Aktualizujte název aplikace App Service z toy-product-launch-1 něčeho, co bude pravděpodobně jedinečné. Ujistěte se, že je název 2 až 60 znaků s velkými a malými písmeny, číslicemi a pomlčkami a nezačíná ani nekončí pomlčkou.

  3. Uložte změny souboru.

Nasazení aktualizované šablony Bicep

V terminálu spusťte následující příkaz Azure CLI. Upozornění týkající se pevně zakódovaného umístění můžete ignorovat. Umístění brzy opravíte.

az deployment group create --template-file main.bicep

V terminálu spusťte následující příkaz Azure PowerShellu. Zprávy upozornění o pevně zakódovaném umístění můžete ignorovat. Umístění brzy opravíte.

New-AzResourceGroupDeployment -TemplateFile main.bicep

Kontrola nasazení

  1. Vraťte se na web Azure Portal a přejděte do skupiny prostředků. Stále uvidíte jedno úspěšné nasazení, protože nasazení použilo stejný název jako první nasazení.

  2. Vyberte odkaz 1 Úspěch.

  3. Vyberte nasazení s názvem hlavní a pak výběrem podrobností o nasazení rozbalte seznam nasazených prostředků.

    Snímek obrazovky znázorňující rozhraní webu Azure Portal pro konkrétní nasazení s uvedeným účtem úložiště a prostředky služby App Service

  4. Všimněte si, že se nasadil plán služby App Service a aplikace.