Compartir a través de

Revertir en caso de error a una implementación correcta

Cuando se produce un error en una implementación, puede volver a implementar automáticamente una implementación anterior y correcta desde el historial de implementación. Si dispone de un estado bueno conocido para el despliegue de infraestructura y desea volver a este estado, esta funcionalidad le será útil. Puede especificar una implementación anterior determinada o la última implementación exitosa.

Importante

Esta función permite revertir una implementación fallida mediante la reimplementación de una implementación anterior. Este resultado puede ser diferente de lo que esperarías al deshacer la implementación fallida. Asegúrate de entender cómo se reinstala el despliegue anterior.

Consideraciones acerca de la reimplementación

Antes de usar esta característica, tenga en cuenta estos detalles sobre cómo se controla la reimplementación:

  • La implementación anterior se ejecuta con el modo completo, incluso si usó el modo incremental durante la implementación anterior. La reimplementación en modo completo podría producir resultados inesperados cuando la implementación anterior usaba incremental. El modo completo significa que se eliminan los recursos no incluidos en la implementación anterior. Especifique una implementación anterior que represente todos los recursos y sus estados que desea que existan en el grupo de recursos. Para obtener más información, consulte Modos de implementación.
  • La reimplementación se ejecuta exactamente como se ejecutó anteriormente con los mismos parámetros. No se pueden cambiar los parámetros.
  • La reimplementación solo afecta a los recursos, los cambios en los datos no se ven afectados.
  • Esta característica solo se puede usar con implementaciones de grupo de recursos. No admite implementaciones de nivel de suscripción, grupo de administración o arrendatario. Para obtener más información sobre la implementación a nivel de suscripción, consulte Creación de grupos de recursos y recursos a ese nivel.
  • Solo puede usar esta opción con implementaciones de nivel raíz. Las implementaciones de una plantilla anidada no están disponibles para volver a implementarse.

Para usar esta opción, las implementaciones deben tener nombres únicos en el historial de implementación. Solo con nombres únicos se puede identificar una implementación específica. Si no hay nombres únicos, una implementación con errores podría sobrescribir una implementación anteriormente correcta en el historial.

Si especifica una implementación anterior que no existe en el historial de implementación, la reversión devuelve un error.

PowerShell

Para reutilizar el último despliegue exitoso, añada el -RollbackToLastDeployment parámetro como un indicador.

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

Para volver a implementar una implementación específica, use el -RollBackDeploymentName parámetro y proporcione el nombre de la implementación. La implementación especificada debe haberse realizado correctamente.

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

CLI de Azure

Para reutilizar el último despliegue exitoso, añada el --rollback-on-error parámetro como un indicador.

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

Para volver a implementar una implementación específica, use el --rollback-on-error parámetro y proporcione el nombre de la implementación. La implementación especificada debe haberse realizado correctamente.

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

REST API

Para volver a implementar la última implementación correcta si se produce un error en la implementación actual, use:

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

Para volver a implementar una implementación específica si se produce un error en la implementación actual, use:

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

La implementación especificada debe haberse realizado correctamente.

Pasos siguientes

  • Last updated on