Vrácení chyby zpět k úspěšnému nasazení

Článek
05/23/2024

Pokud se nasazení nezdaří, můžete z historie nasazení automaticky znovu nasadit dřívější úspěšné nasazení. Tato funkce je užitečná, pokud máte pro nasazení infrastruktury známý dobrý stav a chcete se k tomuto stavu vrátit. Můžete zadat buď konkrétní dřívější nasazení, nebo poslední úspěšné nasazení.

Důležité

Tato funkce vrátí neúspěšné nasazení opětovným nasazením dřívějšího nasazení. Tento výsledek se může lišit od toho, co byste očekávali od vrácení neúspěšného nasazení zpět. Ujistěte se, že rozumíte způsobu opětovného nasazení předchozího nasazení.

Důležité informace o opětovném nasazení

Před použitím této funkce zvažte tyto podrobnosti o způsobu zpracování opětovného nasazení:

Předchozí nasazení se spustí pomocí režimu dokončení, i když jste během předchozího nasazení použili přírůstkový režim . Opětovné nasazení v úplném režimu by mohlo způsobit neočekávané výsledky, když bylo dříve nasazeno přírůstkové nasazení. Úplný režim znamená, že se odstraní všechny prostředky, které nejsou součástí předchozího nasazení. Zadejte dřívější nasazení, které představuje všechny prostředky a jejich stavy, které chcete ve skupině prostředků existovat. Další informace najdete v režimu nasazení.
Opětovné nasazení se spustí přesně tak, jak bylo spuštěno dříve se stejnými parametry. Parametry nemůžete změnit.
Opětovné nasazení má vliv jenom na prostředky, na změny dat to nemá vliv.
Tuto funkci můžete použít pouze s nasazeními skupin prostředků. Nepodporuje nasazení na úrovni předplatného, skupiny pro správu ani tenanta. Další informace o nasazení na úrovni předplatného najdete v tématu Vytváření skupin prostředků a prostředků na úrovni předplatného.
Tuto možnost můžete použít pouze s nasazeními na úrovni kořene. Nasazení z vnořené šablony nejsou k dispozici pro opětovné nasazení.

Pokud chcete tuto možnost použít, musí mít vaše nasazení v historii nasazení jedinečné názvy. Je to jenom s jedinečnými názvy, které je možné identifikovat konkrétní nasazení. Pokud nemáte jedinečné názvy, může neúspěšné nasazení přepsat úspěšné nasazení v historii.

Pokud zadáte dřívější nasazení, které v historii nasazení neexistuje, vrátí vrácení zpět chybu.

PowerShell

Pokud chcete znovu nasadit poslední úspěšné nasazení, přidejte -RollbackToLastDeployment parametr jako příznak.

New-AzResourceGroupDeployment -Name ExampleDeployment02 `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile c:\MyTemplates\azuredeploy.json `
  -RollbackToLastDeployment

K opětovnému nasazení konkrétního nasazení použijte -RollBackDeploymentName parametr a zadejte název nasazení. Zadané nasazení musí být úspěšné.

New-AzResourceGroupDeployment -Name ExampleDeployment02 `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile c:\MyTemplates\azuredeploy.json `
  -RollBackDeploymentName ExampleDeployment01

Azure CLI

Pokud chcete znovu nasadit poslední úspěšné nasazení, přidejte --rollback-on-error parametr jako příznak.

az deployment group create \
  --name ExampleDeployment \
  --resource-group ExampleGroup \
  --template-file storage.json \
  --parameters storageAccountType=Standard_GRS \
  --rollback-on-error

K opětovnému nasazení konkrétního nasazení použijte --rollback-on-error parametr a zadejte název nasazení. Zadané nasazení musí být úspěšné.

az deployment group create \
  --name ExampleDeployment02 \
  --resource-group ExampleGroup \
  --template-file storage.json \
  --parameters storageAccountType=Standard_GRS \
  --rollback-on-error ExampleDeployment01

REST API

Pokud chcete znovu nasadit poslední úspěšné nasazení v případě selhání aktuálního nasazení, použijte:

{
  "properties": {
    "templateLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
      "contentVersion": "1.0.0.0"
    },
    "mode": "Incremental",
    "parametersLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
      "contentVersion": "1.0.0.0"
    },
    "onErrorDeployment": {
      "type": "LastSuccessful",
    }
  }
}

Pokud chcete nasazení konkrétního nasazení znovu nasadit, pokud se aktuální nasazení nezdaří, použijte:

{
  "properties": {
    "templateLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
      "contentVersion": "1.0.0.0"
    },
    "mode": "Incremental",
    "parametersLink": {
      "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
      "contentVersion": "1.0.0.0"
    },
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "<deploymentname>"
    }
  }
}

Zadané nasazení musí být úspěšné.

Další kroky

Pokud chcete porozumět úplným a přírůstkovým režimům, podívejte se na režimy nasazení Azure Resource Manageru.
Informace o definování parametrů v šabloně najdete v tématu Vysvětlení struktury a syntaxe šablon Azure Resource Manageru.

Sdílet prostřednictvím