웹훅

GitLab에서 프로젝트 및 그룹 웹훅을 구성하고 관리합니다.

웹훅은 실시간 알림을 통해 GitLab을 다른 도구 및 시스템과 연결합니다. GitLab에서 중요한 이벤트가 발생하면 웹훅이 그 정보를 외부 애플리케이션으로 직접 보냅니다. 머지 리퀘스트, 코드 푸시, 이슈 업데이트에 반응해 자동화 워크플로를 구축합니다. 웹훅을 사용하면 변경이 발생할 때 팀이 동기화된 상태를 유지합니다. GitLab 이슈가 변경되면 외부 이슈 트래커가 자동으로 업데이트됩니다. 채팅 애플리케이션이 파이프라인 완료를 팀 멤버에게 알립니다. 코드가 main 브랜치에 도달하면 커스텀 스크립트가 애플리케이션을 배포합니다. 모니터링 시스템이 조직 전체의 개발 활동을 추적합니다. 웹훅 이벤트 # GitLab의 다양한 이벤트가 웹훅을 트리거할 수 있습니다. 예를 들어 다음과 같습니다. 리포지터리에 코드 푸시. 이슈에 코멘트 게시. 머지 리퀘스트 생성. 웹훅 한도 # GitLab.com은 다음을 포함한 웹훅 한도 를 적용합니다. 프로젝트 또는 그룹당 최대 웹훅 수. 분당 웹훅 호출 수. 웹훅 제한 시간. GitLab Self-Managed에서는 관리자가 이 한도를 수정할 수 있습니다. 푸시 이벤트 한도 # GitLab은 여러 변경이 포함된 푸시 이벤트에 대해 웹훅 트리거를 제한합니다. 기본 한도: 푸시당 브랜치 또는 태그 3개. 초과 시 동작: 해당 푸시 이벤트 전체에 대해 웹훅이 트리거되지 않습니다. 적용 대상: 프로젝트 웹훅과 시스템 훅 모두. 구성: GitLab Self-Managed 관리자는 애플리케이션 설정 API로 push_event_hooks_limit 설정을 수정할 수 있습니다. 여러 태그나 브랜치를 동시에 자주 푸시하면서 웹훅 알림이 필요하면, GitLab 관리자에게 연락해 이 한도를 늘립니다. 그룹 웹훅 # 그룹 웹훅은 그룹과 그 하위 그룹의 모든 프로젝트에서 발생하는 이벤트에 대한 알림을 보내는 커스텀 HTTP 콜백입니다. 그룹 웹훅 이벤트 유형 # 그룹 웹훅이 다음을 수신하도록 구성할 수 있습니다. 그룹과 하위 그룹의 프로젝트에서 발생하는 모든 이벤트 그룹 멤버 이벤트, 프로젝트 이벤트, 하위 그룹 이벤트를 포함한 그룹 전용 이벤트 프로젝트와 그룹 양쪽의 웹훅 # 그룹과 그 그룹의 프로젝트에 동일한 웹훅을 구성하면, 해당 프로젝트의 이벤트에 대해 두 웹훅이 모두 트리거됩니다. 이를 통해 GitLab 조직의 여러 수준에서 이벤트를 유연하게 처리할 수 있습니다. 웹훅 구성 # 프로젝트 워크플로와 통합하기 위해 GitLab에서 웹훅을 생성하고 구성합니다. 이 기능으로 요구 사항에 맞는 웹훅을 설정합니다. 웹훅 생성 # 히스토리 Signing token 텍스트 상자가 GitLab 19.0에 webhook_signing_token 이라는 기능 플래그와 함께 도입되었습니다 . 기본적으로 활성화됩니다. 기능 플래그 webhook_signing_token 이 GitLab 19.1에서 제거되었습니다 . 새 웹훅에는 시크릿 토큰 대신 서명 토큰을 사용합니다. 서명 토큰은 페이로드에 대해 HMAC-SHA256 서명을 계산하므로, 엔드