Schnellstart: Erstellen und Bereitstellen von Vorlagenspezifikationen

Dieser Schnellstart zeigt Ihnen, wie Sie eine Azure Resource Manager-Vorlage (ARM-Vorlage) in eine Vorlagenspezifikation packen. Anschließend stellen Sie diese Vorlagenspezifikation bereit. Ihre Vorlagenspezifikation enthält eine ARM-Vorlage, mit der ein Speicherkonto bereitgestellt wird.

Tipp

Wir empfehlen Bicep, weil es dieselben Funktionen wie ARM-Vorlagen bietet und die Syntax einfacher zu verwenden ist. Weitere Informationen finden Sie unter Schnellstart: Erstellen und Bereitstellen einer Vorlagenspezifikation mit Bicep.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.

Hinweis

Um Vorlagenspezifikationen mit Azure PowerShell zu verwenden, müssen Sie mindestens Version 5.0.0 installieren. Zur Verwendung mit der Azure CLI verwenden Sie mindestens Version 2.14.2.

Erstellen der Vorlage

Sie erstellen eine Vorlagenspezifikation aus einer lokalen Vorlage. Kopieren Sie die folgende Vorlage, und speichern Sie sie lokal in einer Datei namens azuredeploy.json. In dieser Schnellstartanleitung wird davon ausgegangen, dass die Speicherung im Pfad c:\Templates\azuredeploy.json erfolgt ist, aber Sie können einen beliebigen Pfad verwenden.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.13.1.58284",
      "templateHash": "13120038605368246703"
    }
  },
  "parameters": {
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GRS",
        "Standard_GZRS",
        "Standard_LRS",
        "Standard_RAGRS",
        "Standard_RAGZRS",
        "Standard_ZRS"
      ],
      "metadata": {
        "description": "Storage Account type"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "The storage account location."
      }
    },
    "storageAccountName": {
      "type": "string",
      "defaultValue": "[format('store{0}', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "The name of the storage account"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2022-09-01",
      "name": "[parameters('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageAccountType')]"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "storageAccountName": {
      "type": "string",
      "value": "[parameters('storageAccountName')]"
    },
    "storageAccountId": {
      "type": "string",
      "value": "[resourceId('Microsoft.Storage/storageAccounts', parameters('storageAccountName'))]"
    }
  }
}

Erstellen von Vorlagenspezifikationen

Die Vorlagenspezifikation ist ein Ressourcentyp namens Microsoft.Resources/templateSpecs. Verwenden Sie zum Erstellen einer Vorlagenspezifikation PowerShell, die Azure CLI, das Portal oder eine ARM-Vorlage.

PowerShell

1. Erstellen Sie eine neue Ressourcengruppe, die die Vorlagenspezifikation enthält.

   New-AzResourceGroup `
     -Name templateSpecRG `
     -Location westus2
   

