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á.

# Reverter um estágio manualmente
<a name="stage-rollback-manual"></a>

É possível realizar a reversão manual de um estágio por meio do console ou da CLI. 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.

Também é possível configurar um estágio para realizar a reversão automática em situações de falha, conforme especificado em [Configurar um estágio para reversão automática](stage-rollback-auto.md). 

## Reverter um estágio manualmente (console)
<a name="stage-rollback-console"></a>

É possível utilizar o console para realizar manualmente a reversão de um estágio para uma execução de pipeline específica. Quando um estágio é revertido, um rótulo **Reversão** é exibido na visualização do pipeline no console.

**Reverter um estágio manualmente (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 pipeline que contém o estágio a ser revertido.  
![Um exemplo de diagrama de uma tubulação com dois estágios CodePipeline.](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/rollback-stage-first.png)

1. No estágio, selecione **Iniciar reversão**. A página **Reverter para** é exibida.

1. Selecione a execução de destino para onde deseja reverter o estágio.
**nota**  
A lista de execuções de pipeline disponíveis como destino incluirá todas as execuções iniciadas na versão atual do pipeline desde 1º de fevereiro de 2024.  
![Um exemplo de como escolher o ID de execução de destino em CodePipeline.](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/rollback-stage-dialog.png)

O diagrama a seguir ilustra um exemplo de estágio que foi revertido, exibindo o novo ID de execução.

![Um exemplo de diagrama de uma tubulação com um estágio revertido CodePipeline.](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/stage-rolled-back.png)


## Reverter um estágio manualmente (CLI)
<a name="stage-rollback-cli"></a>

Para usar o AWS CLI para reverter manualmente um estágio, use o `rollback-stage` comando. 

Também é possível reverter um estágio manualmente, conforme detalhado em [Reverter um estágio manualmente](#stage-rollback-manual). 

**nota**  
A lista de execuções de pipeline disponíveis como destino incluirá todas as execuções iniciadas na versão atual do pipeline desde 1º de fevereiro de 2024.

**Como reverter um estágio manualmente (CLI)**

1. Para realizar a reversão manual via CLI, será necessário fornecer o ID de execução de uma execução de pipeline bem-sucedida previamente concluída no estágio. Para obter o ID de execução do pipeline de destino que você especificará, use o list-pipeline-executions comando com um filtro que retornará as execuções bem-sucedidas no estágio. Abra um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows) e use o AWS CLI para executar o `list-pipeline-executions` comando, especificando o nome do pipeline e o filtro para execuções bem-sucedidas no estágio. Neste exemplo, a saída listará as execuções do pipeline para o pipeline nomeado MyFirstPipeline e para as execuções bem-sucedidas no estágio nomeado. `deploys3` 

   ```
   aws codepipeline list-pipeline-executions --pipeline-name MyFirstPipeline --filter succeededInStage={stageName=deploys3}
   ```

   Na saída, copie o ID da execução bem-sucedida anterior que você deseja especificar para reversão. Você o usará na próxima etapa como ID de execução de destino.

1. Acesse um terminal (Linux, macOS ou Unix) ou o prompt de comando (Windows) e use o AWS CLI para executar o comando `rollback-stage`, especificando o nome do pipeline, o nome do estágio e a execução de destino que será utilizada para a reversão. Por exemplo, para reverter um estágio chamado Deploy para um pipeline chamado{{MyFirstPipeline}}: 

   ```
   aws codepipeline rollback-stage --pipeline-name MyFirstPipeline --stage-name Deploy --target-pipeline-execution-id bc022580-4193-491b-8923-9728dEXAMPLE 
   ```

   A saída apresenta o ID da nova execução após a reversão. Trata-se de um ID distinto que aproveita as revisões de origem e os parâmetros da execução de destino definida.