ci: main·nightly·release 준비 비용을 더 줄인다 #15

Merged
donghyeon.kang merged 9 commits from claude/w2-be-ci-perf-2 into main 2026-11-12 15:00:37 +00:00
Owner

무엇을, 왜

#13 병합 뒤 새 main(e7be517e)에서 잰 runner 값은 목표에 못 미쳤다.

단계 기준(새 main) 목표
main push 42.1분(run 132, main job 35.9분) ≤ 30분
nightly 135.3분(run 100, 같은 job 구성) ≤ 120분, 전부 초록(performance 포함)
release 39.7분(run 125: gate 32.5분 + 이미지 7.0분) ≤ 35분
PR 12.0분(run 130) ≤ 8분

시간은 runner job 시간의 합이다. runner 한 대가 job을 하나씩 돌리므로, 대기를 뺀 벽시계와 같다.

이 PR은 여섯 가지를 바꾼다.

  1. main job 줄 순서: ./gradlew :integrationCheck :mainCheck --continue. 실서버 lane은 build 전체에서 슬롯 하나를 쓴다. 지금 순서에서는 lane이 시작 10분 동안 그 슬롯을 거의 못 쓰고, 그 뒤 19분은 한가한 기계에서 하나씩 돈다. desktop에서 1,760초 → 1,484초(−16%)였다.
  2. Trivy DB 캐시: .gitea/actions/trivy-db-cache가 취약점 DB(133 MB)와 이미지 job의 Java 색인(952 MB)을 복원한다. 이미지 job 7.0분 가운데 2.8분이 이 내려받기였다. 저장은 main만 한다.
  3. redis-topology 11행 → job 하나의 step 11개: 행마다 job을 새로 시작하는 비용을 없앤다(run 100에서 이 행들이 26분).
  4. httpclient-transport 2행 → job 하나의 step 2개.
  5. JPA platform 계약 시험이 PostgreSQL 서버를 JVM에서 나눠 쓴다. JpaPlatformContractSupport의 Javadoc은 「공유한다」고 했지만, 실제로는 클래스 42개가 저마다 컨테이너를 띄웠다(contract lane 75개·기동 181초, migration lane 36개·71초). 이제 major마다 서버 하나에 support마다 database 하나를 만들고, close에서 지운다. 이 lane들은 main job, release gate 셋, nightly 행렬 셋, chaos job에서 돈다.
  6. PR 단계가 작업 지침 검사(check-work-docs.py)도 돈다(verifyWorkDocs). verify.sh와 gates.md는 이 검사가 prCheck 안이라고 적었지만 실제로는 빠져 있었다. 그래서 docs/work/operate.md를 151줄(상한 150)로 만든 #12가 PR 초록으로 main에 들어갔고, main(a7e38c10)에서 scripts/verify.sh docs가 실패한다. 이 PR이 main을 받으면서 그 줄을 상한 안으로 되돌리고(caa71d32), 검사를 붙였다(13ed3a1d).

고른 방법과 버린 대안

커밋마다 본문에 적었다. 결정이 큰 것만 모은다.