2. Erstellen Sie die Vorlagenspezifikation in dieser Ressourcengruppe. Weisen Sie der neuen Vorlagenspezifikation den Namen storageSpec zu.

   New-AzTemplateSpec `
     -Name storageSpec `
     -Version "1.0" `
     -ResourceGroupName templateSpecRG `
     -Location westus2 `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

1. Erstellen Sie eine neue Ressourcengruppe, die die Vorlagenspezifikation enthält.

   az group create \
     --name templateSpecRG \
     --location westus2
   

2. Erstellen Sie die Vorlagenspezifikation in dieser Ressourcengruppe. Weisen Sie der neuen Vorlagenspezifikation den Namen storageSpec zu.

   az ts create \
     --name storageSpec \
     --version "1.0" \
     --resource-group templateSpecRG \
     --location "westus2" \
     --template-file "c:\Templates\azuredeploy.json"
   

Portal

1. Melden Sie sich am Azure-Portal an.

2. Suchen Sie nach Vorlagenspezifikationen. Wählen Sie Vorlagenspezifikationen den verfügbaren Optionen aus.

   

3. Wählen Sie Vorlage importieren aus.

   

4. Wählen Sie das Ordnersymbol aus.

   

5. Navigieren Sie zur lokalen Vorlage, die Sie gespeichert haben, und wählen Sie diese aus. Klicken Sie auf Öffnen.

6. Wählen Sie Importieren aus.

   

7. Geben Sie außerdem die folgenden Werte an:

   • Name: Geben Sie einen Namen für die Vorlagenspezifikation ein, z. B. storageSpec.
   • Abonnement: Wählen Sie ein Azure-Abonnement für die Erstellung der Vorlagenspezifikation aus.
   • Ressourcengruppe: Wählen Sie Neu erstellen aus, und geben Sie einen neuen Ressourcengruppennamen ein. Beispiel: templateSpecRG
   • Standort: Wählen Sie einen Standort für die Ressourcengruppe aus. Beispiel: USA, Westen 2.
   • Version: Geben Sie eine Version für die Vorlagenspezifikation ein. Verwenden Sie 1.0.

8. Klicken Sie auf Überprüfen + erstellen.

9. Klicken Sie auf Erstellen.

ARM-Vorlage

Hinweis

Anstatt eine ARM-Vorlage zu verwenden, wird empfohlen, dass Sie PowerShell oder die CLI verwenden, um Ihre Vorlagenspezifikation zu erstellen. Diese Tools konvertieren verknüpfte Vorlagen automatisch in Artefakte, die mit ihrer Hauptvorlage verbunden sind. Wenn Sie eine ARM-Vorlage zum Erstellen der Vorlagenspezifikation verwenden, müssen Sie diese verknüpften Vorlagen manuell als Artefakte hinzufügen. Dies kann kompliziert sein.

1. Wenn Sie eine ARM-Vorlage zum Erstellen der Vorlagenspezifikation verwenden, wird die Vorlage in die Ressourcendefinition eingebettet. An Ihrer lokalen Vorlage müssen einige Änderungen vorgenommen werden. Kopieren Sie die folgende Vorlage, und speichern Sie sie lokal als azuredeploy.json.

   Hinweis

   In der eingebetteten Vorlage müssen alle Vorlagenausdrücke eine zweite linke eckige Klammer als Escapezeichen verwenden. Verwenden Sie "[[ anstelle von "[. JSON-Arrays verwenden weiterhin eine einzelne linke eckige Klammer.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/templateSpecs",
         "apiVersion": "2021-05-01",
         "name": "storageSpec",
         "location": "westus2",
         "properties": {
           "displayName": "Storage template spec"
         },
         "tags": {},
         "resources": [
           {
             "type": "versions",
             "apiVersion": "2021-05-01",
             "name": "1.0",
             "location": "westus2",
             "dependsOn": [ "storageSpec" ],
             "properties": {
               "mainTemplate": {
                 "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
                 "contentVersion": "1.0.0.0",
                 "parameters": {
                   "storageAccountType": {
                     "type": "string",
                     "defaultValue": "Standard_LRS",
                     "allowedValues": [
                       "Standard_LRS",
                       "Standard_GRS",
                       "Standard_ZRS",
                       "Premium_LRS"
                     ],
                     "metadata": {
                       "description": "Storage Account type"
                     }
                   },
                   "location": {
                     "type": "string",
                     "defaultValue": "[[resourceGroup().location]",
                     "metadata": {
                       "description": "Location for all resources."
                     }
                   }
                 },
                 "variables": {
                   "storageAccountName": "[[concat('store', uniquestring(resourceGroup().id))]"
                 },
                 "resources": [
                   {
                     "type": "Microsoft.Storage/storageAccounts",
                     "apiVersion": "2022-09-01",
                     "name": "[[variables('storageAccountName')]",
                     "location": "[[parameters('location')]",
                     "sku": {
                       "name": "[[parameters('storageAccountType')]"
                     },
                     "kind": "StorageV2",
                     "properties": {}
                   }
                 ],
                 "outputs": {
                   "storageAccountName": {
                     "type": "string",
                     "value": "[[variables('storageAccountName')]"
                   }
                 }
               }
             },
             "tags": {}
           }
         ]
       }
     ],
     "outputs": {}
   }
   

2. Verwenden Sie die Azure CLI oder PowerShell, um eine neue Ressourcengruppe zu erstellen.

   New-AzResourceGroup `
     -Name templateSpecRG `
     -Location westus2
   

   az group create \
     --name templateSpecRG \
     --location westus2
   

3. Stellen Sie Ihre Vorlage mit der Azure CLI oder mit PowerShell bereit.

   New-AzResourceGroupDeployment `
     -ResourceGroupName templateSpecRG `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

   az deployment group create \
     --resource-group templateSpecRG \
     --template-file "c:\Templates\azuredeploy.json"
   

Bereitstellen der Vorlagenspezifikationen

Verwenden Sie zum Bereitstellen einer Vorlagenspezifikation dieselben Bereitstellungsbefehle wie zum Bereitstellen einer Vorlage. Übergeben Sie die Ressourcen-ID der bereitzustellenden Vorlagenspezifikation.

PowerShell

1. Erstellen Sie eine Ressourcengruppe, die das neue Speicherkonto enthält.

   New-AzResourceGroup `
     -Name storageRG `
     -Location westus2
   

2. Rufen Sie die Ressourcen-ID der Vorlagenspezifikation ab.

   $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id
   

3. Stellen Sie die Vorlagenspezifikation bereit.

   New-AzResourceGroupDeployment `
     -TemplateSpecId $id `
     -ResourceGroupName storageRG
   

4. Sie geben die Parameter genau wie bei einer ARM-Vorlage an. Stellen Sie die Vorlagenspezifikation mit einem Parameter für den Speicherkontotyp erneut bereit.

   New-AzResourceGroupDeployment `
     -TemplateSpecId $id `
     -ResourceGroupName storageRG `
     -storageAccountType Standard_GRS
   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

