Režimy nasazení Azure Resource Manageru

  • Článek
  • 3 min ke čtení

Při nasazování prostředků určíte, že nasazení je přírůstková nebo kompletní aktualizace. Rozdíl mezi těmito dvěma režimy spočívá v tom, že Správce prostředků zpracovává stávající prostředky ve skupině prostředků, která není v šabloně.

V obou režimech se Správce prostředků pokusí vytvořit všechny prostředky, které jsou uvedené v šabloně. Pokud prostředek ve skupině prostředků už existuje a jeho nastavení se nezměnilo, pro tento prostředek se nebere žádná operace. Pokud změníte hodnoty vlastností prostředku, prostředek se aktualizuje o tyto nové hodnoty. Pokud se pokusíte aktualizovat umístění nebo typ existujícího prostředku, nasazení dojde k chybě. Místo toho nasaďte nový prostředek s umístěním nebo typem, který potřebujete.

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

Režim dokončení

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

Poznámka

Vždy použijte operaci citlivostní zpracování před nasazením šablony v úplném režimu. Jak ukazuje, které prostředky se vytvoří, odstraní nebo upraví. Použijte co když, chcete-li se vyhnout neúmyslnému odstranění prostředků.

Pokud vaše šablona obsahuje prostředek, který není nasazený, protože Podmínka je vyhodnocena jako NEPRAVDA, výsledek závisí na tom, která REST API verze, kterou použijete k nasazení šablony. Pokud používáte verzi starší než 2019-05-10, prostředek se neodstraní. Při 2019-05-10 nebo novějším se prostředek odstraní. nejnovější verze Azure PowerShell a Azure CLI odstraní prostředek.

Použití kompletního režimu s kopírováním smyčekvám bude opatrní. Všechny prostředky, které nejsou zadány v šabloně po vyřešení smyčky kopírování, jsou odstraněny.

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

Existují určité rozdíly ve způsobu, jakým typy prostředků zpracovávají kompletní odstranění režimu. Nadřazené prostředky se odstraní automaticky, když nejsou v šabloně, která je nasazena v úplném režimu. Některé podřízené prostředky nejsou automaticky odstraněny, pokud nejsou v šabloně. Tyto podřízené prostředky se ale odstraní, pokud se odstraní nadřazený prostředek.

Například pokud 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), zóna DNS je nadřazeným prostředkem pro záznam CNAME. Pokud nasadíte nástroj s úplným režimem a nezadáte do šablony zónu DNS, odstraní se zóna DNS a záznam CNAME. Pokud zahrnete zónu DNS do šablony, ale nezahrnete záznam CNAME, záznam CNAME se neodstraní.

Seznam způsobu, jakým se zpracovávají typy prostředků, najdete v tématu odstranění prostředků Azure pro nasazení v režimu úplného režimu.

Pokud je skupina prostředků zamčená, režim úplného režimu neodstraní prostředky.

Poznámka

Pouze šablony na kořenové úrovni podporují režim úplného nasazení. U propojených nebo vnořených šablonje nutné použít přírůstkový režim.

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

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

Přírůstkový režim

V přírůstkovém režimu Správce prostředků opustí 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ů.

Poznámka

Při opětovném nasazení stávajícího prostředku v přírůstkovém režimu jsou znovu aplikovány všechny vlastnosti. Vlastnosti se přírůstkově přidávají. Běžným srozumitelným pochopením je, že si nezůstane beze změny vlastností, které nejsou zadané v šabloně. Pokud nezadáte určité vlastnosti, Správce prostředků interpretuje nasazení jako přepsání těchto hodnot. Vlastnosti, které nejsou zahrnuty v šabloně, se obnoví na výchozí hodnoty. Zadejte všechny jiné než výchozí hodnoty pro prostředek, nikoli pouze ty, které aktualizujete. Definice prostředků v šabloně vždy obsahuje konečný stav prostředku. Nemůže představovat částečnou aktualizaci stávajícího prostředku.

Ve výjimečných případech jsou vlastnosti, které zadáte pro prostředek, ve skutečnosti implementované jako podřízené prostředky. Když například zadáte hodnoty konfigurace lokality pro webovou aplikaci, tyto hodnoty se implementují v typu podřízeného prostředku Microsoft.Web/sites/config . Pokud webovou aplikaci znovu nasadíte a zadáte prázdný objekt pro hodnoty konfigurace lokality, podřízený prostředek se neaktualizuje. Pokud však zadáte nové hodnoty konfigurace lokality, bude se aktualizovat typ podřízeného prostředku.

Příklad výsledku

K ilustraci rozdílu mezi režimy přírůstkového a úplného použití zvažte následující scénář.

Skupina prostředků obsahuje:

  • Prostředek A
  • Prostředek B
  • Prostředek C

Šablona obsahuje:

  • Prostředek A
  • Prostředek B
  • Prostředek D

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

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

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

  • Prostředek A
  • Prostředek B
  • Prostředek D

Nastavit režim nasazení

Chcete-li nastavit režim nasazení při nasazení pomocí prostředí PowerShell, použijte Mode parametr.

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

Pokud chcete nastavit režim nasazení při nasazení pomocí Azure CLI, použijte 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": "2020-10-01",
    "name": "linkedTemplate",
    "properties": {
      "mode": "Incremental",
          <nested-template-or-external-template>
    }
  }
]

Další kroky