InfoGrab DocsInfoGrab Docs

웹훅 콜백

프로젝트 또는 그룹 웹훅으로 GitLab Duo 플로 수명 주기 이벤트를 수신하는 방법을 설명합니다.

히스토리 GitLab 19.4에서 duo_flow_callback_hooks 라는 기능 플래그와 함께 도입 되었습니다. 기본적으로 비활성화되어 있습니다. flow.progress 이벤트가 GitLab 19.5에서 도입 되었습니다. Feature flag 이 기능의 가용성은 기능 플래그에 의해 제어됩니다. 자세한 내용은 기록을 참조합니다. 이 기능은 테스트에 사용할 수 있지만 프로덕션 환경에서 사용할 준비는 되지 않았습니다. 플로 API 로 플로를 트리거하면, GitLab은 플로 수명 주기 이벤트를 지정한 웹훅으로 보낼 수 있습니다. 그러면 API에서 플로 상태를 폴링하는 대신, 플로가 시작되거나 완료되거나 실패할 때 대응할 수 있습니다. 플로가 실행되는 동안에는 에이전트의 진행 상황도 수신합니다. 프로젝트 또는 그룹에서 웹훅을 사용할 수 있습니다. 하위 프로젝트는 웹훅을 상속합니다. 즉, 최상위 그룹의 웹훅은 해당 그룹에 속한 모든 프로젝트의 플로를 처리합니다. 사전 요구 사항 # 웹훅이 플로 이벤트를 수신하려면 다음 사전 요구 사항을 충족해야 합니다. 프로젝트 또는 그룹에 웹훅이 생성 되어 있고, 해당 웹훅의 콜백이 켜져 있습니다. 웹훅이 플로가 실행되는 프로젝트 또는 그룹에 속하거나, 해당 프로젝트 또는 그룹의 상위 그룹에 속합니다. 웹훅이 시스템 웹훅 이 아닙니다. 웹훅의 콜백 켜기 # 사전 요구 사항: 프로젝트 웹훅의 경우 프로젝트에서 Maintainer 또는 Owner 권한이 있어야 합니다. 그룹 웹훅의 경우 그룹에서 Owner 권한이 있어야 합니다. 웹훅의 콜백을 켜려면 다음을 수행합니다. 상단 표시줄에서 Search or go to 를 선택하고 프로젝트 또는 그룹을 찾습니다. 왼쪽 사이드바에서 Settings > Webhooks 를 선택합니다. Add new webhook 을 선택하거나, 기존 웹훅의 Edit 를 선택합니다. GitLab Duo Agent Platform 아래에서 Send Duo flow events to this webhook 확인란을 선택합니다. Add webhook 또는 Save changes 를 선택합니다. 프로젝트 웹훅 API 또는 그룹 웹훅 API 로 duo_flow_callback_enabled 속성을 설정할 수도 있습니다. 두 API 중 하나로 웹훅 목록을 조회하여 콜백을 켠 웹훅의 ID를 찾습니다. 콜백을 켜는 데 필요한 권한은 웹훅에만 적용됩니다. 웹훅을 참조하는 플로를 트리거하는 사용자에게는 이 권한이 필요하지 않습니다. 플로의 콜백 수신 # 사전 요구 사항: 플로 사전 요구 사항 을 충족해야 합니다. 콜백을 수신하려면 플로를 트리거 할 때 웹훅 ID를 callback_hook_id 속성으로 전달합니다. curl --request POST \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-Type: application/json" \ --data '{ "project_id": "5", "goal": "Fix t