Azure Resource Manager-Bereitstellungsmodi

  • Artikel

Bei der Bereitstellung Ihrer Ressourcen geben Sie an, dass es sich bei der Bereitstellung entweder um ein inkrementelles Update oder um ein vollständiges Update handelt. Der Unterschied zwischen diesen beiden Modi besteht darin, wie Resource Manager vorhandene Ressourcen in der Ressourcengruppe behandelt, die nicht in der Vorlage enthalten sind.

In beiden Modi versucht Resource Manager, alle in der Vorlage angegebenen Ressourcen zu erstellen. Wenn die Ressource bereits in der Ressourcengruppe vorhanden ist und ihre Einstellungen unverändert sind, wird für diese Ressource kein Vorgang ausgeführt. Wenn Sie die Eigenschaftswerte für eine Ressource ändern, wird die Ressource mit diesen neuen Werten aktualisiert. Falls Sie versuchen, den Speicherort oder Typ einer vorhandenen Ressource zu aktualisieren, tritt bei der Bereitstellung ein Fehler auf. Stellen Sie stattdessen eine neue Ressource mit dem gewünschten Speicherort oder Typ bereit.

Der Standardmodus ist inkrementell.

Vollständiger Modus

Im vollständigen-Modus löscht Resource Manager Ressourcen, die in der Ressourcengruppe vorhanden, aber nicht in der Vorlage angegeben sind.

Hinweis

Verwenden Sie immer den Was-wäre-wenn-Vorgang, bevor Sie eine Vorlage im vollständigen Modus bereitstellen. Anhand von Was-wäre-wenn-Vorgänge können Sie sehen, welche Ressourcen erstellt, gelöscht oder geändert werden. Verwenden Sie Was-wäre-wenn-Vorgänge, um ein unbeabsichtigtes Löschen von Ressourcen zu vermeiden.

Wenn Ihre Vorlage eine Ressource enthält, die nicht bereitgestellt ist, weil die Bedingung nicht erfüllt wird, hängt das Ergebnis davon ab, welche Rest-API-Version Sie zum Bereitstellen der Vorlage verwenden. Wenn Sie eine frühere Version als 2019-05-10 verwenden, wird die Ressource nicht gelöscht. Bei Version 2019-05-10 oder höher wird die Ressource gelöscht. Die neuesten Versionen von Azure PowerShell und Azure CLI löschen die Ressource.

Wenden Sie den vollständigen Modus mit Kopierschleifen mit Vorsicht an. Alle Ressourcen, die nicht in der Vorlage angegeben sind, werden nach dem Auflösen der Kopierschleife gelöscht.

Wenn Sie in mehr als einer Ressourcengruppe in einer Vorlage bereitstellen, können Ressourcen, die sich in der Ressourcengruppe befinden, die im Bereitstellungsvorgang angegeben wurde, gelöscht werden. Ressourcen in den sekundären Ressourcengruppen werden nicht gelöscht.

Bei der Verarbeitung von Löschungen im vollständigen Modus gibt es zwischen Ressourcentypen einige Unterschiede. Übergeordnete Ressourcen werden automatisch gelöscht, wenn sie nicht in einer Vorlage enthalten sind, die im vollständigen-Modus bereitgestellt wird. Einige untergeordnete Ressourcen werden nicht automatisch gelöscht, wenn sie nicht in der Vorlage enthalten sind. Diese untergeordneten Ressourcen werden jedoch gelöscht, wenn die übergeordnete Ressource gelöscht wird.

Beispiel: Wenn Ihre Ressourcengruppe eine DNS-Zone (Ressourcentyp Microsoft.Network/dnsZones) und einen CNAME-Eintrag (Ressourcentyp Microsoft.Network/dnsZones/CNAME) enthält, ist die DNS-Zone die übergeordnete Ressource des CNAME-Eintrags. Wenn Sie im vollständigen Modus bereitstellen und die DNS-Zone nicht in Ihre Vorlage aufnehmen, werden sowohl die DNS-Zone als auch der CNAME-Eintrag gelöscht. Wenn Sie die DNS-Zone in Ihre Vorlage aufnehmen, den CNAME-Eintrag jedoch nicht, wird der CNAME-Eintrag nicht gelöscht.

Eine Liste der Verarbeitung von Löschungen durch Ressourcentypen finden Sie unter Löschen von Azure-Ressourcen für Bereitstellungen im vollständigen Modus.

Wenn die Ressourcengruppe gesperrt ist, werden die Ressourcen im vollständigen Modus nicht gelöscht.

Hinweis

