Lernprogramm: Erstellen und Bereitstellen Ihrer ersten ARM-Vorlage

In diesem Lernprogramm werden Azure Resource Manager-Vorlagen (ARM-Vorlagen) vorgestellt. Es zeigt Ihnen, wie Sie eine Startvorlage erstellen und in Azure bereitstellen. Sie lernen die Vorlagenstruktur und die Tools kennen, die Sie für die Arbeit mit Vorlagen benötigen. Diese Anweisung dauert 12 Minuten , aber die tatsächliche Endzeit variiert je nach Anzahl der Tools, die Sie installieren müssen.

Dieses Tutorial ist der erste Teil einer Serie. Während Sie die Reihe durchlaufen, ändern Sie die Startvorlage schritt für Schritt, bis Sie alle Kernteile einer ARM-Vorlage erkunden. Diese Elemente sind die Bausteine für komplexere Vorlagen. Wir hoffen, dass Sie am Ende der Reihe zuversichtlich darin sind, Ihre eigenen Vorlagen zu erstellen und bereit, Ihre Bereitstellungen mit Vorlagen zu automatisieren.

Wenn Sie mehr über die Vorteile der Verwendung von Vorlagen erfahren möchten und warum Sie Bereitstellungen mit Vorlagen automatisieren sollten, finden Sie unter ARM-Vorlagenübersicht. Informationen zu ARM-Vorlagen über einen geführten Satz von Learn-Modulen finden Sie unter Bereitstellen und Verwalten von Ressourcen in Azure mithilfe von JSON ARM-Vorlagen.

Wenn Sie nicht über ein Microsoft Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Tools erhalten

Beginnen wir damit, sicherzustellen, dass Sie über die Tools verfügen, die Sie zum Erstellen und Bereitstellen von Vorlagen benötigen. Installieren Sie diese Tools auf Ihrem lokalen Computer.

Editor

Vorlagen sind JSON-Dateien (JavaScript Object Notation). Zum Erstellen von Vorlagen können Sie Visual Studio Code verwenden.

Befehlszeilenbereitstellung

Sie benötigen auch Azure PowerShell oder Azure Command-Line Interface (CLI), um die Vorlage bereitzustellen. Wenn Sie Azure CLI verwenden, müssen Sie über Version 2.37.0 oder höher verfügen. Die Installationsanweisungen finden Sie unter:

• Installieren von Azure PowerShell
• Installieren der Azure CLI unter Windows
• Installieren der Azure CLI unter Linux
• Installieren der Azure CLI unter macOS

Stellen Sie nach der Installation von Azure PowerShell oder Azure CLI sicher, dass Sie sich zum ersten Mal anmelden. Hilfe finden Sie unter Anmelden – PowerShell oder Anmelden – Azure CLI.

Okay, Sie sind bereit, mit dem Erlernen von Vorlagen zu beginnen.

Erstellen Ihrer ersten Vorlage

1. Öffnen Sie Visual Studio Code.

2. Wählen Sie im Menü "Datei " die Option "Neue Datei " aus, um eine neue Datei zu erstellen.

3. Wählen Sie im Menü "Datei " die Option "Speichern unter" aus.

4. Benennen Sie die Datei azuredeploy , und wählen Sie die JSON-Dateierweiterung aus. Der vollständige Name der Datei ist azuredeploy.json.

5. Speichern Sie die Datei auf Ihrer Arbeitsstation. Wählen Sie einen leicht zu merkenden Pfad aus, da Sie diesen Pfad später bereitstellen müssen, wenn Sie die Vorlage bereitstellen.

6. Kopieren Sie den folgenden JSON-Code, und fügen Sie ihn in die Datei ein:

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

   So sieht Ihre Visual Studio Code-Umgebung aus:

   

   Diese Vorlage stellt keine Ressourcen bereit. Wir beginnen mit einer leeren Vorlage, damit Sie sich mit den Schritten zum Bereitstellen einer Vorlage vertraut machen können, während die Wahrscheinlichkeit eines Fehlers minimiert wird.

   Die JSON-Datei enthält die folgenden Elemente:

   • $schema: Gibt den Speicherort der JSON-Schemadatei an. In der Schemadatei werden die Eigenschaften beschrieben, die in einer Vorlage verfügbar sind. Das Schema definiert resources als eine der gültigen Eigenschaften für eine Vorlage. Machen Sie sich keine Sorgen, dass das Datum für das Schema 2019-04-01 lautet. Diese Schemaversion ist auf dem neuesten Stand und enthält alle neuesten Features. Das Schemadatum wurde nicht geändert, da seit seiner Einführung keine Breaking Changes vorgenommen wurden.
   • contentVersion: Gibt die Version der Vorlage an, z. B. 1.0.0.0. Sie können einen beliebigen Wert für dieses Element angeben. Verwenden Sie diesen Wert, um wichtige Änderungen in Ihrer Vorlage zu dokumentieren. Wenn Sie Ressourcen mithilfe der Vorlage bereitstellen, können Sie diesen Wert verwenden, um sicherzustellen, dass Sie die richtige Vorlage verwenden.
   • resources: Enthält die Ressourcen, die Sie bereitstellen oder aktualisieren möchten. Derzeit ist sie leer, aber Sie können später Ressourcen hinzufügen.

