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 het referentiemateriaal voor sjablonen kunt u de sjabloon aanpassen.

Deze zelfstudie bestaat uit de volgende taken:

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.
   • 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.
   • 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 SKU-naam gebruikt een parameterwaarde. De parameter wordt storageAccountType genoemd.

   

3. Vouw parameters uit om te zien hoe storageAccountType wordt gedefinieerd. De parameter heeft vier toegestane waarden. U vindt de andere toegestane waarden en vervolgens wijzigt u de parameterdefinitie.

   

De sjabloonverwijzing zoeken

1. Blader naar Azure-sjabloonverwijzing.

2. Voer in het vak Filteren op titel opslagaccounts in en selecteer de eerste Opslagaccounts onder Referentie > Opslag.

   

   Een resourceprovider heeft doorgaans diverse API-versies:

   

3. Selecteer Alle resources onder Opslag in het linkerdeelvenster. Op deze pagina worden de resourcetypen en versies van de opslagresourceprovider vermeld. Het is raadzaam om de nieuwste API-versies te gebruiken voor de resourcetypen die zijn gedefinieerd in de sjabloon.

   

4. Selecteer de nieuwste versie van het resourcetype storageAccount. De meest recente versie is 2019-06-01 wanneer dit artikel wordt geschreven. 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 SKU-object. Er zijn meer SKU's dan weergegeven in de quickstart-sjabloon die u eerder hebt geopend. U kunt de quickstart-sjabloon aanpassen zodat alle beschikbare opslagtypen worden toegevoegd.

   

De sjabloon bewerken

Voeg vanuit Visual Studio Code de extra opslagaccounttypen toe, zoals wordt weergegeven in de volgende schermopname:

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
   • PowerShell

   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'
   

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: