Azure-Portal zum Exportieren einer Vorlage verwenden

  • Artikel

Um bei der Erstellung von Azure Resource Manager-Vorlagen zu helfen, können Sie eine Vorlage aus vorhandenen Ressourcen exportieren. Die exportierte Vorlage hilft Ihnen, die JSON-Syntax und die Eigenschaften zu verstehen, die Ihre Ressourcen bereitstellen. Zum Automatisieren zukünftiger Bereitstellungen beginnen Sie mit der exportierten Vorlage und passen Sie sie an Ihr Szenario an. Beim dem Prozess „Vorlage exportieren“ wird versucht, eine verwendbare Vorlage zu erstellen. Die meisten exportierten Vorlagen erfordern jedoch einige Änderungen, bevor sie für die Bereitstellung von Azure-Ressourcen verwendet werden können.

Mit Resource Manager können Sie eine oder mehrere Ressourcen für den Export in eine Vorlage auswählen. Sie können sich auf genau die Ressourcen konzentrieren, die in der Vorlage erforderlich sind.

Dieser Artikel zeigt, wie Sie Vorlagen über das Portal exportieren können. Für andere Optionen, siehe:

Auswählen der richtigen Exportoption

Eine Vorlage kann auf zwei Arten exportiert werden:

  • Export aus Ressourcengruppe oder Ressource. Diese Option generiert eine neue Vorlage aus vorhandenen Ressourcen. Die exportierte Vorlage ist eine „Momentaufnahme“ des aktuellen Zustands der Ressourcengruppe. Sie können eine gesamte Ressourcengruppe oder bestimmte Ressourcen innerhalb dieser Ressourcengruppe exportieren.

  • Aus dem Verlauf speichern. Diese Option ruft eine exakte Kopie einer für die Bereitstellung verwendeten Vorlage ab. Sie geben die Bereitstellung aus dem Bereitstellungsverlauf an.

Je nach gewählter Option haben die exportierten Vorlagen unterschiedliche Qualitäten.

Aus Ressourcengruppe oder Ressource Aus Verlauf
Die Vorlage wird automatisch generiert. Sie sollten den Code vor der Bereitstellung verbessern. Die Vorlage ist eine genaue Kopie der vom Vorlagenautor erstellten Kopie. Sie kann ohne Änderungen erneut bereitgestellt werden.
Die Vorlage ist eine Momentaufnahme des aktuellen Zustands der Ressourcen. Sie umfasst alle manuellen Änderungen, die Sie nach der Bereitstellung vorgenommen haben. Die Vorlage zeigt nur den Zustand der Ressourcen zum Zeitpunkt der Bereitstellung an. Alle manuellen Änderungen, die Sie nach der Bereitstellung vorgenommen haben, sind nicht enthalten.
Sie können auswählen, welche Ressourcen aus einer Ressourcengruppe exportiert werden sollen. Alle Ressourcen für eine bestimmte Bereitstellung sind enthalten. Sie können keine Teilmenge dieser Ressourcen auswählen oder Ressourcen hinzufügen, die zu einem anderen Zeitpunkt hinzugefügt wurden.
Die Vorlage enthält alle Eigenschaften für die Ressourcen, einschließlich einiger Eigenschaften, die Sie normalerweise während der Bereitstellung nicht festlegen würden. Möglicherweise möchten Sie diese Eigenschaften entfernen oder bereinigen, bevor Sie die Vorlage wiederverwenden. Die Vorlage enthält nur die für die Bereitstellung erforderlichen Eigenschaften. Die Vorlage ist von geringerer Dichte und einfacher zu lesen.
Die Vorlage enthält möglicherweise nicht alle für die Wiederverwendung erforderlichen Parameter. Die meisten Eigenschaftswerte sind in der Vorlage hartcodiert. Um die Vorlage in anderen Umgebungen neu bereitzustellen, müssen Sie Parameter hinzufügen, die die Möglichkeit zur Konfiguration der Ressourcen erhöhen. Sie können die Auswahl von Parameter einschließen auch aufheben, sodass Sie Ihre eigenen Parameter erstellen können. Die Vorlage enthält Parameter, die es einfach gestalten, sie in verschiedenen Umgebungen neu bereitzustellen.

Exportieren Sie die Vorlage aus einer Ressourcengruppe oder Ressource, wenn Folgendes zutrifft:

  • Sie müssen Änderungen an den Ressourcen erfassen, die nach der ursprünglichen Bereitstellung vorgenommen wurden.
  • Sie möchten die zu exportierenden Ressourcen auswählen.
  • Die Ressourcen wurden nicht mit einer Vorlage erstellt.

Exportieren Sie die Vorlage für folgende Fälle aus dem Verlauf:

  • Sie benötigen eine einfach wiederzuverwendende Vorlage.
  • Sie müssen keine Änderungen einbeziehen, die Sie nach der ursprünglichen Bereitstellung vorgenommen haben.

Einschränkungen

Es ist nicht garantiert, dass der Export erfolgreich ist. Der Export ist keine zuverlässige Möglichkeit, bereits vorhandene Ressourcen in Vorlagen umzuwandeln, die in der Produktion verwendet werden können. Es ist besser, Ressourcen von Grund auf neu zu erstellen, indem Sie eine handgeschriebene Bicep-Datei, ARM-Vorlage oder Terraform verwenden.

Beim Exportieren aus einer Ressourcengruppe oder Ressource wird die exportierte Vorlage aus den veröffentlichten Schemas für jeden Ressourcentyp generiert. Gelegentlich weist das Schema nicht die neueste Version für einen Ressourcentyp auf. Überprüfen Sie die exportierte Vorlage, um sicherzustellen, dass sie die benötigten Eigenschaften enthält. Bearbeiten Sie bei Bedarf die exportierte Vorlage so, dass sie die benötigte API-Version verwendet.