1. Erstellen Sie eine Ressourcengruppe, die das neue Speicherkonto enthält.

   az group create \
     --name storageRG \
     --location westus2
   

2. Rufen Sie die Ressourcen-ID der Vorlagenspezifikation ab.

   id=$(az ts show --name storageSpec --resource-group templateSpecRG --version "1.0" --query "id")
   

   Hinweis

   Es gibt ein bekanntes Problem beim Abrufen der Vorlagenspezifikations-ID und deren Zuweisung zu einer Variablen in Windows PowerShell.

3. Stellen Sie die Vorlagenspezifikation bereit.

   az deployment group create \
     --resource-group storageRG \
     --template-spec $id
   

4. Sie geben die Parameter genau wie bei einer ARM-Vorlage an. Stellen Sie die Vorlagenspezifikation mit einem Parameter für den Speicherkontotyp erneut bereit.

   az deployment group create \
     --resource-group storageRG \
     --template-spec $id \
     --parameters storageAccountType='Standard_GRS'
   

Portal

1. Wählen Sie die von Ihnen erstellte Vorlagenspezifikation.

   

2. Klicken Sie auf Bereitstellen.

   

3. Geben Sie außerdem die folgenden Werte an:

   • Abonnement: Wählen Sie ein Azure-Abonnement für die Ressourcenerstellung aus.
   • Ressourcengruppe: Wählen Sie Neu erstellen aus, und geben Sie storageRG ein.
   • Speicherkontotyp: Wählen Sie Standard_GRS aus.

4. Klicken Sie auf Überprüfen + erstellen.

5. Klicken Sie auf Erstellen.

ARM-Vorlage

1. Kopieren Sie die folgende Vorlage, und speichern Sie sie lokal in einer Datei namens storage.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/deployments",
         "apiVersion": "2021-04-01",
         "name": "demo",
         "properties": {
           "templateLink": {
             "id": "[resourceId('templateSpecRG', 'Microsoft.Resources/templateSpecs/versions', 'storageSpec', '1.0')]"
           },
           "parameters": {
           },
           "mode": "Incremental"
         }
       }
     ],
     "outputs": {}
   }
   

2. Verwenden Sie die Azure CLI oder PowerShell, um eine neue Ressourcengruppe für das Speicherkonto zu erstellen.

   New-AzResourceGroup `
     -Name storageRG `
     -Location westus2
   

   az group create \
     --name storageRG \
     --location westus2
   

3. Stellen Sie Ihre Vorlage mit der Azure CLI oder mit PowerShell bereit.

   New-AzResourceGroupDeployment `
     -ResourceGroupName storageRG `
     -TemplateFile "c:\Templates\storage.json"
   

   az deployment group create \
     --resource-group storageRG \
     --template-file "c:\Templates\storage.json"
   

Gewähren von Zugriff

