Lernprogramm: Exportieren und Verwenden von Azure-Portalvorlagen

In dieser Lernprogrammreihe erstellen Sie eine Vorlage zum Bereitstellen eines Azure-Speicherkontos. In den nächsten beiden Lernprogrammen fügen Sie einen App Service-Plan und eine Website hinzu. Anstatt Vorlagen von Grund auf neu zu erstellen, erfahren Sie, wie Sie Vorlagen aus dem Azure-Portal exportieren und Wie Sie Beispielvorlagen aus den Azure-Schnellstartvorlagen verwenden. Sie passen diese Vorlagen für Ihre Verwendung an. Dieses Lernprogramm konzentriert sich auf das Exportieren von Vorlagen und das Anpassen des Ergebnisses für Ihre Vorlage. Diese Anweisung dauert 14 Minuten bis zum Abschluss.

Voraussetzungen

Wir empfehlen, das Tutorial zu Ausgaben durchzuführen. Dies ist jedoch keine Voraussetzung.

Sie benötigen Visual Studio Code und entweder Azure PowerShell oder azure CLI. Weitere Informationen finden Sie unter Vorlagentools.

Vorlage überprüfen

Am Ende des vorherigen Lernprogramms hatte Ihre Vorlage die folgende JSON-Datei:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Diese Vorlage eignet sich gut für die Bereitstellung von Speicherkonten, aber Sie möchten möglicherweise weitere Ressourcen hinzufügen. Sie können eine Vorlage aus einer vorhandenen Ressource exportieren, um den JSON-Code für diese Ressource schnell abzurufen.

App Service-Plan erstellen

Melden Sie sich beim Azure-Portal an.
Klicken Sie auf Ressource erstellen.
Geben Sie in Suchdienste und Marketplaceden App-Serviceplan ein, und wählen Sie dann "App Service Plan" aus.
Wählen Sie "Erstellen" aus.
Geben Sie auf der Seite " App Service Plan erstellen " Folgendes ein:
- Abonnement: Wählen Sie Ihr Azure-Abonnement im Dropdownmenü aus.
- Ressourcengruppe: Wählen Sie "Neu erstellen" aus, und geben Sie dann einen Namen an. Geben Sie einen anderen Ressourcengruppennamen als den Namen an, den Sie in dieser Lernprogrammreihe verwendet haben.
- Name: Geben Sie einen Namen für den App Service Plan ein.
- Betriebssystem: Wählen Sie Linux aus.
- Region: Wählen Sie im Dropdownmenü einen Azure-Speicherort aus, z. B. "Zentral-USA".
- Preisstufe: Um Kosten zu sparen, wählen Sie " Größe ändern" aus, um die SKU und die Größe in "First Basic (B1)" unter "Dev/Test " für weniger anspruchsvolle Workloads zu ändern.
Klicken Sie auf Überprüfen und erstellen.
Wählen Sie "Erstellen" aus. Es dauert ein paar Augenblicke, um die Ressource zu erstellen.

Exportieren der Vorlage

Wählen Sie Zur Ressourcewechseln.
Wählen Sie im linken Menü unter "Automatisierung" die Option "Vorlage exportieren" aus.

Das Feature "Vorlage exportieren" übernimmt den aktuellen Status einer Ressource und generiert eine Vorlage, um sie bereitzustellen. Das Exportieren einer Vorlage kann eine hilfreiche Möglichkeit sein, schnell den JSON-Code zu erhalten, den Sie zum Bereitstellen einer Ressource benötigen.
Sehen Sie sich die Microsoft.Web/serverfarms Definition und die Parameterdefinition in der exportierten Vorlage an. Sie müssen diese Abschnitte nicht kopieren. Sie können diese exportierte Vorlage einfach als Beispiel dafür verwenden, wie Sie diese Ressource ihrer Vorlage hinzufügen möchten.

Von Bedeutung

Normalerweise ist die exportierte Vorlage ausführlicher, als Sie es beim Erstellen einer Vorlage möglicherweise wünschen würden. Das SKU-Objekt beispielsweise in der exportierten Vorlage verfügt über fünf Eigenschaften. Diese Vorlage funktioniert, Aber Sie können die name Eigenschaft einfach verwenden. Sie können mit der exportierten Vorlage beginnen und sie dann so ändern, wie Sie ihren Anforderungen entsprechen.

Vorhandene Vorlage überarbeiten

Die exportierte Vorlage bietet Ihnen den größten Teil des benötigten JSON-Codes, aber Sie müssen sie für Ihre Vorlage anpassen. Achten Sie besonders auf die Unterschiede bei Parametern und Variablen zwischen der Vorlage und der exportierten Vorlage. Offensichtlich kennt der Exportvorgang nicht die Parameter und Variablen, die Sie bereits in Ihrer Vorlage definiert haben.

Das folgende Beispiel zeigt die Ergänzungen zu Ihrer Vorlage. Er enthält den exportierten Code sowie einige Änderungen. Zuerst wird der Name des Parameters entsprechend Ihrer Benennungskonvention geändert. Zweitens wird Ihr Standortparameter für den Standort des App-Serviceplans verwendet. Drittens werden einige der Eigenschaften entfernt, bei denen der Standardwert einwandfrei ist.

Kopieren Sie die gesamte Datei, und ersetzen Sie die Vorlage durch den Inhalt:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Bereitstellen der Vorlage

Verwenden Sie die Azure CLI oder Azure PowerShell, um eine Vorlage bereitzustellen.

Wenn Sie die Ressourcengruppe nicht erstellt haben, lesen Sie " Erstellen einer Ressourcengruppe". Im Beispiel wird davon ausgegangen, dass Sie die templateFile Variable auf den Pfad zur Vorlagendatei festgelegt haben, wie im ersten Tutorial gezeigt.

Azure PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addappserviceplan `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Um diesen Bereitstellungsbefehl auszuführen, müssen Sie über die neueste Version der Azure CLI verfügen.

az deployment group create \
  --name addappserviceplan \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Hinweis

Wenn die Bereitstellung fehlschlägt, verwenden Sie den verbose Switch, um Informationen zu den Ressourcen abzurufen, die Sie erstellen. Verwenden Sie die debug Option, um weitere Informationen zum Debuggen zu erhalten.

Überprüfen der Bereitstellung

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

Melden Sie sich beim Azure-Portal an.
Wählen Sie im linken Menü "Ressourcengruppen" aus.
Wählen Sie die Ressourcengruppe aus, in der Sie die Vorlage bereitgestellt haben.
Die Ressourcengruppe enthält ein Speicherkonto und einen App Service Plan.

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.

Wählen Sie im Azure-Portal im linken Menü Ressourcengruppen aus.
Geben Sie den Ressourcengruppennamen im Filter für alle Felder... Textfeld ein.
Aktivieren Sie das Kontrollkästchen neben "myResourceGroup ", und wählen Sie "myResourceGroup" oder ihren Ressourcengruppennamen aus.
Wählen Sie Ressourcengruppe löschen aus dem Menü ganz oben aus.

Nächste Schritte

Sie haben gelernt, wie Sie eine Vorlage aus dem Azure-Portal exportieren und wie Sie die exportierte Vorlage für die Vorlagenentwicklung verwenden. Sie können auch die Azure-Schnellstartvorlagen verwenden, um die Vorlagenentwicklung zu vereinfachen.

Verwenden von Azure-Schnellstartvorlagen

Feedback

War diese Seite hilfreich?

Last updated on 2025-10-30