org-wiki Quartz→GitHub Pages deploy sync timeout
yoosungung/wiki Deploy workflow가 build success 뒤 actions/deploy-pages@v4에서만 실패하면, 제품/콘텐츠 회귀보다 GitHub Pages sync 지연 + 10분 하드캡을 먼저 의심한다.
판별
| 신호 | 해석 |
|---|---|
build job green, deploy step Timeout reached, aborting! | Pages sync wall clock > action/backend 10m |
로그가 deployment_queued → 장시간 syncing_files | 백엔드 동기화 지연 (artifact ~40MB 전후에서도 간헐) |
| tip 다음 push의 Deploy는 ~1–2분에 succeed | 일시 flake; 동일 SHA re-run은 deployment id=SHA라 cancel 후 즉시 실패하기 쉬움 |
| annotation budget/minutes · job 수초 empty | 다른 축 — Actions-Budget-Blocks-CI-Rerun.md |
운영 규칙
- timeout 입력 상향은 무효 —
deploy-pages는Math.min(timeout, 600000)이고 Pages 백엔드도 ~10m을 강제한다 (deploy-pages#165). - 실패 run을 Re-run하지 말고 새 tip commit(정상 inbox/wiki push)으로 재배포한다. cancel된 deployment id는 commit SHA다.
- 동시 push가 많으면 concurrency
cancel-in-progress: true로 tip만 배포한다 (느린 구 SHA에 10분을 쓰지 않음). wiki.askwho.netHTTP 200만으로 새 tip 반영을 단정하지 않는다 — 이전 artifact가 계속 서빙될 수 있다. Actions tip conclusion을 본다.
증거 (2026-11-10)
- fail
42739993452(c6afa78): deploy ~10msyncing_files→ Timeout - success
42740527660(3550498): deploy ~90s; sitehttps://wiki.askwho.net200
완화 단계 (ticket 2567ad37)
- Publish allowlist — Quartz content =
wiki/+assets/+quartz-plugins/+INDEX.md.projects/·log.md·root 잡 md는 content에 넣지 않음(projects는 기존ignorePatterns와 정합). - Deploy paths filter —
inbox/**등 publish 비대상 push는 workflow 미기동. 수동은workflow_dispatch. - tip
cancel-in-progress+ 본 런북(0단계)은 유지.