Zelf studie: uw eerste Azure Resource Manager sjabloon maken en implementerenTutorial: Create and deploy your first Azure Resource Manager template

In deze zelf studie leert u Azure Resource Manager sjablonen.This tutorial introduces you to Azure Resource Manager templates. U ziet hoe u een start sjabloon maakt en deze implementeert in Azure.It shows you how to create a starter template and deploy it to Azure. Meer informatie over de structuur van de sjabloon en de hulpprogram ma's die u nodig hebt voor het werken met sjablonen.You'll learn about the structure of the template and the tools you'll need for working with templates. Het duurt ongeveer 12 minuten om deze zelf studie te volt ooien, maar de werkelijke tijd is afhankelijk van het aantal hulpprogram ma's dat u moet installeren.It takes about 12 minutes to complete this tutorial, but the actual time will vary based on how many tools you need to install.

Deze zelf studie is het eerste van een reeks.This tutorial is the first of a series. Tijdens de voortgang van de reeks wijzigt u de stap-voor-stap voor het starten van de sjabloon totdat u alle kern onderdelen van een resource manager-sjabloon hebt bekeken.As you progress through the series, you modify the starting template step-by-step until you've explored all of the core parts of a Resource Manager template. Deze elementen zijn de bouw stenen voor veel complexere sjablonen.These elements are the building blocks for much more complex templates. We hopen dat u aan het einde van de serie bent uw eigen sjablonen te maken en u klaar bent om uw implementaties te automatiseren met sjablonen.We hope by the end of the series you're confident creating your own templates and ready to automate your deployments with templates.

Zie Azure Resource Manager-sjablonenals u meer wilt weten over de voor delen van het gebruik van sjablonen en waarom u de implementatie wilt automatiseren met sjablonen.If you want to learn about the benefits of using templates and why you should automate deployment with templates, see Azure Resource Manager templates.

Als u geen abonnement op Azure hebt, maakt u een gratis account voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

Hulp middelen ophalenGet tools

Laten we beginnen door ervoor te zorgen dat u beschikt over de hulpprogram ma's die u nodig hebt voor het maken en implementeren van sjablonen.Let's start by making sure you have the tools you need to create and deploy templates.

EditorEditor

Sjablonen zijn JSON-bestanden.Templates are JSON files. Als u sjablonen wilt maken, hebt u een goede JSON-editor nodig.To create templates, you need a good JSON editor. We raden Visual Studio code aan met de uitbrei ding Resource Manager-Hulpprogram Ma's.We recommend Visual Studio Code with the Resource Manager Tools extension. Als u deze hulpprogram ma's wilt installeren, raadpleegt u Visual Studio code gebruiken om Azure Resource Manager sjablonen te maken.If you need to install these tools, see Use Visual Studio Code to create Azure Resource Manager templates.

Opdracht regel implementatieCommand-line deployment

U hebt ook een Azure PowerShell of Azure CLI nodig om de sjabloon te implementeren.You also need either Azure PowerShell or Azure CLI to deploy the template. Zie voor de installatie-instructies:For the installation instructions, see:

Nadat u Azure PowerShell of Azure CLI hebt geïnstalleerd, moet u zich voor de eerste keer aanmelden.After installing either Azure PowerShell or Azure CLI, make sure you sign in for the first time. Zie Aanmelden bij Power shell of Aanmelden-Azure clivoor meer informatie.For help, see Sign in - PowerShell or Sign in - Azure CLI.

U bent nu klaar om te beginnen met het leren over sjablonen.Okay, you're ready to start learning about templates.