Nur Vorlagen auf Stammebene unterstützen den vollständigen Bereitstellungsmodus. Für verknüpfte oder geschachtelte Vorlagen müssen Sie den inkrementellen Modus verwenden.

Bereitstellungen auf der Abonnementstufe unterstützen den vollständigen Modus nicht.

Das Portal unterstützt den vollständigen Modus derzeit nicht.

Inkrementeller Modus

Im inkrementellen Modus lässt Resource Manager Ressourcen unverändert, die in der Ressourcengruppe vorhanden, aber nicht in der Vorlage angegeben sind. Ressourcen in der Vorlagen werden der Ressourcengruppe hinzugefügt.

Wichtig

Bei der erneuten Bereitstellung einer vorhandenen Ressource im inkrementellen Modus werden alle Eigenschaften erneut angewendet. Die Eigenschaften werden nicht inkrementell hinzugefügt. Ein weit verbreitetes Missverständnis ist, dass Eigenschaften, die nicht in der Vorlage angegeben sind, unverändert bleiben. Falls Sie bestimmte Eigenschaften nicht angeben, interpretiert Resource Manager die Bereitstellung als Überschreibung dieser Werte. Eigenschaften, die nicht in der Vorlage enthalten sind, werden auf die Standardwerte zurückgesetzt. Geben Sie alle nicht standardmäßigen Werte für die Ressource an und nicht nur diejenigen, die Sie aktualisieren. Die Ressourcendefinition in der Vorlage enthält immer den endgültigen Zustand der Ressource. Sie kann keine partielle Aktualisierung einer vorhandenen Ressource darstellen.

Warnung

In seltenen Fällen können Sie Eigenschaften entweder für eine Ressource oder für eine ihrer untergeordneten Ressourcen festlegen. Zwei gängige Beispiele sind Subnetze in virtuellen Netzwerken und Websitekonfigurationswerte für Web-Apps. In diesen Fällen müssen Sie inkrementelle Updates sorgfältig handhaben.

Geben Sie für Subnetze die Werte über die subnets-Eigenschaft der Ressource Microsoft.Network/virtualNetworks an. Definieren Sie die Werte nicht mithilfe der untergeordneten Ressource Microsoft.Network/virtualNetworks/subnets. Solange die Subnetze im virtuellen Netzwerk definiert sind, können Sie das virtuelle Netzwerk erneut bereitstellen, ohne die Subnetze zu verlieren.

Für Websitekonfigurationswerte werden die Werte im untergeordneten Ressourcentyp Microsoft.Web/sites/config implementiert. Wenn Sie die Web-App erneut bereitstellen und für die Websitekonfigurationswerte ein leeres Objekt angeben, wird die untergeordnete Ressource nicht aktualisiert. Der Typ der untergeordneten Ressource wird jedoch aktualisiert, wenn Sie neue Websitekonfigurationswerte angeben.

Beispielergebnis

Im folgenden Szenario wird der Unterschied zwischen dem inkrementellen und dem vollständigen Modus veranschaulicht:

Die Ressourcengruppe enthält Folgendes:

  • Ressource A
  • Ressource B
  • Ressource C

Die Vorlage enthält Folgendes:

  • Ressource A
  • Ressource B
  • Ressource D

Bei der Bereitstellung im inkrementellen Modus enthält die Ressourcengruppe:

  • Ressource A
  • Ressource B
  • Ressource C
  • Ressource D

Bei der Bereitstellung im vollständigen Modus wird Ressource C gelöscht. Die Ressourcengruppe enthält:

  • Ressource A
  • Ressource B
  • Ressource D

Festlegen des Bereitstellungsmodus

Verwenden Sie zum Festlegen des Bereitstellungsmodus mit PowerShell den Mode-Parameter.

New-AzResourceGroupDeployment `
  -Mode Complete `
  -Name ExampleDeployment `
  -ResourceGroupName ExampleResourceGroup `
  -TemplateFile c:\MyTemplates\storage.json

Verwenden Sie zum Festlegen des Bereitstellungsmodus mit der Azure CLI den mode-Parameter.

az deployment group create \
  --mode Complete \
  --name ExampleDeployment \
  --resource-group ExampleResourceGroup \
  --template-file storage.json

Im folgenden Beispiel ist eine verknüpfte Vorlage mit festgelegtem inkrementellen Bereitstellungsmodus dargestellt:

"resources": [
  {
    "type": "Microsoft.Resources/deployments",
    "apiVersion": "2020-10-01",
    "name": "linkedTemplate",
    "properties": {
      "mode": "Incremental",
          <nested-template-or-external-template>
    }
  }
]

Nächste Schritte