Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 워크플로 실행에 대한 승인 요구
워크플로 실행을 구성하여 진행하기 전에 승인이 필요하도록 할 수 있습니다. 이렇게 하려면 워크플로에 **승인** [게이트](workflows-gates.md)를 추가해야 합니다. *승인 게이트*는 사용자 또는 사용자 집합이 CodeCatalyst 콘솔에서 하나 이상의 승인을 제출할 때까지 워크플로가 진행되지 않도록 합니다. 모든 승인이 제공되면 게이트가 '잠금 해제됨' 상태가 되고 워크플로 실행을 재개할 수 있습니다.
워크플로의 **승인** 게이트를 사용하여 개발, 운영 및 리더십 팀이 변경 사항을 더 많은 대상에 배포하기 전에 검토할 수 있는 기회를 제공합니다.
워크플로 실행에 대한 자세한 내용은 [워크플로 실행](workflows-working-runs.md) 섹션을 참조하세요.
**Topics**
+ [승인 게이트를 잠금 해제하려면 어떻게 해야 하나요?](#workflows-approval-conditions)
+ ['승인' 게이트를 사용해야 하는 경우](#workflows-approval-when)
+ [누가 승인을 제공할 수 있나요?](#workflows-approval-who)
+ [사용자에게 승인이 필요함을 알리려면 어떻게 해야 하나요?](#workflows-approval-notify-methods)
+ ['승인' 게이트를 사용하여 워크플로 실행이 시작되지 않도록 할 수 있나요?](#workflows-approval-prevent)
+ [워크플로 승인은 대기 중 실행, 대체된 실행 및 병렬 실행 모드에서 어떻게 작동하나요?](#workflows-approval-run-mode)
+ [예시: '승인' 게이트](workflows-approval-example.md)
+ ['승인' 게이트 추가](workflows-approval-add.md)
+ [승인 알림 구성](workflows-approval-notify.md)
+ [워크플로 실행 승인 또는 거부](workflows-approval-approve.md)
+ ['승인' 게이트 YAML](approval-ref.md)
## 승인 게이트를 잠금 해제하려면 어떻게 해야 하나요?
**승인** 게이트를 잠금 해제하려면 다음 조건을 *모두* 충족해야 합니다.
+ **조건 1**: 필요한 승인 수를 제출해야 합니다. 필요한 승인 수는 구성 가능하며 각 사용자는 단일 승인을 제출할 수 있습니다.
+ **조건 2**: 게이트 제한 시간 전에 모든 승인을 제출해야 합니다. 게이트는 활성화되고 14일 후에 시간 초과됩니다. 이 기간은 구성할 수 없습니다.
+ **조건 3**: 아무도 워크플로 실행을 거부해서는 안 됩니다. 단일 거부로 인해 워크플로 실행이 실패합니다.
+ **조건 4**: (대체된 실행 모드를 사용하는 경우에만 적용됩니다.) 이후 실행으로 실행을 대체해서는 안 됩니다. 자세한 내용은 [워크플로 승인은 대기 중 실행, 대체된 실행 및 병렬 실행 모드에서 어떻게 작동하나요?](#workflows-approval-run-mode) 섹션을 참조하세요.
조건이 충족되지 않으면 CodeCatalyst는 워크플로를 중지하고 실행 상태를 **실패**(**조건 1**\$1**3**의 경우) 또는 **대체됨**(**조건 4**의 경우)으로 설정합니다.
## '승인' 게이트를 사용해야 하는 경우
일반적으로 애플리케이션 및 기타 리소스를 프로덕션 서버 또는 품질 표준을 검증해야 하는 환경에 배포하는 워크플로에서 **승인** 게이트를 사용합니다. 프로덕션으로 배포하기 전에 게이트를 배치하면 검토자가 새 소프트웨어 개정을 공개적으로 사용할 수 있게 되기 전에 검증할 수 있습니다.
## 누가 승인을 제공할 수 있나요?
프로젝트의 멤버가고 **기여자** 또는 **프로젝트 관리자** 역할이 있는 모든 사용자는 승인을 제공할 수 있습니다. 프로젝트 스페이스에 속한 **스페이스 관리자** 역할을 가진 사용자도 승인을 제공할 수 있습니다.
**참고**
**검토자** 역할을 가진 사용자는 승인을 제공할 수 없습니다.
## 사용자에게 승인이 필요함을 알리려면 어떻게 해야 하나요?
사용자에게 승인이 필요함을 알리려면 다음을 수행해야 합니다.
+ CodeCatalyst가 Slack 알림을 보내도록 합니다. 자세한 내용은 [승인 알림 구성](workflows-approval-notify.md) 섹션을 참조하세요.
+ **승인** 및 **거부** 버튼이 있는 CodeCatalyst 콘솔의 페이지로 이동하여 해당 페이지의 URL을 승인자에게 전달되는 이메일 또는 메시징 애플리케이션에 붙여넣습니다. 이 페이지로 이동하는 방법에 대한 자세한 내용은 [워크플로 실행 승인 또는 거부](workflows-approval-approve.md) 섹션을 참조하세요.
## '승인' 게이트를 사용하여 워크플로 실행이 시작되지 않도록 할 수 있나요?
예, 자격 조건이 있습니다. 자세한 내용은 [게이트를 사용하여 워크플로 실행이 시작되지 않도록 할 수 있나요?](workflows-gates.md#workflows-gates-prevent) 섹션을 참조하세요.
## 워크플로 승인은 대기 중 실행, 대체된 실행 및 병렬 실행 모드에서 어떻게 작동하나요?
대기 중, 대체된, 병렬로 실행 모드를 사용하는 경우 **승인** 게이트는 [작업](workflows-actions.md)과 유사한 방식으로 작동합니다. 이러한 실행 모드를 숙지하려면 [대기 중 실행 모드 정보](workflows-configure-runs.md#workflows-configure-runs-queued), [대체된 실행 모드 정보](workflows-configure-runs.md#workflows-configure-runs-superseded), [병렬 실행 모드 정보](workflows-configure-runs.md#workflows-configure-runs-parallel) 섹션을 읽는 것이 좋습니다. 이러한 실행 모드에 대한 기본적인 이해가 되면 이 섹션으로 돌아가서 **승인** 게이트가 있을 때 이러한 실행 모드가 어떻게 작동하는지 알아봅니다.
**승인** 게이트가 있으면 다음과 같이 실행이 처리됩니다.
+ [대기 중 실행 모드](workflows-configure-runs.md#workflows-configure-runs-queued)를 사용하는 경우 실행은 현재 게이트에서 승인을 기다리고 있는 실행 뒤에 대기합니다. 해당 게이트가 잠금 해제되면(즉, 모든 승인이 제공됨) 대기열의 다음 실행이 게이트로 진행되고 승인을 기다립니다. 이 프로세스는 대기 중 실행이 게이트를 통해 하나씩 처리되는 동안 계속됩니다. [Figure 1](#figure-1-workflow-queued-run-mode-ma)는 이 프로세스를 보여줍니다.
+ [대체된 실행 모드](workflows-configure-runs.md#workflows-configure-runs-superseded)를 사용하는 경우 동작은 대기열에 있는 실행 모드의 동작과 동일합니다. 단, 게이트에서 대기열에 파일을 쌓는 대신 새 실행이 이전 실행을 대체(인수)합니다. 대기열이 없으며 현재 게이트에서 승인을 기다리고 있는 모든 실행은 취소되고 최신 실행으로 대체됩니다. [Figure 2](#figure-2-workflow-superseded-run-mode-ma)는 이 프로세스를 보여줍니다.
+ [병렬 실행 모드](workflows-configure-runs.md#workflows-configure-runs-parallel)를 사용하는 경우 실행이 병렬로 시작되며 대기열이 형성되지 않습니다. 앞에 실행이 없으므로 각 실행은 게이트에서 즉시 처리됩니다. [Figure 3](#figure-3-workflow-parallel-run-mode-ma)는 이 프로세스를 보여줍니다.
**그림 1**: '대기 중 실행 모드' 및 **승인** 게이트
![\['승인' 게이트가 '대기 중 실행 모드'와 작동하는 방법\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/flows/runmode-queued-ma.png)
**그림 2**: '대체된 실행 모드' 및 **승인** 게이트
![\['승인' 게이트가 '대체된 실행 모드'와 작동하는 방식\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/flows/runmode-superseded-ma.png)
**그림 3**: '병렬 실행 모드' 및 **승인** 게이트
![\['승인' 게이트가 '병렬 실행 모드'로 작동하는 방법\]](http://docs.aws.amazon.com/ko_kr/codecatalyst/latest/userguide/images/flows/runmode-parallel-ma.png)
# 예시: '승인' 게이트
다음 예시는 `Staging`과 `Production`이라는 두 작업 사이에 `Approval_01`라는 **승인** 게이트를 추가하는 방법을 보여줍니다. `Staging` 작업이 먼저 실행되고, `Approval_01` 게이트가 두 번째로 실행되며, `Production` 작업이 마지막으로 실행됩니다. `Production` 작업은 `Approval_01` 게이트가 잠금 해제된 경우에만 실행됩니다. `DependsOn` 속성은 `Staging`, `Approval_01` 및 `Production` 단계가 순차적으로 실행되도록 합니다.
**승인** 게이트에 대한 자세한 내용은 [워크플로 실행에 대한 승인 요구](workflows-approval.md) 섹션을 참조하세요.
```
Actions:
Staging: # Deploy to a staging server
Identifier: aws/ecs-deploy@v1
Configuration:
...
Approval_01:
Identifier: aws/approval@v1
DependsOn:
- Staging
Configuration:
ApprovalsRequired: 2
Production: # Deploy to a production server
Identifier: aws/ecs-deploy@v1
DependsOn:
- Approval_01
Configuration:
...
```
# '승인' 게이트 추가
승인이 필요하도록 워크플로를 구성하려면 워크플로에 **승인** 게이트를 추가해야 합니다. 다음 지침에 따라 워크플로에 **승인** 게이트를 추가합니다.
이 게이트에 대한 자세한 내용은 [워크플로 실행에 대한 승인 요구](workflows-approval.md) 섹션을 참조하세요.
------
#### [ Visual ]
**워크플로에 '승인' 게이트 추가(시각적 편집기)**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 프로젝트를 선택합니다.
1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.
1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.
1. **편집**을 선택합니다.
1. 왼쪽 상단에서 **게이트**를 선택합니다.
1. **게이트** 카탈로그의 **승인** 에서 더하기 기호(**\$1**)를 선택합니다.
1. **입력**을 선택하고 **종속 대상** 필드에서 다음을 수행합니다.
이 게이트를 실행하기 위해 성공적으로 실행해야 하는 작업, 작업 그룹 또는 게이트를 지정합니다. 기본적으로 워크플로에 게이트를 추가할 때 게이트는 워크플로의 마지막 작업에 따라 달라지도록 설정됩니다. 이 속성을 제거하면 게이트가 다른 작업에 종속되지 않고 다른 작업보다 먼저 실행됩니다.
**참고**
작업, 작업 그룹 또는 게이트 전후에 실행되도록 게이트를 구성해야 합니다. 다른 작업, 작업 그룹 및 게이트와 동시에 실행되도록 설정할 수 없습니다.
**Depends on** 함수에 대한 자세한 내용은 [게이트 및 작업 순서 지정](workflows-gates-depends-on.md) 섹션을 참조하세요.
1. **구성** 탭을 선택합니다.
1. **게이트 이름** 필드에서 다음을 수행합니다.
게이트에 부여할 이름을 지정합니다. 모든 게이트 이름은 워크플로 내에서 고유해야 합니다. 게이트 이름은 영숫자 문자(a-z, A-Z, 0-9), 하이픈(-) 및 밑줄(\$1)로 제한됩니다. 스페이스는 허용되지 않습니다. 게이트 이름에서 특수 문자와 공백을 활성화하는 데 따옴표를 사용할 수 없습니다.
1. (선택 사항) **승인 수** 필드에서 다음을 수행합니다.
**승인** 게이트를 잠금 해제하는 데 필요한 최소 승인 수를 지정합니다. 최소값은 `1`입니다. 최대값은 `2`입니다. 생략 시 기본값은 `1`입니다.
**참고**
`ApprovalsRequired` 속성을 생략하려면 워크플로 정의 파일에서 게이트 `Configuration` 섹션을 제거합니다.
1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.
1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.
------
#### [ YAML ]
**워크플로에 '승인' 게이트 추가(YAML 편집기)**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 프로젝트를 선택합니다.
1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.
1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.
1. **편집**을 선택합니다.
1. **YAML**을 선택합니다.
1. 다음 예시를 가이드로 사용하여 `Approval` 섹션 및 기본 속성을 추가합니다. 자세한 내용은 [워크플로 YAML 정의](workflow-reference.md)의 ['승인' 게이트 YAML](approval-ref.md)를 참조하세요.
```
Actions:
MyApproval_01:
Identifier: aws/approval@v1
DependsOn:
- PreviousAction
Configuration:
ApprovalsRequired: 2
```
다른 예시는 [예시: '승인' 게이트](workflows-approval-example.md)를 참조하세요.
1. (선택 사항) 커밋하기 전에 워크플로의 YAML 코드를 검증하려면 **검증**을 선택합니다.
1. **커밋**을 선택하고 커밋 메시지를 입력한 다음 **커밋**을 다시 선택합니다.
------
# 승인 알림 구성
CodeCatalyst가 워크플로 실행에 승인이 필요하다는 알림을 사용자에게 Slack 채널로 보내도록 할 수 있습니다. 사용자는 알림을 보고 해당 알림 내에 있는 링크를 클릭합니다. 이 링크는 워크플로를 승인하거나 거부할 수 있는 CodeCatalyst 승인 페이지로 이동합니다.
워크플로가 승인되었거나 거부되었거나 승인 요청이 만료되었음을 사용자에게 알리도록 알림을 구성할 수도 있습니다.
다음 지침에 따라 Slack 알림을 설정합니다.
**시작하기 전 준비 사항**
워크플로에 **승인** 게이트를 추가했는지 확인합니다. 자세한 내용은 ['승인' 게이트 추가](workflows-approval-add.md) 섹션을 참조하세요.
**Slack 채널로 워크플로 승인 알림 보내기**
1. Slack을 사용하여 CodeCatalyst를 구성합니다. 자세한 내용은 [스택 알림 시작하기](getting-started-notifications.md) 섹션을 참조하세요.
1. 승인이 필요한 워크플로가 포함된 CodeCatalyst 프로젝트에서 알림이 아직 활성화되어 있지 않은 경우 활성화합니다. 알림을 활성화하려면:
1. 프로젝트로 이동하고 탐색 창에서 **프로젝트 설정**을 선택합니다.
1. 상단에서 **알림**을 선택합니다.
1. **알림 이벤트**에서 **알림 편집**을 선택합니다.
1. **워크플로 승인 보류**를 켜고 CodeCatalyst가 알림을 보낼 Slack 채널을 선택합니다.
1. (선택 사항) 승인, 거부 및 만료된 승인에 대해 사용자에게 알리려면 추가 알림을 켭니다. **워크플로 실행 승인됨**, **워크플로 실행 거부됨**, **워크플로 승인 대체됨** 및 **워크플로 승인 제한 시간 초과됨**을 설정할 수 있습니다. 각 알림 옆에서 CodeCatalyst가 알림을 보낼 Slack 채널을 선택합니다.
1. **저장**을 선택합니다.
# 워크플로 실행 승인 또는 거부
**승인** 게이트가 포함된 워크플로 실행은 승인 또는 거부되어야 합니다. 사용자는 다음 시점부터 승인 또는 거부를 제공할 수 있습니다.
+ CodeCatalyst 콘솔
+ 팀원이 제공하는 링크
+ 자동 Slack 알림
사용자가 승인 또는 거부의 의사를 밝힌 후에는 이 결정을 되돌릴 수 없습니다.
**참고**
특정 사용자만 워크플로 실행을 승인하거나 거부할 수 있습니다. 자세한 내용은 [누가 승인을 제공할 수 있나요?](workflows-approval.md#workflows-approval-who) 섹션을 참조하세요.
**시작하기 전 준비 사항**
워크플로에 **승인** 게이트를 추가했는지 확인합니다. 자세한 내용은 ['승인' 게이트 추가](workflows-approval-add.md) 섹션을 참조하세요.
**CodeCatalyst 콘솔에서 시작하는 워크플로 실행 승인 또는 거부**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.
1. 프로젝트를 선택합니다.
1. 탐색 창에서 **CI/CD**를 선택한 다음 **워크플로**를 선택합니다.
1. 워크플로의 이름을 선택합니다. 소스 리포지토리 또는 워크플로가 정의된 브랜치 이름을 기준으로 필터링하거나, 워크플로 이름 또는 상태를 기준으로 필터링할 수 있습니다.
1. 워크플로 다이어그램에서 **승인** 게이트를 나타내는 상자를 선택합니다.
측면 패널이 나타납니다.
**참고**
이때 원한다면 이 페이지의 URL을 다른 승인자에게 보낼 수 있습니다.
1. **검토 결정**에서 **승인** 또는 **거부**를 선택합니다.
1. (선택 사항) **설명 - 선택 사항**에 워크플로 실행을 승인하거나 거부한 이유를 나타내는 설명을 입력합니다.
1. **제출**을 선택합니다.
**팀원이 제공한 링크에서 시작하는 워크플로 실행 승인 또는 거부**
1. 팀원이 전송한 링크를 선택합니다. (팀원에게 위의 절차를 읽고 링크를 받도록 할 수 있습니다.)
1. 메시지가 표시되면 CodeCatalyst에 로그인합니다.
워크플로 실행 승인 페이지로 리디렉션됩니다.
1. **검토 결정**에서 **승인** 또는 **거부**를 선택합니다.
1. (선택 사항) **설명 - 선택 사항**에 워크플로 실행을 승인하거나 거부한 이유를 나타내는 설명을 입력합니다.
1. **제출**을 선택합니다.
**자동 Slack 알림에서 시작하는 워크플로 실행 승인 또는 거부**
1. Slack 알림이 설정되어 있는지 확인합니다. [승인 알림 구성](workflows-approval-notify.md)을(를) 참조하세요.
1. Slack의 승인 알림이 전송된 채널에서 승인 알림의 링크를 선택합니다.
1. 메시지가 표시되면 CodeCatalyst에 로그인합니다.
워크플로 실행 페이지로 리디렉션됩니다.
1. 워크플로 다이어그램에서 승인 게이트를 선택합니다.
1. **검토 결정**에서 **승인** 또는 **거부**를 선택합니다.
1. (선택 사항) **설명 - 선택 사항**에 워크플로 실행을 승인하거나 거부한 이유를 나타내는 설명을 입력합니다.
1. **제출**을 선택합니다.
# '승인' 게이트 YAML
다음은 **승인** 게이트의 YAML 정의입니다. 이 게이트에 대해 자세히 알아보려면 [워크플로 실행에 대한 승인 요구](workflows-approval.md) 섹션을 참조하세요.
이 작업 정의는 더 광범위한 워크플로 정의 파일 내의 섹션으로 존재합니다. 이 파일에 대한 자세한 내용은 [워크플로 YAML 정의](workflow-reference.md)을 참조합니다.
**참고**
이어지는 대부분의 YAML 속성에는 시각적 편집기에 해당 UI 요소가 있습니다. UI 요소를 찾으려면 **Ctrl\$1F**를 사용합니다. 요소가 연결된 YAML 속성과 함께 나열됩니다.
```
# The workflow definition starts here.
# See 최상위 속성 for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The 'Approval' gate definition starts here.
Approval:
Identifier: aws/approval@v1
DependsOn:
- another-action
Configuration:
ApprovalsRequired: number
```
## Approval
(필수)
게이트에 부여할 이름을 지정합니다. 모든 게이트 이름은 워크플로 내에서 고유해야 합니다. 게이트 이름은 영숫자 문자(a-z, A-Z, 0-9), 하이픈(-) 및 밑줄(\$1)로 제한됩니다. 스페이스는 허용되지 않습니다. 게이트 이름에서 특수 문자와 공백을 활성화하는 데 따옴표를 사용할 수 없습니다.
기본값: `Approval_nn`.
해당 UI: 구성 탭/**게이트 이름**
## Identifier
(*Approval*/**Identifier**)
(필수)
게이트를 식별합니다. **승인** 게이트는 버전 `1.0.0`을 지원합니다. 버전을 단축하려는 경우가 아니면 이 속성을 변경하지 마세요. 자세한 내용은 [사용할 작업 버전 지정](workflows-action-versions.md) 섹션을 참조하세요.
기본값: `aws/approval@v1`.
해당 UI: 워크플로 다이어그램/Approval\$1nn/**aws/approval@v1** 레이블
## DependsOn
(*Approval*/**DependsOn**)
(선택 사항)
이 게이트를 실행하기 위해 성공적으로 실행해야 하는 작업, 작업 그룹 또는 게이트를 지정합니다. 기본적으로 워크플로에 게이트를 추가할 때 게이트는 워크플로의 마지막 작업에 따라 달라지도록 설정됩니다. 이 속성을 제거하면 게이트가 다른 작업에 종속되지 않고 다른 작업보다 먼저 실행됩니다.
**참고**
작업, 작업 그룹 또는 게이트 전후에 실행되도록 게이트를 구성해야 합니다. 다른 작업, 작업 그룹 및 게이트와 동시에 실행되도록 설정할 수 없습니다.
**Depends on** 함수에 대한 자세한 내용은 [게이트 및 작업 순서 지정](workflows-gates-depends-on.md) 섹션을 참조하세요.
해당 UI: 입력 탭/**의존**
## Configuration
(*Approval*/**Configuration**)
(선택 사항)
게이트의 구성 속성을 정의할 수 있는 섹션입니다.
해당 UI: **구성** 탭
## ApprovalsRequired
(*Approval*/Configuration/**ApprovalsRequired**)
(선택 사항)
**승인** 게이트를 잠금 해제하는 데 필요한 최소 승인 수를 지정합니다. 최소값은 `1`입니다. 최대값은 `2`입니다. 생략 시 기본값은 `1`입니다.
**참고**
`ApprovalsRequired` 속성을 생략하려면 워크플로 정의 파일에서 게이트 `Configuration` 섹션을 제거합니다.
해당 UI: 구성 탭/**승인 수**