k8s-ko triage

kubernetes/website의 language/ko 라벨이 붙은 Issue/PR 을 정리해 보여주는 정적 대시보드입니다. 두 가지 뷰가 있습니다.

• 워크리스트 — 당번(PR wrangler)이 지금 손댈 것만 추린 일일 작업 목록
• 주간 백로그 — 오래 정체된 항목을 주간 미팅에서 훑기 위한 목록

배포 주소: https://eundms.github.io/issue-pr-stat/ (첫 워크플로 실행 후 활성화)

배포 (최초 1회)

bash deploy.sh        # 이 폴더에서 실행 → git init → 커밋 → push

push 후 GitHub 웹에서 세 가지를 설정합니다.

1. Settings → Actions → General → Workflow permissions → "Read and write permissions" (봇이 주간 스냅샷을 저장소에 커밋하려면 필요)
2. Settings → Pages → Source → "GitHub Actions"
3. Actions 탭 → "k8s-ko triage report" → Run workflow → 첫 실행이 kubernetes/website에서 실제 데이터를 수집하고 Pages에 배포합니다.

첫 실행 전까지는 데모 데이터를 보여주며 상단에 배너를 띄웁니다. 이후 매주 월요일 09:10 KST에 자동 갱신됩니다.

워크리스트 — 누가 막고 있나

주간 백로그만으로는 당번 업무가 줄지 않았다. 임계값(30/60일)을 넘긴 것만 잡으니 열린 PR 53건 중 14건만 보였고, 정작 당번이 매일 만지는 신규 유입 PR 39건은 화면에 없었다. 게다가 걸린 항목마다 라벨·CI·리뷰 상태를 사람이 다시 읽어 "지금 뭘 해야 하나"를 추론해야 했다.

워크리스트는 열린 PR 전체를 나이로 거르지 않고 가져와서, 대기 주체(blocked-on)별로 하나의 레인과 하나의 다음 행동으로 환원한다. ★ 두 레인만 보면 당번 업무가 끝난다.