7. Speichern Sie die Datei.

Herzlichen Glückwunsch, Sie haben Ihre erste Vorlage erstellt.

Anmelden bei Azure

Um mit der Arbeit mit Azure PowerShell oder Azure CLI zu beginnen, melden Sie sich mit Ihren Azure-Anmeldeinformationen an.

Wählen Sie die Registerkarten in den folgenden Codeabschnitten aus, um zwischen Azure PowerShell und Azure CLI auszuwählen. Die CLI-Beispiele in diesem Artikel werden für die Bash-Shell geschrieben.

Connect-AzAccount

az login

Wenn Sie über mehrere Azure-Abonnements verfügen, wählen Sie das Abonnement aus, das Sie verwenden möchten. Ersetzen Sie SubscriptionName durch den Abonnementnamen. Sie können auch Ihre Abonnement-ID anstelle ihres Abonnementnamens verwenden.

Set-AzContext SubscriptionName

az account set --subscription SubscriptionName

Ressourcengruppe erstellen

Wenn Sie eine Vorlage bereitstellen, können Sie eine Ressourcengruppe angeben, die die Ressourcen enthalten soll. Erstellen Sie vor dem Ausführen des Bereitstellungsbefehls die Ressourcengruppe entweder mit der Bash Azure CLI oder Azure PowerShell.

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

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

Bereitstellen der Vorlage

Verwenden Sie zum Bereitstellen der Vorlage entweder Azure CLI oder Azure PowerShell. Verwenden Sie die von Ihnen erstellte Ressourcengruppe. Geben Sie der Bereitstellung einen Namen, damit Sie sie im Bereitstellungsverlauf leicht identifizieren können. Erstellen Sie aus Gründen der Einfachheit auch eine Variable, die den Pfad zur Vorlagendatei speichert. Diese Variable erleichtert die Ausführung der Bereitstellungsbefehle, da Sie den Pfad nicht jedes Mal erneut eingeben müssen, wenn Sie bereitstellen. Ersetzen Sie {provide-the-path-to-the-template-file} und die geschweiften Klammern {} durch den Pfad zu Ihrer Vorlagendatei.

$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

Der Bereitstellungsbefehl gibt Ergebnisse zurück. Suchen Sie nach ProvisioningState, um zu sehen, ob die Bereitstellung erfolgreich war.

Überprüfen der Bereitstellung

Sie können die Bereitstellung überprüfen, indem Sie die Ressourcengruppe aus dem Azure-Portal erkunden.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie im linken Menü "Ressourcengruppen" aus.

3. Aktivieren Sie das Kontrollkästchen links neben "myResourceGroup ", und wählen Sie "myResourceGroup" aus.

4. Wählen Sie die Ressourcengruppe aus, die Sie im vorherigen Verfahren erstellt haben. Der Standardname ist myResourceGroup. Die Ressourcengruppe verfügt noch nicht über Ressourcen, da Sie eine leere Vorlage bereitgestellt haben.

5. Beachten Sie in der Mitte der Übersicht, im Abschnitt Essentials, dass neben Bereitstellungen der Bereitstellungsstatus angezeigt wird. Wählen Sie 1 Erfolgreich aus.

   

6. Es wird ein Bereitstellungsverlauf für die Ressourcengruppe angezeigt. Aktivieren Sie das Kontrollkästchen links neben "blanktemplate" , und wählen Sie "blanktemplate" aus.

   

7. Sie sehen eine Zusammenfassung der Bereitstellung. In diesem Fall gibt es nicht viel zu sehen, da keine Ressourcen bereitgestellt werden. Das Überprüfen der Zusammenfassung im Bereitstellungsverlauf kann später in dieser Reihe hilfreich sein. Beachten Sie auf der linken Seite die Eingaben, Ausgaben und die während der Bereitstellung verwendete Vorlage, die von der Bereitstellung verwendet wurde.

   

Bereinigen von Ressourcen

Wenn Sie zum nächsten Lernprogramm wechseln, müssen Sie die Ressourcengruppe nicht löschen.

Wenn Sie den Vorgang jetzt beenden, möchten Sie vielleicht die Ressourcengruppe löschen.

1. Wählen Sie im Azure-Portal im linken Menü Ressourcengruppen aus.

2. Geben Sie den Ressourcengruppennamen im Filter für alle Felder... Textfeld ein.

3. Aktivieren Sie das Kontrollkästchen neben "myResourceGroup ", und wählen Sie "myResourceGroup" oder ihren Ressourcengruppennamen aus.

4. Wählen Sie Ressourcengruppe löschen aus dem Menü ganz oben aus.

   

Nächste Schritte

Sie haben eine einfache Vorlage für die Bereitstellung in Azure erstellt. Im nächsten Lernprogramm erfahren Sie, wie Sie der Vorlage ein Speicherkonto hinzufügen und in Ihrer Ressourcengruppe bereitstellen.