워크플로에 트리거 추가

다음 지침에 따라 Amazon CodeCatalyst 워크플로에 푸시, 풀 또는 스케줄 트리거를 추가하십시오.

트리거에 대한 자세한 내용은 트리거를 사용하여 자동으로 워크플로 실행 시작 주제를 참조하십시오.

Visual

트리거를 추가하려면 (비주얼 에디터)

https://codecatalyst.aws/ 에서 CodeCatalyst 콘솔을 엽니다.
프로젝트를 선택합니다.
탐색 창에서 CI/CD를 선택한 다음 워크플로를 선택합니다.
워크플로의 이름을 선택합니다. 워크플로가 정의된 소스 리포지토리 또는 브랜치 이름을 기준으로 필터링하거나 워크플로 이름 또는 상태별로 필터링할 수 있습니다.
편집을 선택합니다.
Visual을 선택합니다.
워크플로 다이어그램에서 소스 및 트리거 상자를 선택합니다.
구성 창에서 트리거 추가를 선택합니다.

트리거 추가 대화 상자의 필드에 다음과 같이 정보를 입력합니다.

트리거 유형

트리거 유형을 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.

푸시 (비주얼 에디터) 또는 PUSH (YAML에디터)

푸시 트리거는 변경 내용이 소스 저장소에 푸시될 때 워크플로 실행을 시작합니다. 워크플로 실행 시 푸시하려는 브랜치 (즉, 대상 브랜치) 의 파일이 사용됩니다.
풀 리퀘스트 (비주얼 에디터) 또는 PULLREQUEST (YAML에디터)

풀 리퀘스트 트리거는 소스 리포지토리에서 풀 리퀘스트를 열거나 업데이트하거나 닫을 때 워크플로 실행을 시작합니다. 워크플로 실행에서는 가져오는 브랜치 (즉, 소스 브랜치) 의 파일을 사용합니다.
스케줄 (비주얼 에디터) 또는 SCHEDULE (YAML에디터)

스케줄 트리거는 지정한 cron 표현식으로 정의된 일정에 따라 워크플로가 실행됩니다. 브랜치의 파일을 사용하여 소스 리포지토리의 각 브랜치에 대해 별도의 워크플로 실행이 시작됩니다. (트리거가 활성화되는 브랜치를 제한하려면 Branch 필드 (시각적 편집기) 또는 Branches 속성 (YAML편집기) 을 사용하십시오.)

스케줄 트리거를 구성할 때는 다음 가이드라인을 따르십시오.
- 워크플로우당 하나의 스케줄 트리거만 사용하십시오.
- CodeCatalyst 스페이스에 여러 워크플로를 정의한 경우 동시에 시작하도록 10개 이하로 예약하는 것이 좋습니다.
- 실행 간격을 충분히 두고 트리거의 cron 표현식을 구성해야 합니다. 자세한 내용은 Expression 단원을 참조하십시오.

예제는 예: 워크플로의 트리거 섹션을 참조하세요.

풀 리퀘스트용 이벤트

이 필드는 풀 요청 트리거 유형을 선택한 경우에만 나타납니다.

워크플로 실행을 시작할 풀 요청 이벤트의 유형을 지정합니다. 유효한 값은 다음과 같습니다.

풀 리퀘스트가 생성됨 (비주얼 에디터) 또는 OPEN (YAML에디터)

풀 리퀘스트가 생성되면 워크플로 실행이 시작됩니다.
풀 리퀘스트가 종료됨 (비주얼 에디터) 또는 CLOSED (YAML에디터)

풀 리퀘스트가 종료되면 워크플로 실행이 시작됩니다. CLOSED이벤트의 동작은 까다롭기 때문에 예제를 통해 가장 잘 이해할 수 있습니다. 자세한 내용은 예: 풀, 브랜치, CLOSED '이벤트가 있는 트리거 섹션을 참조하세요.
풀 리퀘스트 (비주얼 에디터) 또는 REVISION (YAML에디터) 가 새롭게 수정되었습니다.

풀 리퀘스트에 대한 수정이 생성되면 워크플로 실행이 시작됩니다. 풀 리퀘스트가 생성되면 첫 번째 리비전이 생성됩니다. 그 이후에는 누군가가 풀 리퀘스트에 지정된 소스 브랜치에 새 커밋을 푸시할 때마다 새 리비전이 생성됩니다. 풀 리퀘스트 트리거에 REVISION 이벤트를 포함하면 OPEN 이벤트를 생략할 수 있습니다. 는 의 상위 REVISION 집합이기 때문입니다. OPEN

동일한 풀 리퀘스트 트리거에 여러 이벤트를 지정할 수 있습니다.

예제는 예: 워크플로의 트리거 섹션을 참조하세요.

Schedule

이 필드는 스케줄 트리거 유형을 선택한 경우에만 나타납니다.

예약된 워크플로를 실행하려는 시기를 설명하는 cron 표현식을 지정하십시오.

의 Cron 표현식은 각 필드를 공백으로 구분하는 다음과 같은 6개 필드 구문을 CodeCatalyst 사용합니다.

minutes hours days-of-month month days-of-week year

크론 표현식의 예

분	시간	한 달의 요일	월	요일	연도	의미
0	0	?	*	MON-FRI	*	매주 월요일부터 금요일까지 자정 (UTC+0) 에 워크플로를 실행합니다.
0	2	*	*	?	*	매일 오전 2시 (UTC+0) 에 워크플로를 실행합니다.
15	22	*	*	?	*	매일 오후 10시 15분 (UTC+0) 에 워크플로를 실행합니다.
0/30	22-2	?	*	SAT-SUN	*	시작일 오후 10시부터 다음 날 오전 2시 (UTC+0) 사이에 토요일부터 일요일까지 30분마다 워크플로를 실행합니다.
45	13	L	*	?	2023-2027	2023년부터 2027년까지 매월 마지막 날 오후 1시 45분 (UTC+0) 에 워크플로를 실행합니다.

에서 크론 표현식을 지정할 때는 다음 CodeCatalyst 지침을 준수해야 합니다.

트리거당 SCHEDULE 하나의 cron 표현식을 지정하십시오.
편집기에서 cron 표현식을 큰따옴표 () " 로 묶습니다. YAML
시간을 협정 세계시 () 로 지정합니다. UTC 다른 시간대는 지원되지 않습니다.
실행 간격을 최소 30분으로 설정하세요. 더 빠른 케이던스는 지원되지 않습니다.
다음을 지정하십시오.days-of-month 또는 days-of-week 필드를 둘 다 포함하지는 마세요. 필드 중 하나에 값이나 별표 (*) 를 지정하는 경우 다른 필드에는 물음표 (?) 를 사용해야 합니다. 별표는 '모두'를 의미하고 물음표는 '모두'를 의미합니다.

cron 표현식의 추가 예와 ? *L, 및 같은 와일드카드에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Cron 표현식 참조를 참조하십시오. EventBridge 와 에서의 크론 표현식은 정확히 같은 방식으로 CodeCatalyst 작동합니다.

스케줄 트리거에 대한 예는 을 참조하십시오. 예: 워크플로의 트리거

브랜치 및 브랜치 패턴

(선택 사항)

워크플로우 실행 시작 시기를 알기 위해 트리거가 모니터링하는 소스 리포지토리의 브랜치를 지정하십시오. 정규식 패턴을 사용하여 브랜치 이름을 정의할 수 있습니다. 예를 들어 로 시작하는 모든 브랜치를 main.* 일치시키는 데 사용합니다. main

지정할 브랜치는 트리거 유형에 따라 다릅니다.

푸시 트리거의 경우 푸시하려는 브랜치, 즉 대상 브랜치를 지정하세요. 일치하는 브랜치의 파일을 사용하여 일치하는 브랜치당 한 번의 워크플로 실행이 시작됩니다.

예: main.*, mainline
풀 리퀘스트 트리거의 경우 푸시하려는 브랜치, 즉 대상 브랜치를 지정하세요. 일치하는 브랜치가 아닌 소스 브랜치의 소스 파일과 워크플로 정의 파일을 사용하여 일치하는 브랜치당 한 번의 워크플로 실행이 시작됩니다.

예:main.*,mainline, v1\-.* (로 시작하는 브랜치와 일치v1-)
스케줄 트리거의 경우 예약 실행에서 사용할 파일이 포함된 브랜치를 지정하십시오. 일치하는 브랜치의 워크플로 정의 파일과 소스 파일을 사용하여 일치하는 브랜치당 한 번의 워크플로 실행이 시작됩니다.

예: main.*, version\-1\.0

참고

브랜치를 지정하지 않으면 트리거는 소스 리포지토리의 모든 브랜치를 모니터링하고 다음 위치에 있는 워크플로 정의 파일 및 소스 파일을 사용하여 워크플로 실행을 시작합니다.

푸시하려는 브랜치 (푸시 트리거용). 자세한 내용은 예: 간단한 코드 푸시 트리거 단원을 참조하십시오.
가져오려는 브랜치 (풀 리퀘스트 트리거용). 자세한 내용은 예: 간단한 풀 리퀘스트 트리거 단원을 참조하십시오.
모든 브랜치 (스케줄 트리거용). 소스 리포지토리의 브랜치당 한 번의 워크플로 실행이 시작됩니다. 자세한 내용은 예: 간단한 스케줄 트리거 단원을 참조하십시오.

브랜치 및 트리거에 대한 자세한 내용은 을 참조하십시오트리거 및 브랜치에 대한 사용 지침.

더 많은 예제는 예: 워크플로의 트리거를 참조합니다.

파일 변경됨

이 필드는 푸시 또는 풀 요청 트리거 유형을 선택한 경우에만 나타납니다.

워크플로우 실행 시작 시기를 알기 위해 트리거가 모니터링하는 소스 리포지토리의 파일 또는 폴더를 지정하십시오. 정규 표현식을 사용하여 파일 이름이나 경로를 일치시킬 수 있습니다.

예제는 예: 워크플로의 트리거 섹션을 참조하세요.

(선택 사항) [Validate] 를 선택하여 커밋하기 전에 워크플로우 YAML 코드의 유효성을 검사합니다.
[커밋] 을 선택하고 커밋 메시지를 입력한 다음 [커밋] 을 다시 선택합니다.

YAML

트리거를 추가하려면 (YAML편집기)

https://codecatalyst.aws/ 에서 CodeCatalyst 콘솔을 엽니다.
프로젝트를 선택합니다.
탐색 창에서 CI/CD를 선택한 다음 워크플로를 선택합니다.
워크플로의 이름을 선택합니다. 워크플로가 정의된 소스 리포지토리 또는 브랜치 이름을 기준으로 필터링하거나 워크플로 이름 또는 상태별로 필터링할 수 있습니다.
편집을 선택합니다.
선택합니다 YAML.
다음 예제를 가이드로 사용하여 Triggers 섹션과 기본 속성을 추가합니다. 자세한 내용은 워크플로 YAML 정의의 Triggers를 참조하십시오.

코드 푸시 트리거는 다음과 같을 수 있습니다.
```
Triggers:
  - Type: PUSH
    Branches:
      - main
```
풀 리퀘스트 트리거는 다음과 같을 수 있습니다.
```
Triggers:
  - Type: PULLREQUEST
    Branches:
      - main.*
    Events: 
      - OPEN
      - REVISION
      - CLOSED
```
스케줄 트리거는 다음과 같을 수 있습니다.
```
Triggers:
  - Type: SCHEDULE
    Branches:
      - main.*
    # Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023
    Expression: "15 1 ? * FRI 2022-2023"
```
Expression속성에 사용할 수 있는 cron 표현식의 더 많은 예는 을 참조하십시오Expression.

푸시, 풀 요청, 스케줄 트리거에 대한 더 많은 예는 을 참조하십시오. 예: 워크플로의 트리거
(선택 사항) [Validate] 를 선택하여 커밋하기 전에 워크플로의 YAML 코드를 검증하십시오.
[커밋] 을 선택하고 커밋 메시지를 입력한 다음 [커밋] 을 다시 선택합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

트리거 및 브랜치에 대한 사용 지침

수동 전용 트리거 구성