결정 고른 것 버린 것과 이유
main job 줄 순서만 바꾼다. 같은 단계, 같은 태스크 집합 실서버 슬롯 늘리기: 시간에 민감한 web·WebSocket lane이 함께 돌면 실패해서 하나로 둔 것(2026-11-01 리뷰)
Trivy DB 기간이 든 key로 복원하고, 최신 판단은 Trivy에 맡긴다(DB metadata) --skip-db-update: DB가 오래될 수 있다. key 고정: 첫 사본이 영원히 남는다
PostgreSQL 서버 공유 major마다 서버 하나, support마다 create database·close에서 drop database ... with (force) 컨테이너 tmpfs·fsync 끄기: 재시작·장애 복구 계약의 조건이 바뀐다. Testcontainers reuse: CI에서 일부러 끈 설정
Redis·transport 행 job 하나, 행마다 step, if: always() 버전마다 job: 시작 비용이 남는다. 셸 반복문: 실패한 행이 step 이름에 안 보인다
작업 지침 검사 prCheck에 Exec 태스크 하나(check-docs.py·check-repo-layout.py와 같은 모양) pr.yml에 python step 따로: 단계 job은 Gradle 한 줄이라는 verifyStrictLaneStages 형식과 어긋나고, verify.sh pr와 workflow가 다른 것을 돌린다
B2(소유자 결정 대기였던 중복 제거) 둘 다 유지 chaos job의 PostgreSQL 재실행은 「한 번 초록은 이 시험들에 대해 가장 적게 말한다」고 일부러 둔 반복이다. nightly jpa-postgresql(16)은 main job이 같은 run에서 16을 돌려 중복이지만, JpaReleaseRenderingTest가 nightly 행렬 = Stable major 목록을 계약으로 본다. 빼면 그 계약을 바꿔야 한다. 목표는 다른 대책으로 맞춘다
C2(gradle/actions의 독점 캐시 구성요소) 유지 cache-provider: basic은 job마다 Gradle 홈 전체를 따로 저장해서 5 GB 캐시 상한을 넘기기 쉽다. 이 repo의 PR 캐시 설계가 지금 구성요소의 key 동작에 기대고 있다
NFS 호스트 모듈 소유자 sudo 한 번(/etc/modules-load.d/nfsd.conf + modprobe nfsd). owner-sudo-bundle에 넣어 달라고 k3s 세션에 보냈다 사용자 공간 NFS 서버(NFS-Ganesha)로 바꾸기: lane이 시험하는 커널 NFS의 동작이 달라진다

위험과 영향

  • integration lane이 main 단계 분석과 같은 시간에 돈다. 지금도 앞 10분에는 전송 qualification lane이 그렇게 돌았다. desktop 한 번과 runner run 136(738fe700)의 main job은 실패 0이었다. 병합 뒤 main push에서 한 번 더 본다.
  • Trivy Java 색인이 runner 캐시(5 GB 상한)의 약 1 GB를 쓴다. key가 3일 단위라 1주에 두 번쯤 새로 저장된다.
  • Redis·transport 결과가 UI에서 job이 아니라 step 단위로 보인다. job 하나가 시간 제한에 걸리면 남은 행이 함께 멈춘다(제한 90분, 행 합계 약 20분).
  • 캐시 효과는 main이 한 번 저장한 뒤부터다(Trivy DB). 이 PR의 실행에서는 복원이 비고, 병합 뒤 측정에서 보인다.
  • PostgreSQL 서버를 lane 안의 클래스들이 나눠 쓴다. 표·스키마·Flyway 이력은 database마다 따로다. 서버 전체에 걸리는 것은 섞인다.
    • role: 만드는 계약은 PostgreSqlSecurityContractTest 하나다. lane마다 JVM이 따로라 이름이 겹치지 않는다.
    • ALTER SYSTEM 같은 서버 설정: 지금 쓰는 계약은 없다(검색으로 확인). 그런 계약을 새로 쓰면 같은 lane의 다음 클래스가 그 설정을 본다.
  • 파생 서비스도 PR에서 작업 지침 분량 상한을 지켜야 한다. docs/ci-cd/template-vs-consumer.md에 행을 더했다.
  • main job 시간은 이제 슬롯 lane 시간의 합이 정한다. 남은 큰 몫은 mongo lane(failover 컨테이너 9개)과 readiness lane 22개다. readiness lane은 lane마다 JVM이 따로다.

검증

desktop