Wenn Sie anderen Benutzern in Ihrer Organisation die Bereitstellung Ihrer Vorlagenspezifikation gestatten möchten, müssen Sie ihnen Lesezugriff gewähren. Sie können die Rolle „Leser“ einer Microsoft Entra-Gruppe für die Ressourcengruppe zuweisen, die freizugebende Vorlagenspezifikationen enthält. Weitere Informationen finden Sie im Tutorial: Gewähren des Zugriffs auf Azure-Ressourcen für eine Gruppe mithilfe von Azure PowerShell.

Aktualisieren der Vorlage

Angenommen, Sie haben eine Änderung identifiziert, die Sie an der Vorlage in Ihrer Vorlagenspezifikation vornehmen möchten. Die folgende Vorlage ähnelt Ihrer früheren Vorlage, mit der Ausnahme, dass sie ein Präfix für den Speicherkontonamen hinzufügt. Kopieren Sie die folgende Vorlage, und aktualisieren Sie die Datei „azuredeploy.json“.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_ZRS",
        "Premium_LRS"
      ],
      "metadata": {
        "description": "Storage Account type"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "namePrefix": {
      "type": "string",
      "maxLength": 11,
      "defaultValue": "store",
      "metadata": {
        "description": "Prefix for storage account name"
      }
    }
  },
  "variables": {
    "storageAccountName": "[concat(parameters('namePrefix'), uniquestring(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageAccountType')]"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "storageAccountName": {
      "type": "string",
      "value": "[variables('storageAccountName')]"
    }
  }
}

Aktualisieren der Vorlagenspezifikationsversion

Anstatt eine neue Vorlagenspezifikation für die überarbeitete Vorlage zu erstellen, fügen Sie der vorhandenen Vorlagenspezifikation eine neue Version mit dem Namen 2.0 hinzu. Benutzer können eine beliebige bereitzustellende Version auswählen.

PowerShell

1. Erstellen Sie eine neue Version der Vorlagenspezifikation.

   New-AzTemplateSpec `
     -Name storageSpec `
     -Version "2.0" `
     -ResourceGroupName templateSpecRG `
     -Location westus2 `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

2. Um die neue Version bereitzustellen, müssen Sie die Ressourcen-ID für die 2.0-Version abrufen.

   $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id
   

3. Stellen Sie diese Version bereit. Geben Sie ein Präfix für den Namen des Speicherkontos an.

   New-AzResourceGroupDeployment `
     -TemplateSpecId $id `
     -ResourceGroupName storageRG `
     -namePrefix "demoaccount"
   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

1. Erstellen Sie eine neue Version der Vorlagenspezifikation.

   az ts create \
     --name storageSpec \
     --version "2.0" \
     --resource-group templateSpecRG \
     --location "westus2" \
     --template-file "c:\Templates\azuredeploy.json"
   

2. Um die neue Version bereitzustellen, müssen Sie die Ressourcen-ID für die 2.0-Version abrufen.

   id=$(az ts show --name storageSpec --resource-group templateSpecRG --version "2.0" --query "id")
   

3. Stellen Sie diese Version bereit. Geben Sie ein Präfix für den Namen des Speicherkontos an.

   az deployment group create \
      --resource-group storageRG \
      --template-spec $id \
      --parameters namePrefix='demoaccount'
   

Portal

1. Wählen Sie in der Vorlagenspezifikation Neue Version erstellen aus.

   

2. Nennen Sie die neue Version 2.0, und fügen Sie optional Notizen hinzu. Wählen Sie Vorlage bearbeiten aus.

   

3. Ersetzen Sie den Inhalt der Vorlage durch die aktualisierte Vorlage. Klicken Sie auf Überprüfen und speichern.

4. Klicken Sie auf Save changes (Änderungen speichern).

5. Wählen Sie Versionen aus, um die neue Version bereitzustellen.

   

6. Wählen Sie für die Version, die Sie bereitstellen möchten, die drei Punkte und dann Bereitstellen aus.

   

7. Füllen Sie die Felder wie bei der Bereitstellung der früheren Version aus.

8. Klicken Sie auf Überprüfen + erstellen.

9. Klicken Sie auf Erstellen.

ARM-Vorlage

