Zelfstudie: Uw eerste ARM-sjabloon maken en implementeren

In deze zelfstudie maakt u kennis met Azure Resource Manager-sjablonen (ARM-sjablonen). U ziet hoe u een starterssjabloon maakt en implementeert in Azure. U leert over de sjabloonstructuur en de hulpprogramma's die u nodig hebt om met sjablonen te werken. Deze instructie duurt 12 minuten , maar de werkelijke eindtijd varieert op basis van het aantal hulpprogramma's dat u moet installeren.

Deze tutorial is de eerste van een reeks. Tijdens het doorlopen van de reeks wijzigt u de beginsjabloon, stap voor stap, totdat u alle kernonderdelen van een ARM-sjabloon verkent. Deze elementen zijn de bouwstenen voor complexere sjablonen. We hopen dat u aan het einde van de reeks uw eigen sjablonen kunt maken en klaar bent om uw implementaties te automatiseren met sjablonen.

Als u meer wilt weten over de voordelen van het gebruik van sjablonen en waarom u implementaties met sjablonen moet automatiseren, raadpleegt u het overzicht van ARM-sjablonen. Zie Resources implementeren en beheren in Azure met behulp van JSON ARM-sjablonen voor meer informatie over ARM-sjablonen via een begeleide set Learn-modules.

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

Hulpprogramma's ophalen

Laten we beginnen met het controleren of u over de hulpprogramma's beschikt die u nodig hebt om sjablonen te maken en te implementeren. Installeer deze hulpprogramma's op uw lokale computer.

Editor

Sjablonen zijn JSON-bestanden (JavaScript Object Notation). Als u sjablonen wilt maken, kunt u Visual Studio Code gebruiken.

Implementatie via de opdrachtregel

U hebt ook Azure PowerShell of Azure Command-Line Interface (CLI) nodig om de sjabloon te implementeren. Als u Azure CLI gebruikt, moet u versie 2.37.0 of hoger 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 de eerste keer aanmelden. Zie Aanmelden - PowerShell of Aanmelden - Azure CLI voor hulp.

Oké, u kunt beginnen met het leren over sjablonen.

Uw eerste sjabloon maken

1. Open Visual Studio Code.

2. Selecteer nieuw bestand in het menu Bestand om een nieuw bestand te maken.

3. Selecteer Opslaan als in het menu Bestand.

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

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

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": []
   }
   

   Uw 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, terwijl de kans op een fout wordt geminimaliseerd.

   Het JSON-bestand bevat de volgende elementen:

   • $schema: Hiermee geeft u de locatie van het JSON-schemabestand. In het schemabestand worden de eigenschappen beschreven die beschikbaar zijn in een sjabloon. Het schema definieert resources bijvoorbeeld als een van de geldige eigenschappen voor een sjabloon. U hoeft zich geen zorgen te maken dat de datum voor het schema 2019-04-01 is. Deze schemaversie is up-to-date en bevat alle nieuwste functies. De schemadatum is niet gewijzigd omdat er sinds de introductie geen belangrijke wijzigingen zijn aangebracht.
   • contentVersion: Hiermee geeft u de versie van de sjabloon op, zoals 1.0.0.0. U kunt elke waarde voor dit element opgeven. Gebruik deze waarde om belangrijke wijzigingen in uw sjabloon te documenteren. Wanneer u resources implementeert met behulp van de sjabloon, kunt u deze waarde gebruiken om ervoor te zorgen dat u de juiste sjabloon gebruikt.
   • resources: bevat de resources die u wilt implementeren of bijwerken. Op dit moment is deze leeg, maar u kunt later resources toevoegen.

7. Sla het bestand op.

Gefeliciteerd, u hebt uw eerste sjabloon gemaakt.

Aanmelden bij Azure

Meld u aan met uw Azure-referenties om aan de slag te gaan met Azure PowerShell of Azure CLI.

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, kiest u het abonnement dat u wilt gebruiken. Vervang door SubscriptionName de naam van uw abonnement. U kunt ook uw abonnements-id gebruiken in plaats van uw abonnementsnaam.

Set-AzContext SubscriptionName

az account set --subscription SubscriptionName

Resourcegroep aanmaken

Wanneer u een sjabloon implementeert, kunt u een resourcegroep opgeven die de resources bevat. Voordat u de implementatieopdracht uitvoert, maakt u de resourcegroep met de Bash Azure CLI of Azure PowerShell.

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

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

Sjabloon implementeren

Als u de sjabloon wilt implementeren, gebruikt u Azure CLI of Azure PowerShell. Gebruik de resourcegroep die u hebt gemaakt. Geef een naam aan de implementatie, zodat u deze eenvoudig kunt herkennen in de implementatiegeschiedenis. Maak voor het gemak ook een variabele waarmee het pad naar het sjabloonbestand wordt opgeslagen. Met deze variabele kunt u de implementatieopdrachten gemakkelijker uitvoeren, omdat u het pad niet telkens opnieuw hoeft te typen wanneer u implementeert. Vervang {provide-the-path-to-the-template-file} en de accolades {} met het pad naar uw 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 zien of de implementatie is geslaagd.

Implementatie verifiëren

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

1. Meld u aan bij het Azure-portaal.

2. Selecteer resourcegroepen in het linkermenu.

3. Schakel het selectievakje links van myResourceGroup in en selecteer myResourceGroup.

4. Selecteer de resourcegroep die u in de eerdere procedure hebt gemaakt. De standaardnaam is myResourceGroup. De resourcegroep heeft nog geen resources omdat u een lege sjabloon hebt geïmplementeerd.

5. In het midden van het overzicht, in de sectie Essentials, wordt de implementatiestatus naast Implementaties op de pagina weergegeven. Selecteer 1 Geslaagd.

   

6. U ziet een geschiedenis van implementaties voor de resourcegroep. Schakel het selectievakje links van blanktemplate in en selecteer blanktemplate.

   

7. U ziet een samenvatting van de implementatie. In dit geval is er niet veel te zien omdat er geen middelen zijn ingezet. Verderop in deze reeks is het handig om de samenvatting in de implementatiegeschiedenis te bekijken. U ziet aan de linkerkant invoer, uitvoer en de sjabloon die door de implementatie wordt gebruikt.

   

De hulpbronnen opschonen

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

Als u nu stopt, wilt u misschien de resourcegroep verwijderen.

1. Vanuit het Azure Portal, selecteer Resourcegroepen van het linkermenu.

2. Typ de naam van de resourcegroep in het veld Filteren voor een veld... tekstveld.

3. Schakel het selectievakje naast myResourceGroup in en selecteer myResourceGroup of de naam van uw resourcegroep.

4. Selecteer Resourcegroep verwijderen in het bovenste menu.

   

Volgende stappen

U hebt een eenvoudige sjabloon gemaakt om te implementeren in Azure. In de volgende zelfstudie leert u hoe u een opslagaccount aan de sjabloon toevoegt en implementeert in uw resourcegroep.