Zelfstudie: De ARM-sjabloonverwijzing gebruiken

Meer informatie over het zoeken van de sjabloonschema-informatie en het gebruiken van deze informatie om ARM-sjablonen (Azure Resource Manager) te maken.

In deze zelfstudie gebruikt u een basissjabloon uit Azure-quickstart-sjablonen. Met behulp van sjabloonreferentiedocumentatie valideert u de sjabloon.

Deze zelfstudie bestaat uit de volgende taken:

• Een snelstartsjabloon openen
• Inzicht in de sjabloon
• De sjabloonverwijzing zoeken
• De sjabloon bewerken
• De sjabloon implementeren

Als u geen abonnement op Azure hebt, maakt u een gratis account voordat u begint.

Vereisten

Als u dit artikel wilt voltooien, hebt u het volgende nodig:

• Visual Studio Code met de extensie Resource Manager Tools. Zie Quickstart: ARM-sjablonen maken met Visual Studio Code.

Een snelstartsjabloon openen

Azure-quickstart-sjablonen is een opslagplaats voor ARM-sjablonen. In plaats van een sjabloon helemaal vanaf de basis te maken, kunt u een voorbeeldsjabloon zoeken en aanpassen. De in deze snelstart gebruikte sjabloon wordt Create a standard storage account (Standaardopslagaccount maken) genoemd. De sjabloon definieert een Azure Storage-accountresource.

1. Selecteer in Visual Studio Code Bestand>Bestand openen.

2. Plak de volgende URL in Bestandsnaam:

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. Selecteer Openen om het bestand te openen.

4. Selecteer Bestand>Opslaan als om het bestand op uw lokale computer op te slaan als azuredeploy.json.

Informatie over het schema

1. Vouw vanuit Visual Studio Code de sjabloon samen naar het hoofdniveau. U hebt de eenvoudigste structuur met de volgende elementen:

   

   • $schema: geef de locatie van het JSON-schemabestand op dat de versie van de sjabloontaal beschrijft.
   • contentVersion: geef een waarde op voor dit element om belangrijke wijzigingen in de sjabloon vast te leggen.
   • metadata: geef de metagegevens van de sjabloon op.
   • parameters: geef de waarden op die worden geleverd wanneer de implementatie wordt uitgevoerd om resource-implementatie aan te passen.
   • variables: geef de waarden op die worden gebruikt als JSON-fragmenten in de sjabloon voor het vereenvoudigen van sjabloontaalexpressies. Deze sjabloon bevat dit element niet.
   • resources: geef de resourcetypen op die worden geïmplementeerd of bijgewerkt in een resourcegroep.
   • outputs: geef de waarden op die worden geretourneerd na de implementatie.

2. Vouw resources uit. Er is een Microsoft.Storage/storageAccounts-resource gedefinieerd. De API-versie die op de schermopname wordt weergegeven, is 2022-09-01. De SKU-naam gebruikt een parameterwaarde. De parameter wordt storageAccountType genoemd.

   

3. Vouw parameters uit om te zien hoe storageAccountType wordt gedefinieerd. De parameter heeft acht toegestane waarden.

Met behulp van de sjabloonreferentie kunt u nagaan of u de nieuwste API-versie gebruikt en of de parameterdefinitie alle toegestane waarden bevat.

De sjabloonverwijzing zoeken

1. Blader naar Azure-sjabloonverwijzing.

2. Voer in het vak Filteren op titelopslagaccounts in en selecteer de eerste opslagaccounts onder Verwijzing naar > opslag.

   

3. Selecteer ARM-sjabloon.

4. Een resourcetype heeft meestal verschillende API-versies. Op deze pagina wordt standaard de meest recente sjabloonschemaversie weergegeven. Selecteer de vervolgkeuzelijst Nieuwste om de versies weer te geven. De nieuwste versie op de schermopname is 2022-09-01. Selecteer Nieuwste of de versie rechts onder Meest recente om de nieuwste versie weer te geven. Zorg ervoor dat deze versie overeenkomt met de versie die wordt gebruikt voor de opslagaccountresource in uw sjabloon. Als u de API-versie bijwerkt, controleert u of de resourcedefinitie overeenkomt met de sjabloonverwijzing.

   

5. Op deze pagina vindt u de details van het resourcetype storageAccount. Het bevat bijvoorbeeld de toegestane waarden voor het object SKU. Er zijn acht SKU's en deze komen overeen met de SKU's die worden vermeld in de quickstart-sjabloon die u eerder hebt geopend.

   

De sjabloon implementeren

1. Meld u aan bij Azure Cloud Shell

2. Kies uw favoriete omgeving door in de linkerbovenhoek PowerShell of Bash (voor CLI) te selecteren. U moet de shell opnieuw starten wanneer u overschakelt.

   

3. Selecteer Upload/download files en selecteer Uploaden. Zie de vorige schermafbeelding. Selecteer het bestand dat u in de vorige sectie hebt opgeslagen. Nadat het bestand is geüpload, kunt u de opdracht ls en de opdracht cat gebruiken om te controleren of het bestand is geüpload.

4. Voer vanuit Cloud Shell de volgende opdrachten uit. Selecteer het tabblad om de PowerShell-code of de CLI-code weer te geven.

   Wanneer u de sjabloon implementeert, geeft u de parameter storageAccountType op met een toegevoegde waarde, bijvoorbeeld Standard_RAGRS. De implementatie mislukt als u de oorspronkelijke quickstart-sjabloon gebruikt, omdat Standard_RAGRS geen toegestane waarde is.

   CLI

   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'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

Resources opschonen

Schoon de geïmplementeerd Azure-resources, wanneer u deze niet meer nodig hebt, op door de resourcegroep te verwijderen.

1. Selecteer Resourcegroep in het linkermenu van Azure Portal.
2. Voer de naam van de resourcegroep in het veld Filter by name in.
3. Selecteer de naam van de resourcegroep. U ziet in totaal zes resources in de resourcegroep.
4. Selecteer Resourcegroep verwijderen in het bovenste menu.

Volgende stappen

In deze zelfstudie hebt u geleerd hoe u met sjabloonverwijzing een bestaande sjabloon kunt aanpassen. Voor informatie over hoe u meerdere exemplaren van een opslagaccount maakt, zie:

Meerdere exemplaren maken