As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar um estágio para reversão automática
<a name="stage-rollback-auto"></a>

Você pode configurar estágios em um pipeline para reverter automaticamente em caso de falha. Em caso de falha, o estágio retorna à execução bem-sucedida mais recente. O pipeline só pode realizar a reversão para uma execução anterior caso ela tenha sido iniciada na versão vigente da estrutura do pipeline. A configuração de reversão automática integra a definição do pipeline, portanto, o estágio do pipeline só executará a reversão automática após uma execução bem-sucedida no respectivo estágio.

## Configurar um estágio para reversão automática (console)
<a name="stage-rollback-auto-console"></a>

É possível reverter um estágio para uma execução anterior bem-sucedida definida. Para obter mais informações, consulte [RollbackStage](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_RollbackStage.html)o *Guia CodePipeline da API*.

**Configurar um estágio para reversão automática (console)**

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

   Os nomes e o status de todos os pipelines associados à sua AWS conta são exibidos. 

1. Em **Nome**, selecione o nome do pipeline que você deseja editar.

1. Na página de detalhes do pipeline, selecione **Editar**. 

1. Na página **Editar**, para a ação que você deseja editar, escolha **Editar estágio**.

1. Escolha **Configuração de etapa automatizada:** e **Configurar reversão automática em caso de falha de estágio**. Salve as alterações no pipeline.  
![\[Um exemplo de tela de edição para configurar um estágio revertido CodePipeline.\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/rollback-configure.png)

## Configurar um estágio para reversão automática (CLI)
<a name="stage-rollback-auto-cli"></a>

Para usar o AWS CLI para configurar um estágio com falha para reverter automaticamente para a execução bem-sucedida mais recente, use os comandos para criar ou atualizar um pipeline conforme detalhado em [Criar um pipeline, estágios e ações](pipelines-create.md) [Editar um pipeline no CodePipeline](pipelines-edit.md) e.
+ Abra um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows) e use o AWS CLI para executar o comando `update-pipeline`, especificando a condição de falha na estrutura do pipeline. O exemplo a seguir configura a reversão automática para um estágio chamado `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 obter mais informações sobre como configurar condições de falha para reversão de estágio, consulte a Referência da [FailureConditions](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_FailureConditions.html)CodePipeline API.*

## Configurar um estágio para reversão automática (CloudFormation)
<a name="stage-rollback-auto-cfn"></a>

 CloudFormation Para configurar um estágio para reverter automaticamente em caso de falha, use o `OnFailure` parâmetro. Em caso de falha, o estágio retornará automaticamente para à última execução bem-sucedida.

```
OnFailure:
     Result: ROLLBACK
```
+ Atualize o modelo conforme mostrado no snippet a seguir. O exemplo a seguir configura a reversão automática para um estágio chamado `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 obter mais informações sobre como configurar condições de falha para reversão de estágio, consulte [OnFailure](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codepipeline-pipeline-stagedeclaration.html#cfn-codepipeline-pipeline-stagedeclaration-onfailure)abaixo `StageDeclaration` no Guia do CloudFormation usuário.*