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 리포지토리 웹 트리거에만 적용됩니다.
사용자 프로필
GitHub 사용자 프로필을 입력합니다. 이 필드는 GitHub 리포지토리 웹 트리거에만 적용됩니다
인증 유형 선택
기본 인증 유형은 개인용 액세스 토큰입니다. 자격증명 옵션에서 선택을 사용하여Credential Vault에 저장된 개인용 액세스 토큰을 선택하거나, 안전하지 않은 문자열 옵션에 개인용 액세스 토큰을 직접 입력할 수 있습니다.
응답(선택 사항)
응답 옵션을 사용하여 트리거 응답 데이터를 기록 변수에 저장합니다. 새 변수를 생성하거나 기존 변수를 선택하여 이 응답 데이터를 저장할 수 있습니다. 트리거 응답 데이터는 GitHub 웹훅 API 페이로드 응답 바디의 정보를 키-값 쌍 형식으로 캡처합니다. 기록 변수에서 키를 이름으로 사용하여 이 데이터를 자동화 내의 다른 작업에 대한 입력값으로 활용할 수 있습니다.
GitHub 웹 트리거는 웹훅 키-값 쌍 페이로드를 마침표(.) 표기법으로 파싱합니다. 동일한 형식을 따라 기록 변수에 대한 표현식을 만들어야 합니다. 예를 들어, repository id를 표현식으로 사용하려면, 키로 repository.id를 입력해야 합니다. GitHub 웹후크 페이로드 문서에 대한 자세한 내용은 GitHub webook events and payload 항목을 참조하십시오.
봇 실행이 완료되면, Audit log는 트리거 이벤트로 실행된 봇에 트리거 응답 데이터를 기록합니다.