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 「넘길 것」)
This commit is contained in:
@@ -30,6 +30,11 @@ env:
|
|||||||
jobs:
|
jobs:
|
||||||
# The tag-only checks: release provenance and the public path baseline. Not `ci` again: a tag is
|
# 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.
|
# 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:
|
release:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
timeout-minutes: 30
|
timeout-minutes: 30
|
||||||
|
|||||||
+5
-4
@@ -8,7 +8,7 @@ plugins {
|
|||||||
// plugin reachable from two classpaths is two versions waiting to differ. Their versions are the
|
// 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.
|
// same catalog entries either way — build-logic/settings.gradle reads gradle/libs.versions.toml.
|
||||||
alias(libs.plugins.spring.boot) apply false
|
alias(libs.plugins.spring.boot) apply false
|
||||||
// JMH benchmarks in three leaves (`./gradlew :<leaf>:jmh`); never part of a gate.
|
// JMH benchmarks in the leaves that apply this plugin (`./gradlew :<leaf>:jmh`); never part of a gate.
|
||||||
alias(libs.plugins.jmh) apply false
|
alias(libs.plugins.jmh) apply false
|
||||||
|
|
||||||
// Convention plugin from the included build, applied to the ROOT because the rules it owns are
|
// 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
|
// 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
|
// two features into a throwaway copy of the working tree and that copy's own Gradle runs the checks
|
||||||
// checks they touch plus architectureCheck. A nested build of five leaves, so the main stage, not
|
// of the five leaves they touch plus architectureCheck, which runs every leaf's architecture lane. A
|
||||||
// the pull request. The script is the whole check; this task only gives it a stage.
|
// 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) {
|
tasks.register('verifyFeatureScaffold', Exec) {
|
||||||
group = 'verification'
|
group = 'verification'
|
||||||
description = 'Generates features with scripts/new-feature.sh in a scratch copy and runs the gates they must pass.'
|
description = 'Generates features with scripts/new-feature.sh in a scratch copy and runs the gates they must pass.'
|
||||||
|
|||||||
@@ -17,7 +17,7 @@
|
|||||||
| 대상 | 무엇을 지키는가 |
|
| 대상 | 무엇을 지키는가 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| `docs/design/**`, `docs/history/**` | 이 템플릿을 만든 과정의 설계서·계획서·납품 패키지·증거·학습 기록 |
|
| `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 필수 (파생 프로젝트가 유지해야 한다)
|
## Consumer 필수 (파생 프로젝트가 유지해야 한다)
|
||||||
|
|
||||||
@@ -37,7 +37,7 @@
|
|||||||
| `prCheck`의 `verifyWorkDocs` | 작업 지침의 분량 상한·본문 이력 ID 0·playbook 뼈대(`scripts/check-work-docs.py`). 파생 서비스도 `docs/work/`와 `AGENTS.md`를 받으니 같은 상한을 지킨다 |
|
| `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`) |
|
| `prCheck`의 `documentCheck`·`testDocumentChecks` | 문서 규칙(`scripts/check-docs.py`: 언어·머리 블록·참조·숫자·지도·링크·문체)과 Gradle 밖 스크립트·편집 훅의 시험(`scripts/tests/`). 파생 서비스의 문서도 같은 규칙을 따른다(`docs/README.md`) |
|
||||||
| `main.yml`의 `links` job | 문서의 외부 URL과 상대 링크(lychee) |
|
| `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 핀 | 공급망 |
|
| action의 전체 URL·full SHA 핀 | 공급망 |
|
||||||
|
|
||||||
## 파생 프로젝트가 할 일
|
## 파생 프로젝트가 할 일
|
||||||
|
|||||||
@@ -113,7 +113,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v
|
|||||||
|
|
||||||
1. 바뀐 파일 목록을 만든다: `git diff --name-only <기준 커밋> <합친 커밋>`.
|
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).
|
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 <topology> <version>` 줄은 desktop에서도 같은 줄로 돈다.
|
3. 그 job의 `run` 줄을 저장소 루트에서 그대로 돌린다. 행렬은 값마다 한 번이다. `redis-topology`는 행렬이 아니라 행마다 step 하나이고, 그 `scripts/ci/redis-topology.sh <topology> <version>` 줄은 desktop에서도 같은 줄로 돈다. desktop에서는 앞에 `GRADLE_OPTS=-Dorg.gradle.daemon=false`를 붙인다(스크립트 안의 `./gradlew`가 daemon을 남기지 않게. CI는 step 사이에 daemon을 다시 쓴다).
|
||||||
4. 고르지 않은 job은 이름과 "바뀐 영역 아님"을 결과 표에 적는다.
|
4. 고르지 않은 job은 이름과 "바뀐 영역 아님"을 결과 표에 적는다.
|
||||||
5. 처음 켠 job이 이번 변경과 무관한 이전부터의 실패를 드러내면(예: 진입 문서만 바꿨는데 그 영역 job을 돌림), 기준 커밋에서 같은 실패인지 보고 「이전부터」로 적는다. 그 영역의 남은 문제로 넘기고 이번 변경 몫으로 세지 않는다.
|
5. 처음 켠 job이 이번 변경과 무관한 이전부터의 실패를 드러내면(예: 진입 문서만 바꿨는데 그 영역 job을 돌림), 기준 커밋에서 같은 실패인지 보고 「이전부터」로 적는다. 그 영역의 남은 문제로 넘기고 이번 변경 몫으로 세지 않는다.
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -6,7 +6,7 @@
|
|||||||
# 단계 무엇 workflow
|
# 단계 무엇 workflow
|
||||||
# docs 문서·지침 검사와 스크립트 시험(Gradle 없음) pr.yml의 prCheck 안
|
# docs 문서·지침 검사와 스크립트 시험(Gradle 없음) pr.yml의 prCheck 안
|
||||||
# leaf <경로> registry gradle_path 하나의 check (작업 중)
|
# 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)
|
# main :mainCheck, :integrationCheck, build-logic 시험, 설정 캐시 main.yml(push)
|
||||||
# nightly compose smoke 전부, :performanceCheck(마지막) main.yml(nightly)
|
# nightly compose smoke 전부, :performanceCheck(마지막) main.yml(nightly)
|
||||||
# release :releaseCheck(이 커밋을 provenance로) release.yml `release`
|
# release :releaseCheck(이 커밋을 provenance로) release.yml `release`
|
||||||
|
|||||||
@@ -91,9 +91,9 @@ leaf마다 자기 시험이 검증하는 lane을 가지고, lane마다 돌아야
|
|||||||
|
|
||||||
| lane | `redis-runtime` | `redis-sdk` | `cache-redis` |
|
| 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` | — |
|
| sentinel | `LiveRedisCompositionTest` | `RedisTopologyContractTest`, `LiveRedisSentinelPromotionTest` | — |
|
||||||
| cluster | `LiveRedisCompositionTest` | `LiveRedisClusterTest`, `LiveRedisClusterTransactionTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest` |
|
| cluster | `LiveRedisCompositionTest` | `LiveRedisClusterTest`, `LiveRedisClusterTransactionTest` | `LiveRedisSemanticPortsTest`, `LiveRedisSemanticScriptAclProbeTest`, `LiveRedisDistributedLeaseContractTest`, `LiveRedisCacheRegionContractTest`, `LiveRedisIdempotencyStoreContractTest` |
|
||||||
| tls | `LiveRedisTlsTest` | — | — |
|
| tls | `LiveRedisTlsTest` | — | — |
|
||||||
|
|
||||||
lane은 `docker compose -f src/adapter/outbound/redis-sdk/compose/<lane>/compose.yml down -v`로 내린다.
|
lane은 `docker compose -f src/adapter/outbound/redis-sdk/compose/<lane>/compose.yml down -v`로 내린다.
|
||||||
|
|||||||
Reference in New Issue
Block a user