Zelfstudie: Uw eerste ARM-sjabloon maken en implementeren

Deze zelfstudie is een introductie tot Azure Resource Manager-sjablonen (ARM-sjablonen). U ziet hoe u een basissjabloon maakt en deze implementeert in Azure. U krijgt informatie over de structuur van de sjabloon en de hulpprogramma’s die u nodig hebt om met sjablonen te werken. Het voltooien van deze zelfstudie kost ongeveer 12 minuten, maar de daadwerkelijke tijd is afhankelijk van hoeveel hulpprogramma’s u moet installeren.

Deze zelfstudie is de eerste van een reeks. Naarmate u vordert in de reeks, past u de basissjabloon stap voor stap aan totdat alle kernonderdelen van een ARM-sjabloon zijn behandeld. Deze elementen zijn de bouwstenen voor veel complexere sjablonen. We hopen dat u aan het einde van de reeks in staat bent uw eigen sjablonen te maken en klaar bent om uw implementaties te automatiseren met sjablonen.

Zie Overzicht van ARM-sjablonen als u meer wilt weten over de voordelen van het gebruik van sjablonen en het automatiseren van implementaties met sjablonen. Raadpleeg Resources implementeren en beheren in Azure met behulp van ARM-sjablonen voor meer informatie over ARM-sjablonen via een begeleide set modules.

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

Hulpprogramma's installeren

Laten we er allereerst voor zorgen dat u de nodige hulpprogramma's hebt om sjablonen te maken en implementeren. Installeer deze tools op uw lokale machine.

Editor

Sjablonen zijn JSON-bestanden. Om sjablonen te maken hebt u een goede JSON-editor nodig. We raden Visual Studio Code met de extensie Resource Manager Tools aan. Als u deze hulpprogramma's wilt installeren, raadpleegt u quickstart: ARM-sjablonen maken met Visual Studio Code.

Implementatie via opdrachtregels

U hebt ook Azure PowerShell of Azure CLI nodig om het sjabloon te implementeren. Als u Azure CLI gebruikt, moet u de nieuwste versie hebben. Zie voor installatie-instructies:

• Azure PowerShell installeren
• Azure CLI installeren in Windows
• Azure CLI installeren in Linux
• Azure CLI installeren in macOS

Nadat u Azure PowerShell of Azure CLI hebt geïnstalleerd moet u zich voor de eerste keer aanmelden. Bekijk Aanmelden - PowerShell of Aanmelden - Azure CLI voor ondersteuning.

U bent nu klaar om te beginnen met het leren over sjablonen.

Uw eerste sjabloon maken

1. Open Visual Studio Code met de extensie Resource Manager Tools geïnstalleerd.

2. Selecteer New File in het menu File om een nieuw project te maken.

3. Selecteer Save As in het menu File.

4. Geef het bestand de naam azuredeploy en selecteer de bestandsextensie JSON. De volledige naam van het bestand is azuredeploy.json.

5. Sla het bestand op uw werkstation op. Selecteer een pad dat u gemakkelijk kunt onthouden, omdat u het pad later bij het implementeren van de sjabloon moet opgeven.

6. Kopieer en plak de volgende JSON in het bestand:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "resources": []
   }
   

   De Visual Studio Code-omgeving ziet er als volgt uit:

   

   Met deze sjabloon worden geen resources geïmplementeerd. We beginnen met een lege sjabloon, zodat u vertrouwd kunt raken met de stappen voor het implementeren van een sjabloon. Dit minimaliseert de kans op fouten.

   Het JSON-bestand bevat de volgende elementen:

   • $schema: Geeft de locatie van het JSON-schemabestand aan. Het schemabestand beschrijft de eigenschappen die beschikbaar zijn in een sjabloon. In het schema zijn bijvoorbeeld resources gedefinieerd als een van de geldige eigenschappen voor een sjabloon. U hoeft zich geen zorgen te maken over dat de datum van het schema 1-4-2019 is. Deze versie van het schema is actueel en bevat alle recente functies. De schemadatum is niet gewijzigd omdat er sinds de introductie geen wijzigingen zijn aangebracht die fouten zouden kunnen veroorzaken.
   • contentVersion: Geeft de versie van de sjabloon aan (bv. 1.0.0.0). U kunt een willekeurige waarde voor dit element opgeven. Gebruik deze waarde als u belangrijke wijzigingen in uw sjabloon wilt documenteren. Wanneer u resources implementeert met de sjabloon, kan deze waarde worden gebruikt om ervoor te zorgen dat de juiste sjabloon wordt gebruikt.
   • resources: Bevat de resources die u wilt implementeren of bijwerken. Dit is momenteel leeg, maar hier voegt u later resources toe.

