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

운영 규칙

  1. timeout 입력 상향은 무효 — deploy-pages는 Math.min(timeout, 600000)이고 Pages 백엔드도 ~10m을 강제한다 (deploy-pages#165).
  2. 실패 run을 Re-run하지 말고 새 tip commit(정상 inbox/wiki push)으로 재배포한다. cancel된 deployment id는 commit SHA다.
  3. 동시 push가 많으면 concurrency cancel-in-progress: true로 tip만 배포한다 (느린 구 SHA에 10분을 쓰지 않음).
  4. wiki.askwho.net HTTP 200만으로 새 tip 반영을 단정하지 않는다 — 이전 artifact가 계속 서빙될 수 있다. Actions tip conclusion을 본다.

증거 (2026-11-10)

  • fail 42739993452 (c6afa78): deploy ~10m syncing_files → Timeout
  • success 42740527660 (3550498): deploy ~90s; site https://wiki.askwho.net 200

완화 단계 (ticket 2567ad37)

  1. Publish allowlist — Quartz content = wiki/ + assets/ + quartz-plugins/ + INDEX.md. projects/·log.md·root 잡 md는 content에 넣지 않음(projects는 기존 ignorePatterns와 정합).
  2. Deploy paths filter — inbox/** 등 publish 비대상 push는 workflow 미기동. 수동은 workflow_dispatch.
  3. tip cancel-in-progress + 본 런북(0단계)은 유지.