문제: 재리뷰 수정 커밋(e6db1629)만 다시 본 2차 재리뷰가 Important 7건,
Minor 22건을 찾았다. 결과 불명 503 뒤 같은 키를 다시 보내면 Redis
store가 lease 지난 실행을 넘겨받아 작업을 다시 돌렸다. replay TTL이
lease보다 짧으면 lease 도중 key가 사라져 같은 키가 두 번 실행됐다.
@SystemInvoked 규칙이 매뉴얼 09장의 이벤트 소비 경로까지 막았다. V22가
outbox_event에 가장 강한 잠금을 lock_timeout 없이 걸었다. prod의
fixture- 거부가 HOSTNAME 같은 비밀 아닌 값까지 막았다. 데모 허용 목록의
test·demo 프로필로 sample이 뜨지 않았다. 기동 rule bean의 @Value 필드가
조용히 null이 됐다.
방법: 영역별 4묶음이 test-driven-development 절차로 실패 테스트를
먼저 쓰고 고쳤다. 결정은 재리뷰 README 9.1절이다.
- 두 멱등성 store가 같은 계약을 따른다. lease가 지난 실행 기록은 다시
돌리지 않고 포기로 표시해 500 RECOVERY_REQUIRED로 답한다. 기록 수명은
lease + replay TTL이고, replay-ttl < processing-lease면 기동이 실패한다.
- 사용자 transport만 @SystemInvoked use case에 닿지 못한다. 메시지
handler·scheduler는 새 표시 @SystemCaller(reason)를 달고 use case를
생성자에서 new로 만든다. 매뉴얼 경로를 테스트로 고정했다.
- 아직 어디에도 적용되지 않은 마이그레이션(V20·V22·알림 V11~V13·sample
V8_1·grpc V002·V003)에 lock_timeout 5s를 넣고, 텍스트 검사기와 실 PG
lane을 더했다. 이미 배포된 24개는 동결 목록으로 둔다.
- fixture- 검사는 비밀로 분류된 값만 본다. sample은 local·test·demo에서
object storage를 끈다. 기동 rule bean에 주입 멤버가 있으면 모든
프로필에서 기동이 실패한다. 리뷰어가 제안한 "static @Bean 선언 강제"는
문제없는 등록을 막고 @Value 필드는 통과시켜서 버렸다.
- 이 수정 전에 move된 파일의 쿼터 차이를 찾는 쿼리와 재계산 SQL을
docs/fileserver/operations.md에 적었다.
위험·한계: lease 뒤 늦게 끝난 첫 시도의 결과는 기록되지 않는다(그 요청도
500). @SystemCaller가 없는 메시지 handler, 주입 멤버가 있는 기동 rule,
working-directory 없이 ./gradlew를 부르는 workflow 명령은 파생 서비스에서
새로 실패하거나 세지지 않는다(업그레이드 안내 B-14~16·B-36·B-39).
spotbugsTestFixtures는 게이트 밖이고 기준 커밋에서도 실패하며, 새 검사기의
정규식 경고 8건이 더해졌다. 실제 CI runner 실행은 확인하지 못했다(Gitea
repo의 Actions가 꺼져 있다).
검증: ci, 두 빌드의 verifyStrictLaneStages --dry-run, mainCheck,
:integrationCheck, -p optional-platforms ci integrationCheck
performanceCheck, :performanceCheck, :releaseCheck(-PgitRevision),
verify-compose-profile-contracts(18 lane) 첫 실행 통과. 쿼터 재계산
SQL은 실 PostgreSQL 16에서 차이 2행 → 0행을 확인했다.
Refs: docs/reviews/2026-11-03-rereview/README.md 9·9.1·10절
BREAKING CHANGE: replay-ttl < processing-lease 설정은 기동 실패, ledger
release가 claim token을 받는다, HttpBodyReadException(IOException 하위)이
본문 실패를 싣는다, 기동 rule·비밀 목록 bean의 주입 멤버 금지,
verifyStrictLaneStages가 workflow 명령의 working-directory로 빌드를 정한다.
84 lines
4.6 KiB
Groovy
84 lines
4.6 KiB
Groovy
plugins {
|
|
id 'ca.architecture'
|
|
// Every strict lane of this build belongs to a stage a workflow executes, checked here exactly
|
|
// as in the main build: the main build's check cannot see this build's lanes, and while only it
|
|
// applied the plugin, grpcPerformanceTest ran nowhere (review 2026-11-03 RR-06-03).
|
|
id 'ca.strict-lane-stages'
|
|
}
|
|
|
|
// No `ca.release-provenance` any more: each gRPC leaf's `ca.java-conventions` derives its version
|
|
// and `sourceRevision` from the same -PreleaseVersion/-PgitRevision (GIT_SHA, GITHUB_SHA) inputs the
|
|
// main build reads, so one commit produces one version scheme in both builds (review BUILD-O3-5).
|
|
|
|
tasks.register('resolveAndLockAll') {
|
|
group = 'build setup'
|
|
description = 'Regenerates dependency locks for every optional gRPC leaf (requires --write-locks).'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:resolveAndLockAll" }
|
|
}
|
|
|
|
tasks.register('checkAll') {
|
|
group = 'verification'
|
|
description = 'Runs every gRPC optional-platform leaf check.'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:check" }
|
|
}
|
|
|
|
tasks.register('qualityCheck') {
|
|
group = 'verification'
|
|
description = 'Runs production-bytecode static analysis for every optional-platform leaf.'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:qualityCheck" }
|
|
}
|
|
|
|
tasks.register('ci') {
|
|
group = 'verification'
|
|
description = 'Runs the optional gRPC platform verification surface.'
|
|
dependsOn tasks.named('checkAll')
|
|
dependsOn tasks.named('qualityCheck')
|
|
// architectureCheck, not only the direction gate: it also runs verifyNoIgnoredSourcePackages, so
|
|
// a gRPC source Git would drop fails this build's ci the way it fails the main build's.
|
|
dependsOn tasks.named('architectureCheck')
|
|
}
|
|
|
|
// A strict integration lane that no workflow invokes is not coverage; it is a file that looks like
|
|
// coverage. `grpc-operation-ledger-jpa` declares a Testcontainers PostgreSQL lane that certifies the
|
|
// atomic `INSERT ... ON CONFLICT DO NOTHING` claim the whole durable-idempotency contract rests on,
|
|
// and until this aggregate existed `ci` reached `checkAll`, `qualityCheck` and the dependency
|
|
// verifier only — none of which runs a lane whose category is INTEGRATION.
|
|
//
|
|
// Kept out of `ci`: every lane here starts a container, and `ci` is the per-PR gate for this build.
|
|
// The caller is integration-main.yml, the stage that owns container-backed lanes.
|
|
tasks.register('integrationCheck') {
|
|
group = 'verification'
|
|
description = 'Runs every optional-platform leaf integration test lane. Needs a container runtime.'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:integrationTestLaneCheck" }
|
|
}
|
|
|
|
// The performance stage of this build: grpcPerformanceTest. It asserts the shape of a measurement
|
|
// (ordered percentiles, a gate that reads them) with a generous budget, not a number, so it can run
|
|
// on a shared runner. integration-main.yml's performance-check job runs it next to the main build's
|
|
// `:performanceCheck`; before this aggregate it ran when somebody asked for it by name, which was
|
|
// nobody (review 2026-11-03 RR-06-03).
|
|
tasks.register('performanceCheck') {
|
|
group = 'verification'
|
|
description = 'Runs every optional-platform leaf performance test lane.'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:performanceTestLaneCheck" }
|
|
}
|
|
|
|
// The tag-only stage of this build: the hermetic strict lanes (the three gRPC certification lanes).
|
|
// Their tests already run inside each leaf's `test`; the lanes add the one thing `test` cannot say —
|
|
// that a tag still selects something — which is worth asserting once per release tag. release.yml
|
|
// runs this aggregate instead of naming the lanes, so a lane added here is in the release gate
|
|
// without a workflow edit.
|
|
tasks.register('releaseCheck') {
|
|
group = 'verification'
|
|
description = 'Runs every optional-platform leaf hermetic strict test lane (the release gate).'
|
|
dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:testLaneCheck" }
|
|
}
|
|
|
|
// The stages this build's strict lanes may belong to, executed by workflows as
|
|
// `./gradlew -p optional-platforms <stage>` from `src`. A command counts when it starts in this
|
|
// directory (working-directory joined with -p), which the plugin reads from where this build is.
|
|
strictLaneStages {
|
|
stage ':ci', ':integrationCheck', ':performanceCheck', ':releaseCheck'
|
|
workflowDirectory = layout.projectDirectory.dir('../../.github/workflows')
|
|
}
|