scripts/verify.sh docs와 docs/work/reference/gates.md는 docs 단계
(check-work-docs.py 포함)가 pr.yml의 prCheck 안에서 돈다고 적는다.
실제 prCheck는 check-docs.py·scripts/tests·check-repo-layout.py만
돌리고 check-work-docs.py는 빠져 있었다. 그래서 operate.md가 줄
상한을 넘은 PR(#12)이 PR 단계 초록으로 main에 들어갔다.
check-repo-layout.py·check-docs.py와 같은 모양의 Exec 태스크
verifyWorkDocs를 만들어 prCheck에 붙였다. 검사 본문은 Gradle 밖
스크립트 그대로다(소유자 결정: 매뉴얼 검사 장치는 scripts/).
버린 안: pr.yml에 python step을 따로 두기 — 단계 job은 Gradle 한 줄
이라는 verifyStrictLaneStages 형식과 어긋나고, verify.sh pr와
workflow가 다른 것을 돌리게 된다.
위험: 파생 서비스도 같은 상한을 PR에서 지켜야 한다
(template-vs-consumer.md에 행을 더했다). 검사는 1초 안쪽이다.
검증: scripts/verify.sh docs(노트북) rc=0. desktop prCheck는 이 커밋
메시지 뒤 PR 실행과 desktop verify.sh pr로 본다.
main(a7e38c10)에 들어온 요청률 제한 한 줄로 docs/work/operate.md가
151줄이 됐다. check-work-docs.py의 상한은 150줄이라
scripts/verify.sh docs가 main에서 실패한다. 같은 줄 끝의
「(W4 BE-OBS-A)」는 새 세션이 따라갈 수 없는 작업 이력 ID다.
같은 절에서 템플릿 전용 게이트 문서를 가리키는 줄과 파생 서비스 쪽
병합·게이트는 그 repo의 일이라는 줄을 한 항목으로 합쳤다. 둘 다
「파생 서비스의 게이트는 누구 몫인가」를 말한다. 요청률 제한 줄은
내용을 그대로 두고 이력 ID만 뺐다.
검증: scripts/verify.sh docs(노트북) rc=0, operate.md 150/150.
문제: `JpaPlatformContractSupport`의 Javadoc은 「서버를 JVM에서 공유한다」고
하지만, `start`는 부를 때마다 컨테이너를 새로 띄웠다. 클래스 42개가 저마다 띄워
desktop main 단계에서 platform 계약 lane이 컨테이너 75개(기동 181초), migration
lane이 36개(71초)를 썼다. 이 lane들은 build의 실서버 슬롯 하나 위에서 돌기 때문에,
이 기동 시간이 main job 시간에 그대로 더해졌다. release gate 셋과 nightly
행렬 셋에서도 같은 lane이 major마다 돈다.
고친 방법: Stable major마다 서버 하나를 JVM에서 처음 쓸 때 띄우고, JVM이 끝날 때
멈춘다(shutdown hook, reaper에 기대지 않는다). support마다 그 서버에 database를
하나 만들고(`create database contract_<n>`), close에서 pool을 다 닫은 뒤
지운다(`drop database ... with (force)`). 표·스키마·Flyway 이력은 database에
있어 클래스끼리 섞이지 않는다. 서버 전체에 걸리는 role은 섞이므로 Javadoc에
적었다. role을 만드는 계약은 `PostgreSqlSecurityContractTest` 하나이고, lane마다
JVM이 따로라 이름이 겹치지 않는다.
시험: 소유권 시험에 둘을 더한다. 두 번째 support가 같은 서버, 다른 database를
받는지, close가 database를 지우는지 본다. 공유를 되돌리면 앞의 것이, drop을
빼면 뒤의 것이 실패한다. close 시험의 이름은 「database를 지우기 전에 pool을
닫는다」로 고친다.
버린 대안: 컨테이너 tmpfs·fsync 끄기로 기동만 빠르게. 재시작·장애 복구 계약의
조건이 바뀐다. Testcontainers reuse: CI에서 일부러 끈 설정이다.
위험·한계: 한 클래스가 서버 설정(`ALTER SYSTEM`)을 바꾸면 같은 lane의 다음
클래스가 본다. 지금 그런 계약은 없다(검색으로 확인).
문제: main job은 `./gradlew :mainCheck :integrationCheck --continue` 한 번이다.
integration lane은 build 전체에서 실서버 슬롯 하나를 나눠 쓴다
(ExclusiveRealServerLaneService, maxParallelUsages 1). desktop 측정에서
이 lane들은 시작 약 10분 동안 슬롯을 거의 쓰지 못했다. main 단계 분석이 CPU를
다 쓰는 동안 lane의 컴파일이 뒤로 밀렸기 때문이다. 그 뒤 19분은 lane이 한 번에
하나씩, 한가한 기계에서 돌았다. runner run 132에서도 jpa 계약 lane이 1,134초에야
시작했다.
고른 방법: 줄을 `./gradlew :integrationCheck :mainCheck --continue`로 바꾼다.
Gradle은 준비된 일을 요청한 태스크 순서대로 시작하므로, integration lane의
컴파일이 먼저 돌고 슬롯이 첫 분부터 찬다. 같은 단계, 같은 태스크 집합이다.
build.gradle 단계 선언의 `line`, main.yml, scripts/verify.sh, gates.md,
build-logic/AGENTS.md의 예시 줄을 함께 바꾼다.
측정(desktop, e7be517e, --no-build-cache, 같은 init script):
- 순서 바꾸기 전 1,760초(aeb60339, 거의 같은 트리), 바꾼 뒤 1,484초(−16%), rc=0, 실패 0
- jpa 계약 lane 시작 777초 → 329초. 슬롯이 60초부터 끝까지 찬다.
버린 대안: 슬롯을 둘로 늘리기. 시간에 민감한 web·WebSocket lane이 함께 돌 때
실패해서 하나로 둔 것이다(2026-11-01 리뷰). lane을 두 Gradle 실행으로 나누기:
컴파일을 두 번 한다.
위험·한계: lane이 main 단계 분석과 같은 시간에 돌아 CPU를 나눠 쓴다. 지금도 앞
10분에는 전송 qualification lane이 그렇게 돌았다. desktop 한 번은 실패 0이고,
runner 결과는 PR 본문에 적는다. 이제 main job 시간은 슬롯 lane 시간의 합이
정한다(가장 큰 것은 PostgreSQL 컨테이너 기동, 후속).
문제: nightly의 httpclient-transport는 transport마다 job 하나였다. 행마다 1분이
안 되고, 그 대부분이 job 시작이다(run 100: apache 0.8분, jdk 0.9분).
고른 방법: job 하나에 transport마다 step 하나를 둔다. 줄은 지금과 같다
(`-Phttpclient.contract.transports=<transport>`). `if: always()`라서 앞
transport가 실패해도 뒤가 돌고, 실패한 step 이름이 transport를 말한다.
속성 값이 다르므로 두 번째 실행도 lane을 다시 돈다.
버린 대안: 그대로 두기. 매일 job 시작 한 번을 더 치른다.
검증: YAML을 읽어 step 넷(checkout, setup, apache, jdk)을 확인했다.
문제: nightly의 redis-topology가 행렬 job 11개였다. 행마다 job을 새로 시작해
컨테이너·checkout·JDK·Gradle 시작과 구성을 다시 치렀다. 수동 실행 run 100에서
이 11개가 runner 135분 가운데 26분이었고, 그중 약 3분의 1이 시작 비용이었다.
고른 방법: job 하나에 행마다 step 하나를 둔다. 각 step은 지금과 같은
`bash scripts/ci/redis-topology.sh <topology> <version>` 한 줄이다.
- `if: always()`로 한 행이 실패해도 나머지가 돈다. job이 빨갛게 되고, 실패한
step 이름이 행을 말한다.
- 스크립트가 끝날 때 자기 topology를 내리므로 행끼리 서버를 나누지 않는다.
- 같은 job 안에서 Gradle daemon과 구성 결과를 다시 쓴다.
- timeout은 행 11개를 합친 시간에 맞춰 90분으로 둔다.
문서: 행렬이라고 적던 곳(gates.md, template-vs-consumer.md, redis-sdk compose
README, 스크립트 머리 주석)을 step으로 고친다.
버린 대안: 버전마다 job 하나(3개). 시작 비용을 셋 더 치른다. 한 step에서
셸 반복문으로 돌기: 어느 행이 실패했는지 로그를 뒤져야 하고, 단계 job 규칙과
같은 이유로 셸 문법을 늘리지 않는다.
위험·한계: UI에서 행마다 따로 보이던 초록·빨강이 step 단위가 된다. job 하나가
시간 제한에 걸리면 남은 행이 함께 멈춘다.
검증: YAML을 읽어 step 13개(checkout, setup, 행 11)를 확인했다. runner nightly
측정은 PR 본문에 적는다.
문제: scripts/ci/trivy-scan.sh가 job마다 취약점 DB(133 MB, 약 30초)를
내려받는다. release 이미지 job은 Java 색인(952 MB, 약 2분)도 받는다. run 125의
이미지 job 7.0분 가운데 약 2.8분이 이 두 내려받기였다.
고른 방법: 새 composite action `.gitea/actions/trivy-db-cache`가 Trivy 기본
캐시 디렉터리(~/.cache/trivy)의 db와 java-db를 actions/cache로 복원한다.
pr.yml `done`, main.yml `vulnerabilities`, release.yml 이미지 job의 scan 앞에
둔다. Java 색인은 이미지 job만 받는다(`java-db: "true"`).
- Trivy는 DB 자체의 metadata로 최신인지 판단하고, 아니면 새로 받는다. 복원은
시간을 줄일 뿐이고 아는 권고 목록을 바꾸지 않는다.
- 항목은 덮어쓰지 않으므로 key에 기간을 넣는다. 취약점 DB는 하루, Java 색인은
Trivy가 스스로 3일마다 갱신하므로 3일 단위다. 952 MB가 매일 캐시에 쌓이지 않는다.
- 저장은 main ref만 한다. JDK·Gradle 캐시와 같은 규칙이다. 브랜치가 main이 쓸
DB를 정하지 못한다.
버린 대안: `--skip-db-update`로 캐시만 쓰기. DB가 오래될 수 있어 게이트가 약해진다.
key 하나 고정. 첫 사본이 영원히 남는다.
위험·한계: Java 색인 항목이 runner 캐시(5 GB 상한)의 약 1 GB를 쓴다. 효과는
main이 한 번 저장한 뒤부터 보인다.
검증: 네 YAML을 읽었다. runner 측정은 PR 본문에 적는다.