2026 OpenClaw MeshMac 실전: YouTrack Webhook 다중 노드 빌드 브로드캐스트·실패 요약·토큰 로테이션

노드마다 YouTrack URL을 두면 토큰·감사·재시도가 N배로 불어납니다. 단일 게이트웨이 + 내부 큐가 소규모 다기종 협업에서 가장 단순한 정답입니다. 유사 패턴은 Linear 웹훅 가이드와 같이, 외부 SaaS는 한 엔드포인트만 바라보게 두세요.

Webhook Triggers 구성

YouTrack Cloud는 Webhook Triggers 앱으로 이슈·코멘트 등 이벤트마다 POST application/json을 보냅니다. URL은 https://gateway.example/hooks/youtrack처럼 TLS 고정 한 줄만 넣고, 이벤트는 필요한 것만 켜면 노이즈가 줄어듭니다.

1. 관리 — Administration → Apps에서 앱을 최신으로 두고, 대상 프로젝트에 연결합니다.
2. 토큰 — 문서 권장대로 openssl rand -hex 32로 64자 hex를 만들고 비밀 저장소에만 둡니다.
3. URL — 게이트웨이 공인 주소만. 여러 URL은 쉼표·줄바꿈으로 구분하되 뒤 공백을 제거합니다.
4. Catch-all — 전 이벤트 수집은 감사용으로 분리해 빌드 큐와 섞지 않습니다.

공유 토큰·헤더 검증

JetBrains 문서 기준 인증은 요청 헤더에 동일한 웹훅 토큰을 실어 보내는 방식입니다(기본 헤더명 X-YouTrack-Token, 변경 가능). 수신측은 상수 시간 문자열 비교로만 검증하고, 토큰 원문은 로그·메트릭 라벨에 넣지 마세요. 시크릿 파일 권한·경로는 최소 권한·0440 패턴을 그대로 쓰면 됩니다.

1. 헤더 이름을 YouTrack 설정과 바이트 단위로 일치시킵니다.
2. 불일치 시 401, 바디는 읽지 않아도 됩니다.
3. 검증 후에만 JSON을 파싱하고 이벤트 타입을 필터링합니다.

다중 노드 라우팅·멱등

인바운드 핸들러는 큐에 기록(durable)한 뒤 곧바로 200을 돌려 재전송 폭주를 막습니다. 워커는 mesh_node_id를 템플릿에 넣어 슬랙·팀즈 등으로 한 번만 브로드캐스트합니다. 큐 깊이·재시도 골격은 태스크 큐·재시도 글과 맞추면 운영이 단순해집니다.

1. 멱등 키: id + timestamp 또는 짧은 분 창 해시.
2. 빌드 스크립트는 모든 노드에서 동일한 엔트리포인트·환경 템플릿을 씁니다.
3. 노드 교체·드레인 시에도 YouTrack 쪽 URL·토큰은 그대로 둡니다.

재시도 백오프·실패 요약·토큰 로테이션

아웃바운드(채팅 웹훅·YouTrack REST)만 지수 백오프+지터를 길게 잡고, 429·5xx에 한정해 재시도합니다. 실패 한 줄 요약은 게이트웨이만 Permanent Token으로 이슈 코멘트에 남기고, 토큰은 이중 기록으로 갱신한 뒤 구값을 폐기합니다. 웹훅 공유 토큰도 분기별로 교체하면 작은 팀도 감사 추적이 쉬워집니다.

• 백오프: 예) 1s·2s·4s… 상한 60s, 전 구간에 0–250ms 지터.
• 코멘트: 로그 tail·exit code·노드 이름만 짧게. 장문 로그는 아티팩트 링크로 대체.
• 로테이션 중에는 구·신 토큰을 잠시 병행 수락한 뒤 구 토큰만 끕니다.

FAQ

운영에서만 401이 납니다

프록시가 커스텀 헤더를 지우는지, YouTrack에 입력한 토큰과 게이트웨이 파일이 동일한지(복사 공백) 확인하세요.

칸반을 빠르게 움직이면 빌드가 연달아 돕니다

상태 전이·라벨 화이트리스트로 게이트하고, 디바운스 윈도를 두세요.

알림은 오는데 코멘트만 실패합니다

토큰 스코프·만료·프로젝트 권한·레이트 제한을 분리 로그로 보세요.