Поделиться через

Откат к успешному развертыванию при ошибке

При сбое развертывания можно автоматически развернуть более раннее успешное развертывание из журнала развертывания. Эта функция полезна, если у вас есть известное стабильное состояние для развертывания инфраструктуры и вы хотите вернуться к этому состоянию. Можно указать определенное предыдущее развертывание или последнее успешное развертывание.

Это важно

Эта функция откатывает неудачное развертывание путем повторного развертывания более ранней версии. Этот результат может отличаться от того, что вы ожидаете от отмены неудачного развертывания. Убедитесь, что вы понимаете, как переустанавливается более раннее развертывание.

Рекомендации по повторному развертыванию

Прежде чем использовать эту функцию, рассмотрите следующие сведения о том, как выполняется повторное развертывание:

  • Предыдущее развертывание выполняется с помощью полного режима, даже если вы использовали добавочный режим во время предыдущего развертывания. Полное развертывание может вызвать непредвиденные результаты, если ранее было использовано инкрементальное развертывание. Полный режим означает, что все ресурсы, не включенные в предыдущее развертывание, удаляются. Определите более раннее развертывание, которое представляет все ресурсы и их состояния, которые должны существовать в группе ресурсов. Дополнительные сведения см. в режимах развертывания.
  • Повторное развертывание выполняется точно так же, как было запущено ранее с теми же параметрами. Невозможно изменить параметры.
  • Повторное развертывание влияет только на ресурсы, любые изменения данных не затрагиваются.
  • Эту функцию можно использовать только с развертываниями групп ресурсов. Она не поддерживает развертывания подписки, группы управления или уровня клиента. Дополнительные сведения о развертывании уровня подписки см. в разделе "Создание групп ресурсов и ресурсов" на уровне подписки.
  • Этот параметр можно использовать только с развертываниями уровня root. Развертывания из вложенного шаблона недоступны для повторного развертывания.

Чтобы использовать этот параметр, развертывания должны иметь уникальные имена в истории развертывания. Только с уникальными именами можно определить конкретное развертывание. Если у вас нет уникальных имен, неудачное развертывание может перезаписать успешное развертывание в истории.

Если указать более раннее развертывание, которое не существует в журнале развертывания, откат возвращает ошибку.

PowerShell

Чтобы повторно развернуть последнее успешное развертывание, добавьте -RollbackToLastDeployment параметр в качестве флага.

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

Чтобы повторно развернуть определенное развертывание, используйте -RollBackDeploymentName параметр и укажите имя развертывания. Указанное развертывание должно быть успешно выполнено.

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

Azure CLI (Интерфейс командной строки для Azure)

Чтобы повторно развернуть последнее успешное развертывание, добавьте --rollback-on-error параметр в качестве флага.

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

Чтобы повторно развернуть определенное развертывание, используйте --rollback-on-error параметр и укажите имя развертывания. Указанное развертывание должно быть успешно выполнено.

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

REST API

Чтобы повторно развернуть последнее успешное развертывание, если текущее развертывание завершается ошибкой, используйте следующую команду:

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

Чтобы повторно развернуть определенное развертывание, если текущее развертывание завершается ошибкой, используйте следующую команду:

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

Указанное развертывание должно быть успешно выполнено.

Дальнейшие шаги