Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Configuración de una etapa para la reversión automática
Puede configurar las etapas de una canalización para revertirlas automáticamente en caso de fallo. Cuando la etapa falla, se revierte a la ejecución correcta más reciente. La canalización solo puede revertirse a una ejecución anterior si dicha ejecución anterior se inició en la versión actual de la estructura de canalización. Dado que la configuración de reversión automática forma parte de la definición de canalización, la etapa de canalización se revertirá automáticamente solo después de que se produzca una ejecución correcta de la canalización en la etapa de canalización.
## Configuración de una etapa para la reversión automática (consola)
Puede revertir una etapa a una ejecución anterior que se realizara correctamente. Para obtener más información, consulta [RollbackStage](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RollbackStage.html)la *Guía CodePipeline de API*.
**Configuración de una etapa para la reversión automática (consola)**
1. Inicie sesión en la CodePipeline consola Consola de administración de AWS y ábrala en [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).
Se muestran los nombres y el estado de todas las canalizaciones asociadas a tu AWS cuenta.
1. En **Nombre**, elija el nombre de la canalización que desea editar.
1. En la página de detalles de la canalización, elija **Edit**.
1. En la página **Editar**, para la acción que desee editar, elija **Editar etapa**.
1. Seleccione **Configuración automatizada de escenarios** y, a continuación, seleccione **Configurar la reversión automática en caso de fallo en una etapa**. Guarde los cambios en la canalización.
![\[Un ejemplo de pantalla de edición para configurar una etapa revertida en CodePipeline.\]](http://docs.aws.amazon.com/es_es/codepipeline/latest/userguide/images/rollback-configure.png)
## Configuración de una etapa para la reversión automática (CLI)
AWS CLI Para configurar una etapa fallida y volver automáticamente a la ejecución correcta más reciente, utilice los comandos para crear o actualizar una canalización tal y como se detalla en [Creación de una canalización, etapas y acciones](pipelines-create.md) y[Editar una canalización en CodePipeline](pipelines-edit.md).
+ Abra un terminal (Linux, macOS o Unix) o el símbolo del sistema (Windows) y utilice la AWS CLI para ejecutar el comando `update-pipeline`, especificando la condición de fallo en la estructura de canalización. En el siguiente ejemplo se configura la reversión automática de una etapa denominada `S3Deploy`:
```
{
"name": "S3Deploy",
"actions": [
{
"name": "s3deployaction",
"actionTypeId": {
"category": "Deploy",
"owner": "AWS",
"provider": "S3",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BucketName": "static-website-bucket",
"Extract": "false",
"ObjectKey": "SampleApp.zip"
},
"outputArtifacts": [],
"inputArtifacts": [
{
"name": "SourceArtifact"
}
],
"region": "us-east-1"
}
],
"onFailure": {
"result": "ROLLBACK"
}
}
```
Para obtener más información sobre la configuración de las condiciones de error para la reversión de etapas, consulta [FailureConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_FailureConditions.html)la *referencia de la CodePipeline API*.
## Configuración de una etapa para la reversión automática (CloudFormation)
Para configurar una etapa CloudFormation para que se revierta automáticamente en caso de fallo, utilice el `OnFailure` parámetro. En caso de fallo, la etapa se revertirá automáticamente a la ejecución correcta más reciente.
```
OnFailure:
Result: ROLLBACK
```
+ Actualice la plantilla como se muestra en el fragmento de código siguiente. En el siguiente ejemplo se configura la reversión automática de una etapa denominada `Release`:
```
AppPipeline:
Type: AWS::CodePipeline::Pipeline
Properties:
RoleArn:
Ref: CodePipelineServiceRole
Stages:
-
Name: Source
Actions:
-
Name: SourceAction
ActionTypeId:
Category: Source
Owner: AWS
Version: 1
Provider: S3
OutputArtifacts:
-
Name: SourceOutput
Configuration:
S3Bucket:
Ref: SourceS3Bucket
S3ObjectKey:
Ref: SourceS3ObjectKey
RunOrder: 1
-
Name: Release
Actions:
-
Name: ReleaseAction
InputArtifacts:
-
Name: SourceOutput
ActionTypeId:
Category: Deploy
Owner: AWS
Version: 1
Provider: CodeDeploy
Configuration:
ApplicationName:
Ref: ApplicationName
DeploymentGroupName:
Ref: DeploymentGroupName
RunOrder: 1
OnFailure:
Result: ROLLBACK
ArtifactStore:
Type: S3
Location:
Ref: ArtifactStoreS3Location
EncryptionKey:
Id: arn:aws:kms:useast-1:ACCOUNT-ID:key/KEY-ID
Type: KMS
DisableInboundStageTransitions:
-
StageName: Release
Reason: "Disabling the transition until integration tests are completed"
Tags:
- Key: Project
Value: ProjectA
- Key: IsContainerBased
Value: 'true'
```
Para obtener más información sobre la configuración de las condiciones de fallo para la reversión de etapas, consulte la [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)sección siguiente `StageDeclaration` de la *Guía del CloudFormation usuario*.