Sdílet prostřednictvím

Režimy nasazení Azure Resource Manageru

Při nasazování prostředků určíte, že nasazení je přírůstková nebo úplná aktualizace. Rozdíl mezi těmito dvěma režimy spočívá v tom, jak Resource Manager zpracovává existující prostředky ve skupině prostředků, které nejsou v šabloně.

Důležité

Pomocí zásobníků nasazení můžete provádět odstraňování prostředků při použití šablon ARM nebo souborů Bicep, protože úplný režim bude postupně ukončován.

V obou režimech se Resource Manager pokusí vytvořit všechny prostředky zadané v šabloně. Pokud už prostředek ve skupině prostředků existuje a jeho nastavení se nezmění, nebude pro tento prostředek provedena žádná operace. Pokud změníte hodnoty vlastností pro prostředek, prostředek se aktualizuje o tyto nové hodnoty. Pokud se pokusíte aktualizovat umístění nebo typ existujícího prostředku, nasazení selže s chybou. Místo toho nasaďte nový zdroj s umístěním nebo typem, který potřebujete.

Výchozí režim je přírůstkový.

Přírůstkový režim

V přírůstkovém režimu Resource Manager ponechá nezměněné prostředky, které existují ve skupině prostředků, ale nejsou zadané v šabloně. Prostředky v šabloně se přidají do skupiny prostředků.

Důležité

Přírůstkový režim je doporučený režim nasazení. Pokud potřebujete odstranit prostředky v rámci souboru Bicep nebo šablony ARM JSON, použijte zásobníky nasazení.

Při opětovném nasazení existujícího prostředku v přírůstkovém režimu se znovu používají všechny vlastnosti. Vlastnosti se nepřidávají přírůstkově. Běžnou nedorozumění spočívá v tom, že vlastnosti, které nejsou v šabloně zadány, zůstanou beze změny. Pokud nezadáte určité vlastnosti, Resource Manager interpretuje nasazení jako přepsání těchto hodnot. Vlastnosti, které nejsou součástí šablony, se resetují na výchozí hodnoty. Zadejte všechny jiné než výchozí hodnoty pro prostředek, nejen ty, které aktualizujete. Definice prostředku v šabloně vždy obsahuje konečný stav prostředku. Nemůže představovat částečnou aktualizaci existujícího prostředku.

Výstraha

Ve výjimečných případech můžete zadat vlastnosti prostředku nebo některého z jeho podřízených prostředků. Dvěma běžnými příklady jsou podsítě ve virtuálních sítích a hodnoty konfigurace webu pro webové aplikace. V těchto případech je nutné pečlivě zpracovat přírůstkové aktualizace.

Pro zadání hodnot pro podsítě použijte vlastnost subnets na prostředku Microsoft.Network/virtualNetworks. Nedefinujte hodnoty prostřednictvím podřízeného prostředku Microsoft.Network/virtualNetworks/subnets. Pokud jsou podsítě definované ve virtuální síti, můžete virtuální síť znovu nasadit a nepřijdete o podsítě.

Pro hodnoty konfigurace lokality jsou hodnoty implementovány v podřízený typ Microsoft.Web/sites/config prostředku. Pokud webovou aplikaci znovu nasadíte a zadáte prázdný objekt pro hodnoty konfigurace webu, podřízený prostředek se neaktualizuje. Pokud však zadáte nové hodnoty konfigurace webu, aktualizuje se typ podřízeného prostředku.

Režim dokončení

Výstraha

Úplný režim se nedoporučuje. Pokud chcete provádět mazání pomocí nasazení šablon Bicep nebo ARM, použijte deployment stacky.

V úplném režimu Resource Manager odstraní prostředky, které existují ve skupině prostředků, ale nejsou zadané v šabloně.

Poznámka:

Před nasazením šablony v úplném režimu vždy používejte operaci co by bylo kdyby. Co když ukazuje, které prostředky se vytvoří, odstraní nebo upraví. Pokud se chcete vyhnout neúmyslnému odstranění prostředků, použijte scénáře "co když".

Pokud vaše šablona obsahuje prostředek, který není nasazený, protože podmínka se vyhodnotí jako nepravda, výsledek závisí na tom, jakou verzi rozhraní REST API použijete k nasazení šablony. Pokud používáte verzi starší než 10. 5. 2019, prostředek se neodstraní. Po 10. 5. 2019 nebo později je prostředek odstraněn. Nejnovější verze nástrojů Azure PowerShell a Azure CLI odstraní daný prostředek.

Buďte opatrní při použití kompletního režimu se smyčkami kopírování. Všechny prostředky, které nejsou zadané v šabloně po vyřešení kopírovací smyčky, se odstraní.

Pokud nasadíte do více než jedné skupiny prostředků v šabloně, prostředky ve skupině prostředků zadané v operaci nasazení mají nárok na odstranění. Prostředky v sekundárních zdrojových skupinách se neodstraňují.

Existují určité rozdíly v tom, jak typy prostředků zpracovávají úplné odstranění režimu. Nadřazené prostředky se automaticky odstraní, pokud nejsou součástí šablony nasazené v režimu úplného nasazení. Některé podřízené prostředky nejsou automaticky odstraněny, když nejsou v šabloně. Tyto podřízené zdroje se však odstraní, pokud je nadřazený zdroj odstraněn.

Pokud například vaše skupina prostředků obsahuje zónu DNS (Microsoft.Network/dnsZones typ prostředku) a záznam CNAME (Microsoft.Network/dnsZones/CNAME typ prostředku), je zóna DNS nadřazeným prostředkem pro záznam CNAME. Pokud nasadíte s úplným režimem a nezahrnete do šablony zónu DNS, odstraní se zóna DNS i záznam CNAME. Pokud do šablony zahrnete zónu DNS, ale nezahrnete záznam CNAME, záznam CNAME se neodstraní.

Seznam toho, jak typy prostředků zpracovávají odstranění, najdete v Odstranění prostředků Azure při kompletním nasazení v režimu.

Pokud je skupina prostředků uzamčená, úplný režim neodstraní prostředky.

Poznámka:

Kompletní režim nasazení podporují pouze šablony kořenové úrovně. U propojených nebo vnořených šablon je nutné použít přírůstkový režim.

Nasazení na úrovni předplatného nepodporují úplný režim.

Portál v současné době nepodporuje úplný režim.

Příklad výsledku

Pokud chcete znázornit rozdíl mezi přírůstkovými a úplnými režimy, zvažte následující scénář.

Skupina prostředků obsahuje:

  • Prostředek A
  • Zdroj B
  • Zdroj C

Šablona obsahuje:

  • Prostředek A
  • Zdroj B
  • Zdroj D

Při nasazení v přírůstkovém režimu má skupina prostředků:

  • Prostředek A
  • Zdroj B
  • Zdroj C
  • Zdroj D

Po nasazení v úplném režimu se prostředek C odstraní. Skupina prostředků má:

  • Prostředek A
  • Zdroj B
  • Zdroj D

Nastavení režimu nasazení

Pokud chcete nastavit režim nasazení při nasazování pomocí PowerShellu, použijte tento Mode parametr.

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

Pokud chcete nastavit režim nasazení při nasazování pomocí Azure CLI, použijte tento mode parametr.

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

Následující příklad ukazuje propojenou šablonu nastavenou na režim přírůstkového nasazení:

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

Další kroky

  • Last updated on