1. Auch hier müssen Sie einige Änderungen an der lokalen Vorlage vornehmen, damit Sie mit Vorlagenspezifikationen funktioniert. Kopieren Sie die folgende Vorlage, und speichern Sie sie lokal als azuredeploy.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/templateSpecs",
         "apiVersion": "2021-05-01",
         "name": "storageSpec",
         "location": "westus2",
         "properties": {
           "displayName": "Storage template spec"
         },
         "tags": {},
         "resources": [
           {
             "type": "versions",
             "apiVersion": "2021-05-01",
             "name": "2.0",
             "location": "westus2",
             "dependsOn": [ "storageSpec" ],
             "properties": {
               "mainTemplate": {
                 "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
                 "contentVersion": "1.0.0.0",
                 "parameters": {
                   "storageAccountType": {
                     "type": "string",
                     "defaultValue": "Standard_LRS",
                     "allowedValues": [
                       "Standard_LRS",
                       "Standard_GRS",
                       "Standard_ZRS",
                       "Premium_LRS"
                     ],
                     "metadata": {
                       "description": "Storage Account type"
                     }
                   },
                   "location": {
                     "type": "string",
                     "defaultValue": "[[resourceGroup().location]",
                     "metadata": {
                       "description": "Location for all resources."
                     }
                   },
                   "namePrefix": {
                     "type": "string",
                     "maxLength": 11,
                     "defaultValue": "store",
                     "metadata": {
                       "description": "Prefix for storage account name"
                     }
                   }
                 },
                 "variables": {
                   "storageAccountName": "[[concat(parameters('namePrefix'), uniquestring(resourceGroup().id))]"
                 },
                 "resources": [
                   {
                     "type": "Microsoft.Storage/storageAccounts",
                     "apiVersion": "2021-04-01",
                     "name": "[[variables('storageAccountName')]",
                     "location": "[[parameters('location')]",
                     "sku": {
                       "name": "[[parameters('storageAccountType')]"
                     },
                     "kind": "StorageV2",
                     "properties": {}
                   }
                 ],
                 "outputs": {
                   "storageAccountName": {
                     "type": "string",
                     "value": "[[variables('storageAccountName')]"
                   }
                 }
               }
             },
             "tags": {}
           }
         ]
       }
     ],
     "outputs": {}
   }
   

2. Um die neue Version Ihrer Vorlagenspezifikation hinzuzufügen, stellen Sie Ihre Vorlage mit der Azure CLI oder mit PowerShell bereit.

   New-AzResourceGroupDeployment `
     -ResourceGroupName templateSpecRG `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

   az deployment group create \
     --resource-group templateSpecRG \
     --template-file "c:\Templates\azuredeploy.json"
   

3. Kopieren Sie die folgende Vorlage, und speichern Sie sie lokal in einer Datei namens storage.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/deployments",
         "apiVersion": "2021-04-01",
         "name": "demo",
         "properties": {
           "templateLink": {
             "id": "[resourceId('templateSpecRG', 'Microsoft.Resources/templateSpecs/versions', 'storageSpec', '2.0')]"
           },
           "parameters": {
           },
           "mode": "Incremental"
         }
       }
     ],
     "outputs": {}
   }
   

4. Stellen Sie Ihre Vorlage mit der Azure CLI oder mit PowerShell bereit.

   New-AzResourceGroupDeployment `
     -ResourceGroupName storageRG `
     -TemplateFile "c:\Templates\storage.json"
   

   az deployment group create \
     --resource-group storageRG \
     --template-file "c:\Templates\storage.json"
   

Bereinigen von Ressourcen

Löschen Sie zum Bereinigen der in dieser Schnellstartanleitung bereitgestellten Ressource beide Ressourcengruppen, die Sie erstellt haben.

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

2. Geben Sie den Ressourcengruppennamen (templateSpecRG und storageRG) in das Feld „Nach Name filtern“ ein.

3. Klicken Sie auf den Namen der Ressourcengruppe.

4. Wählen Sie im Menü ganz oben den Befehl zum Löschen der Ressourcengruppe aus.

Nächste Schritte

Weitere Informationen zum Erstellen einer Vorlagenspezifikation, die verknüpfte Vorlagen umfasst, finden Sie unter Erstellen einer Vorlagenspezifikation einer verknüpften Vorlage.