Uw eerste sjabloon makenCreate your first template

  1. Open Visual Studio code met de uitbrei ding Resource Manager-Hulpprogram Ma's geïnstalleerd.Open Visual Studio Code with the Resource Manager Tools extension installed.

  2. Selecteer in het menu bestand de optie nieuw bestand om een nieuw bestand te maken.From the File menu, select New File to create a new file.

  3. Selecteer in het menu bestand de optie Opslaan als.From the File menu, select Save as.

  4. Geef het bestand de naam azuredeploy en selecteer de extensie van het JSON -bestand.Name the file azuredeploy and select the JSON file extension. De volledige naam van het bestand azuredeploy. json.The complete name of the file azuredeploy.json.

  5. Sla het bestand op uw werk station op.Save the file to your workstation. Selecteer een pad dat u gemakkelijk kunt onthouden omdat u het pad later bij het implementeren van de sjabloon opgeeft.Select a path that is easy to remember because you'll provide that path later when deploying the template.

  6. Kopieer de volgende JSON en plak deze in het bestand:Copy and paste the following JSON into the file:

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

    De VS code-omgeving ziet er als volgt uit:Here's what your VS Code environment looks like:

    Resource Manager-sjabloon Visual Studio code eerste sjabloon

    Met deze sjabloon worden geen resources geïmplementeerd.This template doesn't deploy any resources. 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 probleem wordt geminimaliseerd.We're starting with a blank template so you can get familiar with the steps to deploy a template while minimizing the chance of something going wrong.

    Het JSON-bestand bevat de volgende elementen:The JSON file has these elements:

    • $schema: Hiermee geeft u de locatie van het JSON-schema bestand op.$schema: Specifies the location of the JSON schema file. Het schema bestand beschrijft de eigenschappen die beschikbaar zijn in een sjabloon.The schema file describes the properties that are available within a template. Het schema definieert bijvoorbeeld resources als een van de geldige eigenschappen voor een sjabloon.For example, the schema defines resources as one of the valid properties for a template. U hoeft niet de datum voor het schema 2015-01-01.Don't worry that the date for the schema is 2015-01-01. Deze schema versie is up-to-date en bevat alle nieuwste functies.This schema version is up-to-date and includes all of the latest features. De schema datum is niet gewijzigd omdat er sinds de introductie geen wijzigingen zijn opgegaan.The schema date hasn't been changed because there have been no breaking changes since its introduction.
    • contentVersion: Hiermee geeft u de versie van de sjabloon (bijvoorbeeld 1.0.0.0) op.contentVersion: Specifies the version of the template (such as 1.0.0.0). U kunt een wille keurige waarde voor dit element opgeven.You can provide any value for this element. Gebruik deze waarde als u belang rijke wijzigingen in uw sjabloon wilt documenteren.Use this value to document significant changes in your template. Wanneer u resources implementeert met behulp van de sjabloon, kan deze waarde worden gebruikt om ervoor te zorgen dat de juiste sjabloon wordt gebruikt.When deploying resources using the template, this value can be used to make sure that the right template is being used.
    • resources: bevat de resources die u wilt implementeren of bijwerken.resources: Contains the resources you want to deploy or update. Het is momenteel leeg, maar u voegt later resources toe.Currently, it's empty, but you'll add resources later.
  7. Sla het bestand op.Save the file.

Gefeliciteerd, u hebt uw eerste sjabloon gemaakt.Congratulations, you've created your first template.

Aanmelden bij AzureSign in to Azure

Meld u aan met uw Azure-referenties om aan de slag te gaan met Azure PowerShell/Azure CLI.To start working with Azure PowerShell/Azure CLI, sign in with your Azure credentials.

Connect-AzAccount

Een resourcegroep makenCreate resource group

Wanneer u een sjabloon implementeert, geeft u een resource groep op die de resources zal bevatten.When you deploy a template, you specify a resource group that will contain the resources. Voordat u de implementatie opdracht uitvoert, maakt u de resource groep met behulp van Azure CLI of Azure PowerShell.Before running the deployment command, create the resource group with either Azure CLI or Azure PowerShell. Selecteer de tabbladen in het volgende code gedeelte om te kiezen tussen Azure PowerShell en Azure CLI.Select the tabs in the following code section to choose between Azure PowerShell and Azure CLI. De CLI-voor beelden in dit artikel zijn geschreven voor de bash-shell.The CLI examples in this article are written for the Bash shell.

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