7. Sla het bestand op.

Gefeliciteerd, u hebt uw eerste sjabloon gemaakt.

Aanmelden bij Azure

Meldt u aan met uw referenties voor Azure PowerShell/Azure CLI om aan de slag te gaan.

Selecteer de tabbladen in de volgende codesecties om te kiezen tussen Azure PowerShell en Azure CLI. De CLI-voorbeelden in dit artikel zijn geschreven voor de Bash-shell.

Connect-AzAccount

az login

Als u meerdere Azure-abonnementen hebt, selecteert u het abonnement dat u wilt gebruiken. Vervang SubscriptionName door de naam van uw abonnement. U kunt ook de abonnements-id gebruiken in plaats van de naam van het abonnement.

Set-AzContext SubscriptionName

az account set --subscription SubscriptionName

Een resourcegroep maken

Wanneer u een sjabloon implementeert, geeft u een resourcegroep op die de resources zal bevatten. Voordat u de opdracht voor de implementatie uitvoert, maakt u de resourcegroep met behulp van Azure CLI of Azure PowerShell.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

az group create \
  --name myResourceGroup \
  --location "Central US"

Sjabloon implementeren

U kunt Azure PowerShell of Azure CLI gebruiken om het sjabloon te implementeren. Gebruik de resourcegroep die u hebt gemaakt. Geef de implementatie een naam zodat u deze gemakkelijk kunt herkennen in de implementatiegeschiedenis. Maak voor het gemak ook een variabele waarin u het pad naar het sjabloonbestand opslaat. Met deze variabele kunt u de implementatieopdrachten eenvoudiger uitvoeren omdat u het pad niet telkens opnieuw hoeft te typen. Vervang {provide-the-path-to-the-template-file} en de accolades {} door het pad naar het sjabloonbestand.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

templateFile="{provide-the-path-to-the-template-file}"
az deployment group create \
  --name blanktemplate \
  --resource-group myResourceGroup \
  --template-file $templateFile

De implementatieopdracht retourneert resultaten. Zoek naar ProvisioningState om te controleren of de implementatie is geslaagd.

Implementatie verifiëren

U kunt de implementatie controleren door de resourcegroep te bekijken vanuit de Azure Portal.

1. Meld u aan bij de Azure-portal.

2. Selecteer Resourcegroepen in het linkermenu.

3. Selecteer de resourcegroep die in de laatste procedure is geïmplementeerd. De standaardnaam is myResourceGroup. U ziet dat er geen resource is geïmplementeerd in de resourcegroep.

4. In de rechterbovenhoek van het overzicht wordt de status van de implementatie weergegeven. Selecteer 1 Geslaagd.

   

5. U ziet nu de geschiedenis van de implementaties voor de resourcegroep. Selecteer blanktemplate.

   

6. Er wordt een samenvatting van de implementatie weergegeven. In dit geval is er niet veel te zien, omdat er geen resources zijn geïmplementeerd. Later in deze reeks kan het handig zijn om de samenvatting in de implementatiegeschiedenis te bekijken. Aan de linkerkant ziet u de invoer, uitvoer en de sjabloon die is gebruikt voor de implementatie.

   

Resources opschonen

Als u verdergaat met de volgende zelfstudie, hoeft u de resourcegroep niet te verwijderen.

Als u nu stopt, wilt u de resourcegroep mogelijk 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.
4. Selecteer Resourcegroep verwijderen in het bovenste menu.

Volgende stappen

U hebt een eenvoudige sjabloon voor een implementatie naar Azure gemaakt. In de volgende zelfstudie voegt u een opslagaccount toe aan de sjabloon en implementeert u het in uw resourcegroep.