레인	조건	다음 행동
★ 리뷰 차례	차단 요소 없음 + lgtm 없음	리뷰 후 /lgtm
★ 승인 대기	lgtm 있음 + approved 없음	어프루버에게 /approve
작성자 대기	CLA 미서명 · needs-rebase · CI 실패 · 리뷰 코멘트 후 무응답	한국어 코멘트 템플릿 (14일 경과 시 핑)
머지 대기	lgtm + approved	없음 — tide 가 머지한다
보류 · 초안	draft 또는 do-not-merge/*	없음 — 의도적으로 멈춘 것

판정은 위에서부터 첫 매치가 이깁니다. 순서 자체가 우선순위 정의라서, 규칙을 바꾸려면 scripts/collect.mjs 의 triage() 안 분기 순서를 조정하면 됩니다.

규모와 예상 소요

Prow 의 size/XS~XXL 라벨을 분 단위로 환산해(XS 3분 … XXL 90분) 항목마다 붙이고, 상단에 합계를 띄웁니다. 건수만 보면 "19건"이 위압적이지만 그중 4건은 5분짜리라, 총 소요와 규모 분포를 같이 보여줘야 "오늘 다 못 한다"가 아니라 "빠른 것부터"로 판단이 바뀝니다. 빠름/보통/김 칩으로 걸러 짧은 것만 몰아 처리할 수 있습니다.

CI 신호

머지를 실제로 막는 검사만 셉니다. kubernetes/website 의 열린 PR 이 노출하는 컨텍스트는 6종인데, 이 중 신호가 되는 건 deploy/netlify 와 EasyCLA 뿐입니다.

• tide 는 머지 큐 상태라 머지 직전까지 PENDING 입니다. 그래서 statusCheckRollup.state 를 그대로 쓰면 열린 PR 의 롤업은 SUCCESS 가 될 수 없습니다 — 실측 53건 중 0건이었습니다.
• Pages changed · Header rules · Redirect rules 는 Netlify 빌드 플러그인 부산물이라 실패해도 머지를 막지 않습니다. 이걸 세면 멀쩡한 PR 이 "CI 실패"로 오분류됩니다(실측 3건이 전부 이 케이스).

차단 검사 목록은 collect.mjs 의 BLOCKING_CHECKS 에 있습니다. Prow 관례인 pull- 접두사도 함께 인정하므로 다른 k8s 저장소에도 그대로 쓸 수 있습니다.

공이 누구 코트에 있나

차단 라벨이 하나도 없는 PR 은 마지막으로 발언한 사람으로 가릅니다. 봇(k8s-ci-robot 등)은 세지 않습니다.

• 마지막 발언이 리뷰어 → 작성자 응답 대기 → 작성자 대기
• 마지막 발언이 작성자 → 재확인 필요 → 리뷰 차례
• 작성자 말고 아무도 발언한 적 없음 → 첫 리뷰 배지 + 리뷰 차례

코멘트는 last: 10 까지 봅니다. last: 1 이면 k8s-ci-robot 코멘트 하나에 사람의 마지막 발언이 가려집니다.

인계 체크리스트

워크리스트에서 인계 체크리스트 복사를 누르면 레인별로 묶인 체크박스 목록이 클립보드에 담깁니다. 그대로 GitHub 이슈 본문에 붙이면 당번 교대용 작업 목록이 됩니다.

### 리뷰 차례 (12건 · 약 4시간 15분)
- [ ] [#56634](https://github.com/kubernetes/website/pull/56634) [ko] Add localization contribution guidance — **리뷰 후 lgtm `/lgtm`** · S 5분 · 20일 미갱신
  - 작성자가 응답함 — 재확인 필요

주간 백로그 분류 기준

분류	조건	왜 봐야 하나
Issue O / PR closed	Issue OPEN + 연결된 PR이 전부 CLOSED(미병합)	번역 작업이 중단됨 — 이슈를 닫거나 새 자원자 배정
Issue O / PR stale	Issue OPEN + 연결된 OPEN PR이 STALE_DAYS 이상 미갱신	리뷰어 지정 또는 작성자 확인 필요
PR long open	PR이 LONG_OPEN_DAYS 이상 열려 있음	lgtm/approved 확인 후 머지 또는 정리
Issue / PR 없음	Issue OPEN + 연결 PR 없음 + NO_PR_DAYS 경과	주간 미팅에서 자원자 모집

Issue↔PR 연결은 GraphQL Issue.closedByPullRequestsReferences로 가져옵니다. GitHub 화면의 Development 패널과 같은 정보라서, PR 본문의 Fixes #123을 정규식으로 파싱하는 것보다 정확합니다. 링크가 걸리지 않고 언급만 된 PR은 timelineItems(CROSS_REFERENCED_EVENT)로 보완합니다.

로컬 실행

# Node 20 이상 (내장 fetch 사용, 의존성 없음)
export GITHUB_TOKEN=github_pat_xxx   # public repo 읽기만 하므로 scope 불필요
node scripts/collect.mjs             # → docs/data/report.json 생성

npx serve docs                       # → http://localhost:3000

report.json이 없으면 대시보드는 데모 데이터를 표시하고 상단에 배너를 띄웁니다. file://로 직접 열면 CORS 때문에 fetch가 막히므로 반드시 HTTP 서버로 띄우세요.

토큰은 절대 저장소에 커밋하지 말고 환경변수나 GitHub Secrets로만 전달하세요.

GitHub Pages 배포

1. 이 디렉터리를 새 저장소에 push
2. Settings → Pages → Source를 GitHub Actions로 변경
3. Actions 탭에서 k8s-ko triage report 워크플로를 한 번 수동 실행

이후 매주 월요일 00:10 UTC(한국시간 09:10)에 자동 갱신됩니다. GitHub Actions의 schedule은 항상 UTC로 해석되며 타임존 지정을 지원하지 않습니다.

임계값 조정

.github/workflows/report.yml의 env 또는 로컬 환경변수로 조정합니다.

변수	기본값	의미
TARGET_REPO	kubernetes/website	대상 저장소
TARGET_LABEL	language/ko	대상 라벨
STALE_DAYS	30	PR 정체 판정 기준
LONG_OPEN_DAYS	60	PR 장기 미병합 판정 기준
NO_PR_DAYS	30	이슈 방치 판정 기준

주간 미팅 활용

주간 백로그 뷰에서 마크다운 복사 버튼을 누르면 아래 형식으로 클립보드에 담깁니다. 회의록에 그대로 붙여넣으면 됩니다.

* Issue는 열려 있는데 PR이 닫힌 경우
   * [#43628](https://github.com/kubernetes/website/issues/43628) 제목 — 마지막 활동 214일 (PR #43700 closed)

주차별 추이 & 스냅샷

매 실행마다 collect.mjs는 세 가지를 남깁니다.

파일	내용	보관
docs/data/report.json	최신 상세 (대시보드가 읽음)	매번 덮어씀
docs/data/snapshots/YYYY-Www.json	그 주의 상세 원본	최근 KEEP_WEEKS주 롤링
docs/data/trend.json	주당 집계 한 줄 (수십 바이트)	영구

trend.json 에는 백로그 4분류 외에 needsAction(= 리뷰 차례 + 승인 대기)도 쌓입니다. 당번 부담의 직접 지표는 열린 PR 총량이 아니라 "우리 차례인 건수"이므로, 이 값이 줄어드는지로 개선 여부를 판단합니다. 워크리스트 도입 이전 주차에는 이 키가 없으며, 대시보드는 결측 주를 0 으로 채우지 않고 계열에서 제외합니다(가짜 하강선 방지).

DB 없이 git 히스토리를 시계열 저장소로 씁니다. 추이 그래프는 trend.json만 읽으므로 payload가 상수에 가깝고, "지난주 대비 −3건"은 배열의 마지막 두 항목을 빼서 구합니다. 같은 주에 두 번 실행하면 같은 주차 파일에 덮어쓰므로 멱등합니다(ISO 8601 주차, 목요일 기준).

원본 스냅샷은 KEEP_WEEKS(기본 8)주까지만 남기고 오래된 것은 삭제하지만, 집계는 계속 누적됩니다. 접근 빈도가 낮은 cold 원본은 버리고 hot summary만 영구 보관하는 정책입니다.

워크플로의 Commit data 스텝이 이 파일들을 저장소에 커밋합니다. 커밋이 다시 워크플로를 트리거하지 않도록 push 트리거에서 docs/data/**를 paths-ignore로 제외하고, 커밋 메시지에 [skip ci]를 붙였습니다. 이를 위해 워크플로 권한을 contents: write로 상향했습니다.

공유 가능한 뷰 (URL 동기화)

뷰·분류·검색·심각도·기간·규모 필터와 정렬 상태가 쿼리스트링에 실립니다. 필터를 걸어놓고 주소를 복사하면 같은 뷰가 그대로 열립니다 — 예: ?cost=quick은 "5분 안에 끝나는 것만", ?view=backlog&cat=pr-long-open&sev=23은 "장기 오픈 PR 중 90일 넘은 것만". 서버 세션 없이 URL이 상태를 들고 있어 정적 호스팅 그대로 동작합니다. replaceState를 써서 필터를 바꿔도 뒤로가기 히스토리가 쌓이지 않습니다.

참고

• GitHub GraphQL API
• Issue 객체 · closedByPullRequestsReferences
• GraphQL 리소스 제한
• Actions 워크플로 문법 · schedule
• Actions로 GitHub Pages 배포
• Kubernetes 문서 한글화 가이드