명령 커밋 rc 시간 비고
./gradlew :integrationCheck :mainCheck --continue --no-build-cache(측정 init script) e7be517e 0 1,484초 실패 0, 슬롯 60초부터 참. 같은 명령의 예전 순서는 1,760초(aeb60339)
scripts/verify.sh pr --no-cache 738fe700(트리 71bbb9d6, 부하 40) 0 :prCheck 376초, strict 20초 시험 6,721·실패 0, FROM-CACHE 0. :verifyStrictLaneStages가 바뀐 line을 받는다
persistence-jpa spotlessCheck·spotbugsPostgresqlIntegrationTest·컴파일 6c69384c 0 67초
platform lane 다섯(contract·migration·failure·security·queryplan), --no-build-cache 6c69384c 0 288초 jpaPlatformContractTest 328초 → 148초(−55%). jpaPlatformMigrationTest 103 → 105초로 그대로: 이 lane의 컨테이너 36개는 JpaPlatformContractSupport 밖에서 띄운다(다음 후보). 로그 desktop ~/w2-be-ci-perf-logs/r2/jpa-*.log
jpaReleaseQualification -Pjpa.matrix.versions=18, --no-build-cache 6c69384c 0 333초 같은 폴더 summary.txt
scripts/verify.sh pr --no-cache 13ed3a1d(트리 9f1f746f, 시작 부하 12.6) 0 :prCheck 416초, strict 23초 527 태스크 전부 실행, FROM-CACHE 0, 시험 6,724·실패 0(#12가 더한 3개 포함), :verifyWorkDocs 실행. 로그 desktop ~/claude-w2-be-ci-perf-2-logs/pr.log
scripts/verify.sh docs 네 검사(노트북) 13ed3a1d 0 — main(a7e38c10)만 받은 트리 0d0cb12f에서는 rc=1(operate.md 151/150)

runner

run 무엇 결과
132 main push, 새 main(e7be517e) 초록 6/6, 42.1분. run 129에서 빨갛던 integration·links가 초록
125 release 수동(9682c52c) 초록, gate 32.5분 + 이미지 7.0분
134 release 수동, 새 main(e7be517e) gate 10 job 초록, job 시간 합 33.9분(run 125는 32.5분). app-image-release 초록 7.2분(Trivy 캐시 전). 합 41.1분, 서명 job은 runner 대기
136 main.yml 수동(nightly와 같은 job), 738fe700 — PostgreSQL 서버 공유 커밋 전 job 시간 합 105.7분(run 100은 135.3분), 19 job 중 18 초록. 빨강은 fileserver-nfs-ambiguity 하나: 호스트에 nfsd 모듈이 없다는 사전 확인(소유자 sudo). main job 22.6분(run 132 35.9분), push 단계 job 합 26.3분, jpa-postgresql 16·17·18 각 5.05.2분(run 100 5.97.1), httpclient-transport 한 job 0.9분(두 job 1.7), redis-topology 한 job 13.2분(11 job 26.3), compose-smoke 26.2분, done 11.7분, performance 초록 1.9분
137 main push, a7e38c10(이 PR 전 줄 순서) 초록 6/6, job 시간 합 30.7분, main job 25.7분. 같은 job이 run 132에서 35.9분이었으니 desktop 부하에 따라 10분쯤 흔들린다
141 이 PR pr / done(13ed3a1d) 초록, 12.3분: :prCheck 10분 44초(527 태스크 중 캐시 8), strict 15초, Trivy 61초(DB 캐시 비어 내려받기 28초). PR은 캐시를 읽기만 하고 main 쪽 저장이 아직 없어서, 빌드 캐시·Trivy DB 효과는 병합 뒤 nightly done이 채운 다음 PR에서 보인다

리뷰어가 볼 곳

  • build.gradle strictLaneStages의 line과 그 주석: 순서를 바꾼 이유와 측정값.
  • .gitea/actions/trivy-db-cache/action.yml: key 기간과 main만 저장하는 규칙.
  • .gitea/workflows/main.yml의 redis-topology·httpclient-transport: step마다 if: always().

관련

  • PR #13(첫 라운드), 공유 노트 w2-be-ci-perf.md(진단·기준값·대책 표)
  • design-docs template-program/README.md 4절 W2
## 무엇을, 왜 #13 병합 뒤 새 main(e7be517e)에서 잰 runner 값은 목표에 못 미쳤다. | 단계 | 기준(새 main) | 목표 | |---|---|---| | main push | 42.1분(run 132, main job 35.9분) | ≤ 30분 | | nightly | 135.3분(run 100, 같은 job 구성) | ≤ 120분, 전부 초록(performance 포함) | | release | 39.7분(run 125: gate 32.5분 + 이미지 7.0분) | ≤ 35분 | | PR | 12.0분(run 130) | ≤ 8분 | 시간은 runner job 시간의 합이다. runner 한 대가 job을 하나씩 돌리므로, 대기를 뺀 벽시계와 같다. 이 PR은 여섯 가지를 바꾼다. 1. **main job 줄 순서**: `./gradlew :integrationCheck :mainCheck --continue`. 실서버 lane은 build 전체에서 슬롯 하나를 쓴다. 지금 순서에서는 lane이 시작 10분 동안 그 슬롯을 거의 못 쓰고, 그 뒤 19분은 한가한 기계에서 하나씩 돈다. desktop에서 1,760초 → 1,484초(−16%)였다. 2. **Trivy DB 캐시**: `.gitea/actions/trivy-db-cache`가 취약점 DB(133 MB)와 이미지 job의 Java 색인(952 MB)을 복원한다. 이미지 job 7.0분 가운데 2.8분이 이 내려받기였다. 저장은 main만 한다. 3. **redis-topology 11행 → job 하나의 step 11개**: 행마다 job을 새로 시작하는 비용을 없앤다(run 100에서 이 행들이 26분). 4. **httpclient-transport 2행 → job 하나의 step 2개**. 5. **JPA platform 계약 시험이 PostgreSQL 서버를 JVM에서 나눠 쓴다**. `JpaPlatformContractSupport`의 Javadoc은 「공유한다」고 했지만, 실제로는 클래스 42개가 저마다 컨테이너를 띄웠다(contract lane 75개·기동 181초, migration lane 36개·71초). 이제 major마다 서버 하나에 support마다 database 하나를 만들고, close에서 지운다. 이 lane들은 main job, release gate 셋, nightly 행렬 셋, chaos job에서 돈다. 6. **PR 단계가 작업 지침 검사(`check-work-docs.py`)도 돈다**(`verifyWorkDocs`). `verify.sh`와 `gates.md`는 이 검사가 `prCheck` 안이라고 적었지만 실제로는 빠져 있었다. 그래서 `docs/work/operate.md`를 151줄(상한 150)로 만든 #12가 PR 초록으로 main에 들어갔고, main(a7e38c10)에서 `scripts/verify.sh docs`가 실패한다. 이 PR이 main을 받으면서 그 줄을 상한 안으로 되돌리고(caa71d32), 검사를 붙였다(13ed3a1d). ## 고른 방법과 버린 대안 커밋마다 본문에 적었다. 결정이 큰 것만 모은다. | 결정 | 고른 것 | 버린 것과 이유 | |---|---|---| | main job | 줄 순서만 바꾼다. 같은 단계, 같은 태스크 집합 | 실서버 슬롯 늘리기: 시간에 민감한 web·WebSocket lane이 함께 돌면 실패해서 하나로 둔 것(2026-11-01 리뷰) | | Trivy DB | 기간이 든 key로 복원하고, 최신 판단은 Trivy에 맡긴다(DB metadata) | `--skip-db-update`: DB가 오래될 수 있다. key 고정: 첫 사본이 영원히 남는다 | | PostgreSQL 서버 공유 | major마다 서버 하나, support마다 `create database`·close에서 `drop database ... with (force)` | 컨테이너 tmpfs·fsync 끄기: 재시작·장애 복구 계약의 조건이 바뀐다. Testcontainers reuse: CI에서 일부러 끈 설정 | | Redis·transport 행 | job 하나, 행마다 step, `if: always()` | 버전마다 job: 시작 비용이 남는다. 셸 반복문: 실패한 행이 step 이름에 안 보인다 | | 작업 지침 검사 | `prCheck`에 Exec 태스크 하나(`check-docs.py`·`check-repo-layout.py`와 같은 모양) | `pr.yml`에 python step 따로: 단계 job은 Gradle 한 줄이라는 `verifyStrictLaneStages` 형식과 어긋나고, `verify.sh pr`와 workflow가 다른 것을 돌린다 | | B2(소유자 결정 대기였던 중복 제거) | **둘 다 유지** | chaos job의 PostgreSQL 재실행은 「한 번 초록은 이 시험들에 대해 가장 적게 말한다」고 일부러 둔 반복이다. nightly jpa-postgresql(16)은 main job이 같은 run에서 16을 돌려 중복이지만, `JpaReleaseRenderingTest`가 nightly 행렬 = Stable major 목록을 계약으로 본다. 빼면 그 계약을 바꿔야 한다. 목표는 다른 대책으로 맞춘다 | | C2(gradle/actions의 독점 캐시 구성요소) | **유지** | `cache-provider: basic`은 job마다 Gradle 홈 전체를 따로 저장해서 5 GB 캐시 상한을 넘기기 쉽다. 이 repo의 PR 캐시 설계가 지금 구성요소의 key 동작에 기대고 있다 | | NFS 호스트 모듈 | 소유자 sudo 한 번(`/etc/modules-load.d/nfsd.conf` + `modprobe nfsd`). owner-sudo-bundle에 넣어 달라고 k3s 세션에 보냈다 | 사용자 공간 NFS 서버(NFS-Ganesha)로 바꾸기: lane이 시험하는 커널 NFS의 동작이 달라진다 | ## 위험과 영향 - **integration lane이 main 단계 분석과 같은 시간에 돈다.** 지금도 앞 10분에는 전송 qualification lane이 그렇게 돌았다. desktop 한 번과 runner run 136(738fe700)의 main job은 실패 0이었다. 병합 뒤 main push에서 한 번 더 본다. - **Trivy Java 색인이 runner 캐시(5 GB 상한)의 약 1 GB를 쓴다.** key가 3일 단위라 1주에 두 번쯤 새로 저장된다. - **Redis·transport 결과가 UI에서 job이 아니라 step 단위로 보인다.** job 하나가 시간 제한에 걸리면 남은 행이 함께 멈춘다(제한 90분, 행 합계 약 20분). - **캐시 효과는 main이 한 번 저장한 뒤부터다**(Trivy DB). 이 PR의 실행에서는 복원이 비고, 병합 뒤 측정에서 보인다. - **PostgreSQL 서버를 lane 안의 클래스들이 나눠 쓴다.** 표·스키마·Flyway 이력은 database마다 따로다. 서버 전체에 걸리는 것은 섞인다. - role: 만드는 계약은 `PostgreSqlSecurityContractTest` 하나다. lane마다 JVM이 따로라 이름이 겹치지 않는다. - `ALTER SYSTEM` 같은 서버 설정: 지금 쓰는 계약은 없다(검색으로 확인). 그런 계약을 새로 쓰면 같은 lane의 다음 클래스가 그 설정을 본다. - **파생 서비스도 PR에서 작업 지침 분량 상한을 지켜야 한다.** `docs/ci-cd/template-vs-consumer.md`에 행을 더했다. - **main job 시간은 이제 슬롯 lane 시간의 합이 정한다.** 남은 큰 몫은 mongo lane(failover 컨테이너 9개)과 readiness lane 22개다. readiness lane은 lane마다 JVM이 따로다. ## 검증 **desktop** | 명령 | 커밋 | rc | 시간 | 비고 | |---|---|---|---|---| | `./gradlew :integrationCheck :mainCheck --continue --no-build-cache`(측정 init script) | e7be517e | 0 | 1,484초 | 실패 0, 슬롯 60초부터 참. 같은 명령의 예전 순서는 1,760초(aeb60339) | | `scripts/verify.sh pr --no-cache` | 738fe700(트리 71bbb9d6, 부하 40) | 0 | `:prCheck` 376초, strict 20초 | 시험 6,721·실패 0, FROM-CACHE 0. `:verifyStrictLaneStages`가 바뀐 `line`을 받는다 | | persistence-jpa `spotlessCheck`·`spotbugsPostgresqlIntegrationTest`·컴파일 | 6c69384c | 0 | 67초 | | | platform lane 다섯(contract·migration·failure·security·queryplan), `--no-build-cache` | 6c69384c | 0 | 288초 | `jpaPlatformContractTest` 328초 → 148초(−55%). `jpaPlatformMigrationTest` 103 → 105초로 그대로: 이 lane의 컨테이너 36개는 `JpaPlatformContractSupport` 밖에서 띄운다(다음 후보). 로그 desktop `~/w2-be-ci-perf-logs/r2/jpa-*.log` | | `jpaReleaseQualification -Pjpa.matrix.versions=18`, `--no-build-cache` | 6c69384c | 0 | 333초 | 같은 폴더 `summary.txt` | | `scripts/verify.sh pr --no-cache` | 13ed3a1d(트리 9f1f746f, 시작 부하 12.6) | 0 | `:prCheck` 416초, strict 23초 | 527 태스크 전부 실행, FROM-CACHE 0, 시험 6,724·실패 0(#12가 더한 3개 포함), `:verifyWorkDocs` 실행. 로그 desktop `~/claude-w2-be-ci-perf-2-logs/pr.log` | | `scripts/verify.sh docs` 네 검사(노트북) | 13ed3a1d | 0 | — | main(a7e38c10)만 받은 트리 0d0cb12f에서는 rc=1(`operate.md` 151/150) | **runner** | run | 무엇 | 결과 | |---|---|---| | 132 | main push, 새 main(e7be517e) | 초록 6/6, 42.1분. run 129에서 빨갛던 integration·links가 초록 | | 125 | release 수동(9682c52c) | 초록, gate 32.5분 + 이미지 7.0분 | | 134 | release 수동, 새 main(e7be517e) | gate 10 job 초록, job 시간 합 33.9분(run 125는 32.5분). `app-image-release` 초록 7.2분(Trivy 캐시 전). 합 41.1분, 서명 job은 runner 대기 | | 136 | main.yml 수동(nightly와 같은 job), 738fe700 — PostgreSQL 서버 공유 커밋 전 | job 시간 합 **105.7분**(run 100은 135.3분), 19 job 중 18 초록. 빨강은 `fileserver-nfs-ambiguity` 하나: 호스트에 nfsd 모듈이 없다는 사전 확인(소유자 sudo). main job 22.6분(run 132 35.9분), push 단계 job 합 26.3분, jpa-postgresql 16·17·18 각 5.0~5.2분(run 100 5.9~7.1), httpclient-transport 한 job 0.9분(두 job 1.7), redis-topology 한 job 13.2분(11 job 26.3), compose-smoke 26.2분, `done` 11.7분, performance 초록 1.9분 | | 137 | main push, a7e38c10(이 PR 전 줄 순서) | 초록 6/6, job 시간 합 30.7분, main job 25.7분. 같은 job이 run 132에서 35.9분이었으니 desktop 부하에 따라 10분쯤 흔들린다 | | 141 | 이 PR `pr / done`(13ed3a1d) | **초록**, 12.3분: `:prCheck` 10분 44초(527 태스크 중 캐시 8), strict 15초, Trivy 61초(DB 캐시 비어 내려받기 28초). PR은 캐시를 읽기만 하고 main 쪽 저장이 아직 없어서, 빌드 캐시·Trivy DB 효과는 병합 뒤 nightly `done`이 채운 다음 PR에서 보인다 | ## 리뷰어가 볼 곳 - `build.gradle` `strictLaneStages`의 `line`과 그 주석: 순서를 바꾼 이유와 측정값. - `.gitea/actions/trivy-db-cache/action.yml`: key 기간과 main만 저장하는 규칙. - `.gitea/workflows/main.yml`의 `redis-topology`·`httpclient-transport`: step마다 `if: always()`. ## 관련 - PR #13(첫 라운드), 공유 노트 `w2-be-ci-perf.md`(진단·기준값·대책 표) - design-docs `template-program/README.md` 4절 W2
donghyeon.kang added 5 commits 2026-11-12 10:38:51 +00:00
문제: 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 본문에 적는다.
문제: 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 본문에 적는다.
문제: 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)을 확인했다.
문제: 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 컨테이너 기동, 후속).
첫 라운드 actual 정정 줄은 PR #13 병합 직전에 적었지만, 커밋하면 초록 run이
새 head로 밀려서 공유 노트에 두었던 것이다(작업 중 555분, 결과 partial).
둘째 라운드 예측은 p50 240분이고 근거는 줄의 basis 칸에 있다.
donghyeon.kang added 1 commit 2026-11-12 11:01:07 +00:00
문제: `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의 다음
클래스가 본다. 지금 그런 계약은 없다(검색으로 확인).
donghyeon.kang added 3 commits 2026-11-12 12:08:36 +00:00
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.
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로 본다.
donghyeon.kang merged commit ca1fbfde79 into main 2026-11-12 15:00:37 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#15