ci(main): links job이 잠깐 느린 외부 사이트를 4분쯤 다시 묻는다 #52

Merged
donghyeon.kang merged 2 commits from ci/links-retry-window into main 2026-11-19 09:35:24 +00:00
2 Commits
Author SHA1 Message Date
DongHyeonka fcd2edf43d ci(main): links job이 잠깐 느린 외부 사이트를 4분쯤 다시 묻는다
pr / done (pull_request) Successful in 5m57s
문제: main links job(lychee-action v2.9.0 = lychee v0.24.2)이 run 362
(f415bdbb)에서 빨강이었다. 기록 문서 둘의 외부 링크 셋(man7.org의
openat2.2, jdbc.postgresql.org의 documentation/ssl·use)이 lychee 기본
재시도(첫 시도 뒤 3회, 대기 1·2·4초, 시한 20초) 동안 답하지 않았다. 요약은
Timeouts 3, Errors 0이었고 step은 67초 걸렸다. 링크는 살아 있었다. 다음 run
367은 Timeouts 0이고, 노트북 curl 9회가 모두 200이었다. main이 빨강이면 같은
repo의 병합이 멈춘다(design-docs ci/manual.md 9.3절).

고른 방법: --max-retries 5 --retry-wait-time 5. 시간 초과나 429를 받은
요청을 5·10·20·40·80초 뒤에 다시 묻는다. 시도마다 20초 시한이라 시간 초과가
이어지면 마지막 시도는 첫 시도 4분쯤 뒤에 시작한다(바로 오는 429는 2분
반쯤). 그 안에 다시 답하면 통과하고, 마지막 시도에도 답이 없으면 지금처럼
실패한다. 근거는
lychee-v0.24.2 태그 소스다: lychee-bin/src/config/mod.rs의 max_retries
("Maximum number of retries per request", 기본 3)와 retry_wait_time
("Minimum wait time in seconds between retries of failed requests", 기본 1),
lychee-lib/src/checker/website.rs의 retry_request(첫 시도 뒤 max_retries번,
대기는 매번 두 배), lychee-lib/src/retry.rs(시간 초과와 429만 다시 묻는다).

버린 대안:
- --accept-timeouts(시간 초과만이면 exit 0): 처음 고른 안이었다. 리뷰에서
  패킷을 버리는 죽은 호스트와 바깥으로 나가지 못하는 runner를 초록으로 둔다는
  지적을 받아 버렸다. 게이트가 막겠다던 것을 조용히 못 막는다.
- 기록 문서(docs/design·history·reviews)의 외부 링크를 main 실패에서 빼기:
  외부 URL 고유 364개 중 345개가 기록이라 효과는 크다. 하지만 기록의 404까지
  안 보게 되고, 「기록의 죽은 링크는 .lycheeignore에 더한다」는
  docs/README.md 규칙을 바꾼다. 살아 있는 문서의 시간 초과는 그대로 빨강이다.
- 시한(--timeout)도 늘리기: 한 번에 하나만 바꾼다(ci/manual.md 11절 4).
  run 362 로그로는 느린 응답인지 응답 없음인지 가릴 수 없다.

위험·한계: 4분 넘게 답하지 않는 사이트는 여전히 main을 빨갛게 한다. 그런
링크 하나는 4분 반쯤 걸린다(시도 6번 × 20초 + 대기 155초). 호스트 하나가
통째로 답하지 않아도 lychee는 시도마다 호스트별 자리(기본 10)를 받고 대기
중에는 쥐지 않으므로, 범위에서 URL이 가장 많은 docs.aws.amazon.com 53개가
53 × 6 × 20초 ÷ 10 ≈ 11분이다. timeout-minutes 15 안이다. 이 기계들에는
lychee가 없고 내려받아 설치하지 않으므로, 재시도 동작은 위 소스로만
확인했다. 효과는 병합 뒤 main run의 links job으로 본다. 흔들림 장부에 run
362를 external로 한 줄 더했다.

검증:
- 계약 시험 RED: 기준 59349a2b에 시험만 얹은 트리 5eb884c1에서
  DeveloperExperienceContractTest 16개 중 1개 실패(--max-retries 없음).
  desktop ~/be-ci-next-logs/a1-red3.log.
- GREEN: 트리 1f3b1877에서 같은 클래스 16개 통과,
  :app-bootstrap:spotlessCheck, :verifyStrictLaneStages --dry-run rc=0,
  --no-build-cache, FROM-CACHE 0. ~/be-ci-next-logs/a1-green4.log.
- scripts/verify.sh docs rc=0(노트북).
- 리뷰 1회(be-build-ci·be-docs): Medium 1(위 --accept-timeouts), Low 1(실패
  목록에서 5xx 누락) → 둘 다 고침. 확인 리뷰: Low 1(429와 기본값의 시간
  숫자) → 고침.
2026-11-19 18:28:01 +09:00
DongHyeonka a0166b164f docs(ledger): be-ci-next 착수 예측을 남긴다
백엔드 CI 후속 셋(links 외부 시간 초과, API surface 빈 root, BE-1·BE-4)을
시작하며 docs/work/README.md 6절대로 예측 한 줄을 더한다. 실측 줄은 일이
끝날 때 더한다.

검증: ledger.py append가 칸을 검사했다. scripts/verify.sh docs rc=0(노트북).
2026-11-19 18:28:01 +09:00