기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 스테이지를 수동으로 롤백
<a name="stage-rollback-manual"></a>

콘솔 또는 CLI를 사용하여 스테이지를 수동으로 롤백할 수 있습니다. 파이프라인은 현재 파이프라인 구조 버전에서 이전 실행이 시작된 경우에만 이전 실행으로 롤백할 수 있습니다.

[자동 롤백을 위한 스테이지 구성](stage-rollback-auto.md)에 설명된 대로 실패 시 자동으로 롤백하도록 스테이지를 구성할 수도 있습니다.

## 스테이지를 수동으로 롤백(콘솔)
<a name="stage-rollback-console"></a>

콘솔을 사용하여 스테이지를 대상 파이프라인 실행으로 수동으로 롤백할 수 있습니다. 스테이지가 롤백되면 콘솔의 파이프라인 시각화에 **롤백** 레이블이 표시됩니다.

**스테이지를 수동으로 롤백(콘솔)**

1. 에 로그인 AWS Management Console 하고 [http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home) CodePipeline 콘솔을 엽니다.

    AWS 계정과 연결된 모든 파이프라인의 이름과 상태가 표시됩니다.

1. **이름**에서 롤백할 스테이지가 있는 파이프라인의 이름을 선택합니다.  
![\[CodePipeline에 두 스테이지가 있는 파이프라인의 예제 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/codepipeline/latest/userguide/images/rollback-stage-first.png)

1. 스테이지에서 **롤백 시작**을 선택합니다. 페이지로 **롤백**이 표시됩니다.

1. 스테이지를 롤백할 대상 실행을 선택합니다.
**참고**  
사용 가능한 대상 파이프라인 실행 목록은 2024년 2월 1일부터 현재 파이프라인 버전의 모든 실행입니다.  
![\[CodePipeline에서 대상 실행 ID를 선택하는 예제입니다.\]](http://docs.aws.amazon.com/ko_kr/codepipeline/latest/userguide/images/rollback-stage-dialog.png)

다음 다이어그램은 새 실행 ID로 롤백된 스테이지의 예를 보여줍니다.

![\[CodePipeline에 롤백된 스테이지가 있는 파이프라인의 예제 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/codepipeline/latest/userguide/images/stage-rolled-back.png)


## 스테이지를 수동으로 롤백(CLI)
<a name="stage-rollback-cli"></a>

 AWS CLI 를 사용하여 스테이지를 수동으로 롤백하려면 `rollback-stage` 명령을 사용합니다.

[스테이지를 수동으로 롤백](#stage-rollback-manual)에 설명된 대로 스테이지를 수동으로 롤백할 수도 있습니다.

**참고**  
사용 가능한 대상 파이프라인 실행 목록은 2024년 2월 1일부터 현재 파이프라인 버전의 모든 실행입니다.

**스테이지를 수동으로 롤백하려면(CLI)**

1. 수동 롤백을 위한 CLI 명령에는 스테이지에서 이전에 성공한 파이프라인 실행의 실행 ID가 필요합니다. 지정할 대상 파이프라인 실행 ID를 가져오려면 스테이지에서 성공적인 실행을 반환하는 필터와 함께 list-pipeline-executions 명령을 사용합니다. 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고를 사용하여 `list-pipeline-executions` 명령을 실행하고 파이프라인의 이름과 단계에서 성공적으로 실행 AWS CLI 하기 위한 필터를 지정합니다. 이 예제에서는 출력에 MyFirstPipeline이라는 파이프라인의 파이프라인 실행과 `deploys3`라는 스테이지에서의 성공적인 실행이 나열됩니다.

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

   출력에서 롤백에 지정하려는 이전에 성공한 실행의 실행 ID를 복사합니다. 다음 단계에서는 이를 대상 실행 ID로 사용합니다.

1. 터미널(Linux, macOS 또는 Unix) 또는 명령 프롬프트(Windows)를 열고 AWS CLI 를 사용하여 `rollback-stage` 명령을 실행하고, 파이프라인의 이름과 스테이지의 이름, 롤백하려는 대상 실행을 지정합니다. 예를 들어 *MyFirstPipeline*이라는 파이프라인에 배포라는 스테이지를 롤백하려면 다음을 입력합니다.

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

   출력은 새 롤백 실행의 실행 ID를 반환합니다. 이는 지정된 대상 실행의 소스 개정 및 파라미터를 사용하는 별도의 ID입니다.