Reverter um estágio manualmente - AWS CodePipeline
Reverter um estágio manualmente (console)Reverter um estágio manualmente (CLI)

Reverter um estágio manualmente

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

Reverter um estágio manualmente (console)

É 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 AWS Management Console e abra o console do CodePipeline em http://console.aws.amazon.com/codesuite/codepipeline/home.

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

  2. Em Nome, selecione o pipeline que contém o estágio a ser revertido.

    Um exemplo de diagrama de um pipeline com dois estágios no CodePipeline.

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

  4. 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 escolha do ID de execução de destino no CodePipeline.

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 um pipeline com um estágio revertido no CodePipeline.

Reverter um estágio manualmente (CLI)

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

Também é possível reverter um estágio manualmente, conforme detalhado em Reverter um estágio manualmente.

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 comando list-pipeline-executions 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 a AWS CLI para executar o comando list-pipeline-executions, especificando o nome do pipeline aplicando o filtro para execuções bem-sucedidas no estágio. Neste caso, o resultado exibirá as execuções do pipeline denominado MyFirstPipeline, bem como as execuções bem-sucedidas no estágio identificado como 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.

  2. 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 Implantar 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.