Återställning vid fel vid lyckad distribution

Artikel
03/20/2024

När en distribution misslyckas kan du automatiskt distribuera om en tidigare lyckad distribution från distributionshistoriken. Den här funktionen är användbar om du har ett känt bra tillstånd för infrastrukturdistributionen och vill återgå till det här tillståndet. Du kan ange antingen en viss tidigare distribution eller den senaste lyckade distributionen.

Viktigt!

Den här funktionen återställer en misslyckad distribution genom att distribuera om en tidigare distribution. Det här resultatet kan skilja sig från vad du kan förvänta dig av att ångra den misslyckade distributionen. Se till att du förstår hur den tidigare distributionen distribueras om.

Överväganden för omdistribuering

Innan du använder den här funktionen bör du tänka på den här informationen om hur omdistributionen hanteras:

Den tidigare distributionen körs i fullständigt läge, även om du använde inkrementellt läge under den tidigare distributionen. Omdistribution i fullständigt läge kan ge oväntade resultat när den tidigare distributionen använde inkrementell. Det fullständiga läget innebär att alla resurser som inte ingår i den tidigare distributionen tas bort. Ange en tidigare distribution som representerar alla resurser och deras tillstånd som du vill ska finnas i resursgruppen. Mer information finns i distributionslägen.
Omdistributionen körs exakt som den kördes tidigare med samma parametrar. Du kan inte ändra parametrarna.
Omdistributionen påverkar bara resurserna, eventuella dataändringar påverkas inte.
Du kan endast använda den här funktionen med resursgruppsdistributioner. Den stöder inte distributioner på prenumerations-, hanteringsgrupps- eller klientorganisationsnivå. Mer information om distribution på prenumerationsnivå finns i Skapa resursgrupper och resurser på prenumerationsnivå.
Du kan bara använda det här alternativet med distributioner på rotnivå. Distributioner från en kapslad mall är inte tillgängliga för omdistribution.

Om du vill använda det här alternativet måste dina distributioner ha unika namn i distributionshistoriken. Det är bara med unika namn som en specifik distribution kan identifieras. Om du inte har unika namn kan en misslyckad distribution skriva över en lyckad distribution i historiken.

Om du anger en tidigare distribution som inte finns i distributionshistoriken returnerar återställningen ett fel.

PowerShell

Om du vill distribuera om den senaste lyckade distributionen lägger du till parametern -RollbackToLastDeployment som en flagga.

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

Om du vill distribuera om en specifik distribution använder du parametern -RollBackDeploymentName och anger namnet på distributionen. Den angivna distributionen måste ha slutförts.

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

Azure CLI

Om du vill distribuera om den senaste lyckade distributionen lägger du till parametern --rollback-on-error som en flagga.

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

Om du vill distribuera om en specifik distribution använder du parametern --rollback-on-error och anger namnet på distributionen. Den angivna distributionen måste ha slutförts.

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

REST-API

Om du vill distribuera om den senaste lyckade distributionen om den aktuella distributionen misslyckas använder du:

{
  "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",
    }
  }
}

Om du vill distribuera om en specifik distribution om den aktuella distributionen misslyckas använder du:

{
  "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>"
    }
  }
}

Den angivna distributionen måste ha slutförts.

Nästa steg

Information om fullständiga och inkrementella lägen finns i Distributionslägen för Azure Resource Manager.
Information om hur du definierar parametrar i mallen finns i Förstå strukturen och syntaxen för Azure Resource Manager-mallar.

Dela via