Sdílet prostřednictvím


Kurz: Použití referenčních informací k šabloně ARM

Zjistěte, jak najít informace o schématu šablony a použít je k vytvoření šablon Azure Resource Manager (šablon ARM).

V tomto kurzu použijete základní šablonu ze šablon Azure Pro rychlý start. Pomocí referenční dokumentace k šabloně ověříte šablonu.

referenční informace k šabloně Resource Manager nasazení účtu úložiště

Tento kurz se zabývá následujícími úkony:

  • Otevření šablony pro rychlý start
  • Vysvětlení šablony
  • Vyhledání referenčních informací k šablonám
  • Úprava šablony
  • Nasazení šablony

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

Požadavky

K dokončení tohoto článku potřebujete:

Otevření šablony pro rychlý start

Šablony azure pro rychlý start jsou úložiště pro šablony ARM. Místo vytvoření šablony úplně od začátku si můžete najít ukázkovou šablonu a přizpůsobit ji. Šablona, kterou jsme použili v tomto rychlém startu, se nazývá Create a standard storage account (Vytvoření standardního účtu úložiště). Šablona definuje prostředek účtu služby Azure Storage.

  1. V editoru Visual Studio Code vyberte Soubor>Otevřít soubor.

  2. Do pole File name (Název souboru) vložte následující adresu URL:

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
    
  3. Výběrem Open (Otevřít) soubor otevřete.

  4. Vyberte Soubor>Uložit jako a uložte soubor jako azuredeploy.json do místního počítače.

Vysvětlené schématu

  1. V editoru Visual Studio Code sbalte šablonu do kořenové úrovně. Vidíte nejjednodušší strukturu s následující elementy:

    Nejjednodušší struktura šablony Resource Manageru

    • $schema: Zadejte umístění souboru schématu JSON, který popisuje verzi jazyka šablony.
    • contentVersion: Zadejte libovolnou hodnotu pro tento prvek, aby bylo možné zdokumentovat významné změny v šabloně.
    • metadata: Zadejte metadata šablony.
    • parameters: Zadejte hodnoty, které se zadají při spuštění nasazení, aby se přizpůsobilo nasazení prostředků.
    • variables: Zadejte hodnoty, které se v šabloně použijí jako fragmenty JSON, aby se zjednodušily výrazy jazyka šablony. Tato šablona tento prvek neobsahuje.
    • resources: Zadejte typy prostředků, které se nasazují nebo aktualizují ve skupině prostředků.
    • outputs: Zadejte hodnoty, které se vrátí po nasazení.
  2. Rozbalte položku resources. K dispozici je Microsoft.Storage/storageAccounts definovaný prostředek. Verze rozhraní API zobrazená na snímku obrazovky je 2022-09-01. Název skladové položky používá hodnotu parametru. Parametr se nazývá storageAccountType.

    Definice účtu úložiště v šabloně Resource Manageru

  3. Rozbalením parameters zjistíte, jak storageAccountType se definuje. Parametr má osm povolených hodnot. Resource Manager sku prostředků účtu úložiště šablony

Pomocí odkazu na šablonu můžete zjistit, jestli používáte nejnovější verzi rozhraní API a jestli definice parametru obsahuje všechny povolené hodnoty.

Vyhledání referenčních informací k šablonám

  1. Přejděte na referenční informace k šabloně Azure.

  2. Do pole Filtrovat podle názvu zadejte účty úložiště a v části Referenční > úložiště vyberte první účty úložiště.

    Odkaz šablony Azure Resource Manageru na účet úložiště

  3. Vyberte Šablonu ARM.

  4. Typ prostředku má obvykle několik verzí rozhraní API. Tato stránka zobrazuje ve výchozím nastavení nejnovější verzi schématu šablony. Pokud chcete zobrazit verze, vyberte rozevírací seznam Nejnovější . Nejnovější verze zobrazená na snímku obrazovky je 2022-09-01. Pokud chcete zobrazit nejnovější verzi, vyberte Buď Nejnovější , nebo verzi přímo pod nejnovější verzí. Ujistěte se, že tato verze odpovídá verzi použité pro prostředek účtu úložiště v šabloně. Pokud aktualizujete verzi rozhraní API, ověřte, že definice prostředku odpovídá odkazu na šablonu.

    Referenční verze účtu úložiště Resource Manager šablony

  5. Na této stránce jsou uvedeny podrobnosti o typu prostředku storageAccount. Vypíše například povolené hodnoty pro objekt skladové položky . Existuje osm skladových položek a odpovídají těm, které jsou uvedené v šabloně pro rychlý start, kterou jste otevřeli dříve.

    referenční skladové položky účtu úložiště Resource Manager šablony

Nasazení šablony

  1. Přihlaste se k Azure Cloud Shell

  2. Vyberte upřednostňované prostředí tak, že v levém horním rohu vyberete PowerShell nebo Bash (pro rozhraní příkazového řádku). Po přepnutí se vyžaduje restartování prostředí.

    Azure Portal Cloud Shell nahrání souboru

  3. Vyberte Nahrát nebo stáhnout soubory a potom vyberte Nahrát. Viz předchozí snímek obrazovky. Vyberte soubor, který jste uložili v předchozí části. Po nahrání souboru můžete pomocí ls příkazu a cat příkazu ověřit, že se soubor úspěšně nahrál.

  4. V Cloud Shell spusťte následující příkazy. Výběrem odpovídající karty zobrazíte kód PowerShellu nebo kód rozhraní příkazového řádku.

    Při nasazování šablony zadejte storageAccountType parametr s nově přidanou hodnotou, například Standard_RAGRS. Nasazení by selhalo, pokud jste použili původní šablonu rychlého startu, protože Standard_RAGRS nebyla povolená hodnota.

    echo "Enter a project name that is used to generate resource group name:" &&
    read projectName &&
    echo "Enter the location (i.e. centralus):" &&
    read location &&
    resourceGroupName="${projectName}rg" &&
    az group create --name $resourceGroupName --location "$location" &&
    az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
    

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

Pokud už nasazené prostředky Azure nepotřebujete, vyčistěte je odstraněním skupiny prostředků.

  1. V Azure Portal v nabídce vlevo vyberte Skupina prostředků.
  2. Do pole Filtrovat podle názvu zadejte název skupiny prostředků.
  3. Vyberte název skupiny prostředků. Ve skupině prostředků uvidíte celkem šest prostředků.
  4. V horní nabídce vyberte Odstranit skupinu prostředků .

Další kroky

V tomto kurzu jste se dozvěděli, jak přizpůsobit existující šablonu pomocí odkazu na šablonu. Naučte se, jak vytvořit několik instancí účtu úložiště, viz: