GitHub 웹 트리거
- 최종 업데이트2025/09/10
GitHub 웹 트리거
GitHub 웹 트리거 는 GitHub 리포지토리 또는 조직에서 이벤트를 모니터링하도록 구성됩니다.
개요
GitHub 웹 트리거는 GitHub 조직 또는 리포지토리에서 특정 이벤트를 감지합니다. 조직 또는 리포지토리에서 이벤트가 발생하면 트리거는 구성된 자동화 워크플로를 시작합니다.
인증
GitHub 웹 트리거는 사용자 인증을 위해 개인용 액세스 토큰을 사용하며, OAuth 연결이 필요하지 않습니다. 개인용 액세스 토큰 생성 및 관리에 대한 자세한 내용은 개인용 액세스 토큰 관리를 참조하십시오. GitHub 웹 트리거는 클래식 및 세분화된 액세스 토큰을 지원합니다. 개인용 액세스 토큰이 유효한지 확인합니다.
이 토큰은 Credential Vault에 저장할 수 있습니다. Credential Vault의 자격증명 및 lockers 항목에서 자격증명 저장 및 유지 관리에 대한 자세한 정보를 참조하십시오.
지원되는 이벤트
GitHub 웹 트리거는 조직 및 리포지토리 수준 모두에서 다음 이벤트를 지원합니다.
| 이벤트 | 설명 |
|---|---|
| 생성 | 파일, 브랜치 또는 태그가 생성될 때 |
| 포크 | 리포지토리가 포그될 때 |
| 문제 의견 | 문제 또는 풀 리퀘스트에 댓글이 추가될 때 |
| 문제 | 리포지토리 수준에서 문제가 생성될 때 |
| 라벨 | 이슈나 풀 리퀘스트에 라벨이 추가되거나 제거될 때 |
| 풀 리퀘스트 | 리포지토리 내 브랜치에서 풀 리퀘스트가 생성될 때 |
| 풀 리퀘스트 검토 | 풀 리퀘스트에 검토 댓글이 추가될 때 |
| 푸시 | 리포지토리 브랜치에 푸시가 있을 때 |
| 별 | 리포지토리에 별이 추가될 때 |
| Watch | 리포지토리 내 특정 이벤트에 대해 \'Watch\' 옵션이 활성화될 때 |
선행조건
다음 선행 조건이 충족되었는지 확인하십시오.
- Bot Creator 또는 Citizen Developer 라이선스.
- 내 봇 보기 및 이벤트 트리거 권한.
- 자동화가 위치한 폴더의 체크인 및 체크아웃 권한.
- 활성화된 GitHub 개인용 액세스 토큰.
설정
GitHub 웹 트리거에 대해 다음 설정을 사용할 수 있습니다.
- 이벤트 수신
- 트리거가 모니터링해야 하는 하나 이상의 이벤트를 선택합니다.
- 조직 이름
- GitHub 조직 이름을 입력합니다. 이 필드는 GitHub 조직 웹 트리거에만 적용됩니다.
- 리포지토리 이름
- GitHub 조직 내의 리포지토리 이름을 입력합니다. 이 필드는 GitHub 리포지토리 웹 트리거에만 적용됩니다.
- 사용자 프로필
- GitHub 사용자 프로필을 입력합니다. 이 필드는 GitHub 리포지토리 웹 트리거에만 적용됩니다
- 인증 유형 선택
- 기본 인증 유형은 개인용 액세스 토큰입니다. 자격증명 옵션에서 선택을 사용하여Credential Vault에 저장된 개인용 액세스 토큰을 선택하거나, 안전하지 않은 문자열 옵션에 개인용 액세스 토큰을 직접 입력할 수 있습니다.
- 응답(선택 사항)
- 응답 옵션을 사용하여 트리거 응답 데이터를 기록 변수에 저장합니다. 새 변수를 생성하거나 기존 변수를 선택하여 이 응답 데이터를 저장할 수 있습니다. 트리거 응답 데이터는 GitHub 웹훅 API 페이로드 응답 바디의 정보를 키-값 쌍 형식으로 캡처합니다. 기록 변수에서 키를 이름으로 사용하여 이 데이터를 자동화 내의 다른 작업에 대한 입력값으로 활용할 수 있습니다.