Sjabloon implementerenDeploy template

Als u de sjabloon wilt implementeren, gebruikt u Azure CLI of Azure PowerShell.To deploy the template, use either Azure CLI or Azure PowerShell. Gebruik de resource groep die u hebt gemaakt.Use the resource group you created. Geef een naam op voor de implementatie, zodat u deze gemakkelijk kunt herkennen in de implementatie geschiedenis.Give a name to the deployment so you can easily identify it in the deployment history. Voor het gemak maakt u ook een variabele die het pad naar het sjabloon bestand opslaat.For convenience, also create a variable that stores the path to the template file. Met deze variabele kunt u de implementatie opdrachten eenvoudiger uitvoeren omdat u het pad niet telkens opnieuw hoeft te typen.This variable makes it easier for you to run the deployment commands because you don't have to retype the path every time you deploy.

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

De implementatie opdracht retourneert resultaten.The deployment command returns results. Zoek ProvisioningState om te controleren of de implementatie is geslaagd.Look for ProvisioningState to see whether the deployment succeeded.

Implementatie verifiërenVerify deployment

U kunt de implementatie controleren door de resource groep te verkennen van de Azure Portal.You can verify the deployment by exploring the resource group from the Azure portal.

  1. Meld u aan bij Azure Portal.Sign in to the Azure portal.

  2. Selecteer resource groepenin het menu links.From the left menu, select Resource groups.

  3. Selecteer in de laatste procedure de resource groep implementeren.Select the resource group deploy in the last procedure. De standaard naam is myResourceGroup.The default name is myResourceGroup. U ziet dat er geen resource is geïmplementeerd in de resource groep.You shall see no resource deployed within the resource group.

  4. In de rechter bovenhoek van het overzicht wordt de status van de implementatie weer gegeven.Notice in the upper right of the overview, the status of the deployment is displayed. Selecteer 1 geslaagd.Select 1 Succeeded.

    Implementatie status weer geven

  5. U ziet een overzicht van de implementatie voor de resource groep.You see a history of deployment for the resource group. Selecteer blanktemplate.Select blanktemplate.

    Implementatie selecteren

  6. Er wordt een samen vatting van de implementatie weer gegeven.You see a summary of the deployment. In dit geval is er geen partij om te zien, omdat er geen resources zijn geïmplementeerd.In this case, there's not a lot to see because no resources were deployed. Verderop in deze reeks vindt u het handig om de samen vatting in de implementatie geschiedenis te bekijken.Later in this series you might find it helpful to review the summary in the deployment history. Aan de linkerkant ziet u de invoer, uitvoer en de sjabloon die wordt gebruikt tijdens de implementatie.Notice on the left you can view inputs, outputs, and the template used during deployment.

    Implementatie samenvatting weer geven

Resources opschonenClean up resources

Als u verdergaat met de volgende zelf studie, hoeft u de resource groep niet te verwijderen.If you're moving on to the next tutorial, you don't need to delete the resource group.

Als u nu stopt, wilt u mogelijk de resource groep verwijderen.If you're stopping now, you might want to delete the resource group.

  1. Selecteer Resourcegroep in het linkermenu van Azure Portal.From the Azure portal, select Resource group from the left menu.
  2. Voer de naam van de resourcegroep in het veld Filter by name in.Enter the resource group name in the Filter by name field.
  3. Selecteer de naam van de resourcegroep.Select the resource group name.
  4. Selecteer Resourcegroep verwijderen in het bovenste menu.Select Delete resource group from the top menu.

Volgende stappenNext steps

U hebt een eenvoudige sjabloon gemaakt om te implementeren in Azure.You created a simple template to deploy to Azure. In de volgende zelf studie voegt u een opslag account toe aan de sjabloon en implementeert u deze in uw resource groep.In the next tutorial, you'll add a storage account to the template and deploy it to your resource group.