From 3272faeb38847dfb77b75b020ddad3cc9d7911b9 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:36:05 +0900 Subject: [PATCH] =?UTF-8?q?docs(ci):=20=EB=8B=A8=EA=B3=84=C2=B7job=20?= =?UTF-8?q?=EC=84=A4=EB=AA=85=EC=9D=84=20=EC=A7=80=EA=B8=88=20workflow?= =?UTF-8?q?=EC=99=80=20=EB=B9=8C=EB=93=9C=EC=97=90=20=EB=A7=9E=EC=B6=98?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit round9 확인 리뷰가 CI 파일의 설명이 실제와 다른 곳을 짚었다. - verify.sh 머리 표: PR 단계 job 이름이 `gradle`이다. 실제는 `done`. - build.gradle: JMH가 「세 leaf」에 있다고 하지만 지금은 플러그인을 쓰는 leaf가 정한다. verifyFeatureScaffold는 「leaf 다섯 중첩 빌드」라고 하지만 그 안의 architectureCheck가 모든 leaf의 architecture lane을 부른다. - release.yml: `release` job 주석은 「ci를 다시 돌리지 않는다」인데 뒤의 job들은 ci가 이미 돈 시험 일부를 다시 돈다. 그 이유(문서가 job id로 부르는 릴리스 증거이고, 이미지 job이 모두를 needs로 받아 같은 run·같은 커밋에서 통과한 뒤 publish한다)를 적었다. job은 그대로다. - gates.md 2절: redis-topology 줄을 desktop에서 그대로 돌리라고 하지만 스크립트 안 ./gradlew는 daemon을 남긴다. desktop에서는 GRADLE_OPTS=-Dorg.gradle.daemon=false를 붙이라고 적었다. 스크립트에 --no-daemon을 넣지 않은 이유: CI는 한 job의 step 11개가 daemon을 다시 쓴다. - redis-sdk compose README: cache-redis 칸에 필수 클래스가 둘뿐이다. build.gradle의 standalone·cluster 목록 다섯으로 맞췄다. - template-vs-consumer.md: object-storage-aws를 nightly job으로 적었다. 실제는 손으로 실행하고 입력 run_protected_aws를 켤 때만 돈다. 최상위 항목을 더하면 「AGENTS.md 지도를 함께 고친다」고 했지만 지도는 루트 목록을 두지 않고 check-repo-layout.py를 가리킨다. src/ 최상위 폴더일 때만 지도의 src/ 줄을 고친다고 적었다. 동작 변경 없음: workflow는 주석만, 스크립트는 머리 주석만 바꿨다. 검증: scripts/verify.sh docs(노트북) rc=0. Refs: round9 확인 리뷰(r9-be wave1-r4 「넘길 것」) --- .gitea/workflows/release.yml | 5 +++++ build.gradle | 9 +++++---- docs/ci-cd/template-vs-consumer.md | 4 ++-- docs/work/reference/gates.md | 2 +- scripts/verify.sh | 2 +- src/adapter/outbound/redis-sdk/compose/README.md | 4 ++-- 6 files changed, 16 insertions(+), 10 deletions(-) diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml index bd306484..8022ae99 100644 --- a/.gitea/workflows/release.yml +++ b/.gitea/workflows/release.yml @@ -30,6 +30,11 @@ env: jobs: # The tag-only checks: release provenance and the public path baseline. Not `ci` again: a tag is # cut from a main commit the pull-request and main stages already ran on. + # + # The jobs after this one do run again some tests `ci` ran (the web, WebSocket and HTTP client + # suites, the fileserver checks, three persistence-jpa tests). They are the release evidence the + # support documents name by job id, and the image job needs every one of them, so each of them + # passed in this run on this commit before anything is published. release: runs-on: ubuntu-latest timeout-minutes: 30 diff --git a/build.gradle b/build.gradle index b3a0b3e7..e892f1de 100644 --- a/build.gradle +++ b/build.gradle @@ -8,7 +8,7 @@ plugins { // plugin reachable from two classpaths is two versions waiting to differ. Their versions are the // same catalog entries either way — build-logic/settings.gradle reads gradle/libs.versions.toml. alias(libs.plugins.spring.boot) apply false - // JMH benchmarks in three leaves (`./gradlew ::jmh`); never part of a gate. + // JMH benchmarks in the leaves that apply this plugin (`./gradlew ::jmh`); never part of a gate. alias(libs.plugins.jmh) apply false // Convention plugin from the included build, applied to the ROOT because the rules it owns are @@ -145,9 +145,10 @@ tasks.register('testQualityCheck') { } // The feature generator's round trip (review 2026-11-01 개선 순서 4): scripts/new-feature.sh writes -// two features into a throwaway copy of the working tree and that copy's own Gradle runs the leaf -// checks they touch plus architectureCheck. A nested build of five leaves, so the main stage, not -// the pull request. The script is the whole check; this task only gives it a stage. +// two features into a throwaway copy of the working tree and that copy's own Gradle runs the checks +// of the five leaves they touch plus architectureCheck, which runs every leaf's architecture lane. A +// nested build that long belongs to the main stage, not the pull request. The script is the whole +// check; this task only gives it a stage. tasks.register('verifyFeatureScaffold', Exec) { group = 'verification' description = 'Generates features with scripts/new-feature.sh in a scratch copy and runs the gates they must pass.' diff --git a/docs/ci-cd/template-vs-consumer.md b/docs/ci-cd/template-vs-consumer.md index 63bd7d1f..060eb842 100644 --- a/docs/ci-cd/template-vs-consumer.md +++ b/docs/ci-cd/template-vs-consumer.md @@ -17,7 +17,7 @@ | 대상 | 무엇을 지키는가 | | --- | --- | | `docs/design/**`, `docs/history/**` | 이 템플릿을 만든 과정의 설계서·계획서·납품 패키지·증거·학습 기록 | -| `main.yml`의 nightly job(`jpa-postgresql`, `httpclient-transport`, `redis-topology`, `fileserver-nfs-ambiguity`, `notification-chaos`, `jpa-next`, `object-storage-aws`)과 `release.yml`의 영역별 release lane | 템플릿이 광고하는 지원 매트릭스의 근거. 서비스가 그 capability를 쓰면 남기고, 지운 capability의 job은 같이 지운다 | +| `main.yml`의 nightly job(`jpa-postgresql`, `httpclient-transport`, `redis-topology`, `fileserver-nfs-ambiguity`, `notification-chaos`, `jpa-next`), 손으로 실행할 때 입력 `run_protected_aws`를 켜야만 도는 `object-storage-aws`, `release.yml`의 영역별 release lane | 템플릿이 광고하는 지원 매트릭스의 근거. 서비스가 그 capability를 쓰면 남기고, 지운 capability의 job은 같이 지운다 | ## Consumer 필수 (파생 프로젝트가 유지해야 한다) @@ -37,7 +37,7 @@ | `prCheck`의 `verifyWorkDocs` | 작업 지침의 분량 상한·본문 이력 ID 0·playbook 뼈대(`scripts/check-work-docs.py`). 파생 서비스도 `docs/work/`와 `AGENTS.md`를 받으니 같은 상한을 지킨다 | | `prCheck`의 `documentCheck`·`testDocumentChecks` | 문서 규칙(`scripts/check-docs.py`: 언어·머리 블록·참조·숫자·지도·링크·문체)과 Gradle 밖 스크립트·편집 훅의 시험(`scripts/tests/`). 파생 서비스의 문서도 같은 규칙을 따른다(`docs/README.md`) | | `main.yml`의 `links` job | 문서의 외부 URL과 상대 링크(lychee) | -| `scripts/check-repo-layout.py`(`prCheck`의 `verifyRepositoryLayout`) | 저장소 최상위 배치. 서비스가 최상위 항목을 더하면 허용 목록과 `AGENTS.md` 지도를 함께 고친다 | +| `scripts/check-repo-layout.py`(`prCheck`의 `verifyRepositoryLayout`) | 저장소 최상위 배치. 서비스가 최상위 항목을 더하면 이 스크립트의 허용 목록을 고친다. `src/` 최상위 폴더면 `AGENTS.md` 지도의 `src/` 줄도 같은 변경에서 고친다(루트 항목은 지도에 목록이 없고 이 스크립트를 가리킨다) | | action의 전체 URL·full SHA 핀 | 공급망 | ## 파생 프로젝트가 할 일 diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 7b5c5da7..8bc7c673 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -113,7 +113,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v 1. 바뀐 파일 목록을 만든다: `git diff --name-only <기준 커밋> <합친 커밋>`. 2. 바뀐 영역의 job을 고른다: PostgreSQL major(`jpa-postgresql`, persistence-jpa), HTTP transport(`httpclient-transport`, httpclient), Redis topology(`redis-topology`, redis leaf 셋), NFS(`fileserver-nfs-ambiguity`, fileserver), 알림 chaos(`notification-chaos`), 릴리스 lane(`release.yml`의 같은 영역 job). -3. 그 job의 `run` 줄을 저장소 루트에서 그대로 돌린다. 행렬은 값마다 한 번이다. `redis-topology`는 행렬이 아니라 행마다 step 하나이고, 그 `scripts/ci/redis-topology.sh ` 줄은 desktop에서도 같은 줄로 돈다. +3. 그 job의 `run` 줄을 저장소 루트에서 그대로 돌린다. 행렬은 값마다 한 번이다. `redis-topology`는 행렬이 아니라 행마다 step 하나이고, 그 `scripts/ci/redis-topology.sh ` 줄은 desktop에서도 같은 줄로 돈다. desktop에서는 앞에 `GRADLE_OPTS=-Dorg.gradle.daemon=false`를 붙인다(스크립트 안의 `./gradlew`가 daemon을 남기지 않게. CI는 step 사이에 daemon을 다시 쓴다). 4. 고르지 않은 job은 이름과 "바뀐 영역 아님"을 결과 표에 적는다. 5. 처음 켠 job이 이번 변경과 무관한 이전부터의 실패를 드러내면(예: 진입 문서만 바꿨는데 그 영역 job을 돌림), 기준 커밋에서 같은 실패인지 보고 「이전부터」로 적는다. 그 영역의 남은 문제로 넘기고 이번 변경 몫으로 세지 않는다. diff --git a/scripts/verify.sh b/scripts/verify.sh index 0e4c90e5..95e220da 100755 --- a/scripts/verify.sh +++ b/scripts/verify.sh @@ -6,7 +6,7 @@ # 단계 무엇 workflow # docs 문서·지침 검사와 스크립트 시험(Gradle 없음) pr.yml의 prCheck 안 # leaf <경로> registry gradle_path 하나의 check (작업 중) -# pr :prCheck, :verifyStrictLaneStages --dry-run pr.yml `gradle` +# pr :prCheck, :verifyStrictLaneStages --dry-run pr.yml `done` # main :mainCheck, :integrationCheck, build-logic 시험, 설정 캐시 main.yml(push) # nightly compose smoke 전부, :performanceCheck(마지막) main.yml(nightly) # release :releaseCheck(이 커밋을 provenance로) release.yml `release` diff --git a/src/adapter/outbound/redis-sdk/compose/README.md b/src/adapter/outbound/redis-sdk/compose/README.md index 2592f65f..fa05014b 100644 --- a/src/adapter/outbound/redis-sdk/compose/README.md +++ b/src/adapter/outbound/redis-sdk/compose/README.md @@ -91,9 +91,9 @@ leaf마다 자기 시험이 검증하는 lane을 가지고, lane마다 돌아야 | lane | `redis-runtime` | `redis-sdk` | `cache-redis` | | --- | --- | --- | --- | -| standalone | `LiveRedisCompositionTest` | `RedisTopologyContractTest`, `LiveRedisGuardrailTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest` | +| standalone | `LiveRedisCompositionTest` | `RedisTopologyContractTest`, `LiveRedisGuardrailTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest`, `LiveRedisDistributedLeaseContractTest`, `LiveRedisCacheRegionContractTest`, `LiveRedisIdempotencyStoreContractTest` | | sentinel | `LiveRedisCompositionTest` | `RedisTopologyContractTest`, `LiveRedisSentinelPromotionTest` | — | -| cluster | `LiveRedisCompositionTest` | `LiveRedisClusterTest`, `LiveRedisClusterTransactionTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest` | +| cluster | `LiveRedisCompositionTest` | `LiveRedisClusterTest`, `LiveRedisClusterTransactionTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest`, `LiveRedisDistributedLeaseContractTest`, `LiveRedisCacheRegionContractTest`, `LiveRedisIdempotencyStoreContractTest` | | tls | `LiveRedisTlsTest` | — | — | lane은 `docker compose -f src/adapter/outbound/redis-sdk/compose//compose.yml down -v`로 내린다.