In den exportierten Vorlagen fehlen möglicherweise einige Kennwortparameter. Sie müssen die Vorlagenreferenz überprüfen und diese Parameter manuell hinzufügen, bevor Sie die Vorlagen zum Bereitstellen von Ressourcen verwenden können.

Die Funktion „Vorlage exportieren“ unterstützt nicht das Exportieren von Azure Data Factory-Ressourcen. Informationen zum Exportieren von Data Factory-Ressourcen finden Sie unter Kopieren oder Klonen einer Data Factory in Azure Data Factory.

Um über das klassische Bereitstellungsmodell erstellte Ressourcen zu exportieren, müssen Sie sie zum Resource Manager-Bereitstellungsmodell migrieren.

Wenn beim Exportieren einer Vorlage eine Warnung angezeigt wird, die angibt, dass ein Ressourcentyp nicht exportiert wurde, können Sie die Eigenschaften für diese Ressource immer noch ermitteln. Informationen zu Ressourceneigenschaften finden Sie in der Vorlagenreferenz. Sie können den Ressourcentyp auch in der Azure-REST-API nachschlagen.

Die Ressourcengruppe, für die Sie die exportierte Vorlage erstellen, ist auf 200 Ressourcen begrenzt. Wenn Sie versuchen, eine Ressourcengruppe mit mehr als 200 Ressourcen zu exportieren, wird die Fehlermeldung Export template is not supported for resource groups more than 200 resources angezeigt.

Exportieren einer Vorlage aus einer Ressourcengruppe

So exportieren Sie eine oder mehrere Ressourcen aus einer Ressourcengruppe

  1. Wählen Sie die Ressourcengruppe aus, die die zu exportierenden Ressourcen enthält.

  2. Wählen Sie mithilfe der Kontrollkästchen mindestens eine Ressource aus. Wenn Sie alle Kontrollkästchen aktivieren möchten, aktivieren Sie das Kontrollkästchen links neben Name. Das Menüelement Vorlage exportieren wird erst aktiviert, wenn Sie mindestens eine Ressource ausgewählt haben.

    Screenshot der Auswahl aller zu exportierenden Ressourcen im Azure-Portal.

    Auf dem Screenshot ist nur das Speicherkonto ausgewählt.

  3. Wählen Sie Vorlage exportieren aus.

  4. Die exportierte Vorlage wird angezeigt und steht zum Herunterladen und Bereitstellen bereit.

    Screenshot der angezeigten exportierten Vorlage im Azure-Portal.

    Parameter einschließen ist standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, werden alle Vorlagenparameter eingeschlossen, wenn die Vorlage generiert wird. Wenn Sie Ihre eigenen Parameter erstellen möchten, deaktivieren Sie dieses Kontrollkästchen, um sie nicht einzuschließen.

Exportieren einer Vorlage aus einer Ressource

So exportieren Sie eine Ressource

  1. Wählen Sie die Ressourcengruppe aus, die die zu exportierende Ressource enthält.

  2. Wählen Sie die zu exportierende Ressource aus, um sie zu öffnen.

  3. Wählen Sie für diese Ressource im linken Bereich Vorlage exportieren aus.

    Screenshot des Exportierens einer einzelnen Ressource im Azure-Portal.

  4. Die exportierte Vorlage wird angezeigt und steht zum Herunterladen und Bereitstellen bereit. Die Vorlage enthält nur die einzelne Ressource. Parameter einschließen ist standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, werden alle Vorlagenparameter eingeschlossen, wenn die Vorlage generiert wird. Wenn Sie Ihre eigenen Parameter erstellen möchten, deaktivieren Sie dieses Kontrollkästchen, um sie nicht einzuschließen.

Vorlage vor der Bereitstellung herunterladen

Das Portal bietet die Möglichkeit, eine Vorlage vor der Bereitstellung herunterzuladen. Diese Option ist nicht über PowerShell oder Azure CLI verfügbar.

  1. Wählen Sie den bereitzustellenden Azure-Dienst aus.

  2. Geben Sie die Werte für den neuen Dienst ein.

  3. Wählen Sie nach erfolgreicher Validierung, aber vor Beginn der Bereitstellung, Vorlage zur Automatisierung herunterladen aus.

    Screenshot der Option „Vorlage vor der Bereitstellung herunterladen“ im Azure-Portal.

  4. Die Vorlage wird angezeigt und steht zum Herunterladen und Bereitstellen bereit.

Exportieren der Vorlage nach der Bereitstellung

Sie können die Vorlage exportieren, die für die Bereitstellung vorhandener Ressourcen verwendet wurde. Die Vorlage, die Sie erhalten, ist genau dieselbe, die für die Bereitstellung verwendet wurde.

  1. Wählen Sie die zu exportierende Ressourcengruppe aus.

  2. Wählen Sie den Link unter Bereitstellungen aus.

    Screenshot der Auswahl des Bereitstellungsverlaufs im Azure-Portal.

  3. Wählen Sie eine der Bereitstellungen aus dem Bereitstellungsverlauf aus.

    Screenshot der Auswahl einer bestimmten Bereitstellung im Bereitstellungsverlauf im Azure-Portal.

  4. Wählen Sie Vorlage aus. Die für diese Bereitstellung verwendete Vorlage wird angezeigt und steht zum Herunterladen zur Verfügung.

    Screenshot der Auswahl der Vorlage, die für eine bestimmte Bereitstellung verwendet wurde, im Azure-Portal.

Nächste Schritte