workflow 15개가 모듈 모양으로 나뉘어 같은 Gradle 태스크를 여러 번 돌렸고, 그것을 읽는 판독기(셸·YAML 해석, 운영 3,283줄)가 리뷰 라운드마다 결함을 냈다. 그런데 Gitea Actions가 꺼져 있어 workflow는 한 번도 돈 적이 없다(design-docs repo-structure/03-ci.md 2.1·3.4절).
소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧, 2026-11-07)대로 바꾼다.
Wave 1 (de070e16): 다른 단계가 이미 돌리는 job을 지운다. fileserver-pr 다섯, fileserver-nightly 재실행 셋, jpa-nightly lane 셋, notification pr, object storage MinIO 둘, link-check는 main으로.
Wave 2·3 (d46bab96): .gitea/workflows/{pr,main,release}.yml 셋으로 접는다. 무엇을 돌릴지는 Gradle 단계 태스크가 정한다(새 집계 prCheck). 필수 검사는 pr / done 하나다. verifyStrictLaneStages는 그래프 검사와 고정 문자열 형식 검사만 한다. 판독기를 지운다. 검증 진입점 scripts/verify.sh <단계>를 더한다.
작은 것: dev overlay heap dump를 named volume으로(61b1d575), 알림 문서·ADR을 test 입력으로(b9866407), docs/ci-cd/template-vs-consumer.md 표 갱신, 릴리스 secret 만드는 법(a2dfefb6), 비전·문제 정의 빈 양식(d0c3f91a).
runner에서 드러나 고친 것: Nginx lane이 job 컨테이너 안의 앱에 닿게(b0bca2a6, 9c202b7b), Redis topology 포워더의 주소 계산(74b0599f).
리뷰 반영 전 트리의 첫 main 단계는 spring70CompatibilityTest 연결 시간 초과 1건으로 실패했다(부하 18~24, runner job과 겹침). merge 트리 재실행은 통과했다.
Wave 1 증거: 기준 트리에서 workflow의 Gradle 명령 50개를 --dry-run해 이벤트별 태스크 집합을 만들었다. 지우거나 옮긴 job 27개의 태스크는 모두 단계 집계(:ci·:mainCheck·:integrationCheck·:performanceCheck·:releaseCheck) 계획 안에 있다(밖 0). PR에서 빠진 29개는 어댑터 컨테이너 lane 26(②)과 Redis standalone 3, main push에서 빠진 733개는 ci 672(PR이 돈다)와 performanceCheck 61(③). 로그 desktop ~/t2a-backend-ci-logs/wave1-base/.
망가뜨린 입력 ①②③(설계 7.4절)과 우회 입력 21가지: StrictLaneStagesFunctionalTest 27개 통과(build-logic 시험 123개 실패 0).
알림 ADR 존재 시험(NotificationReleaseGateTest)은 :adapter:outbound:notification:test → ci → prCheck 계획 안이다.
arch-reviewer(구조 리뷰): HARD-STOP 위반 0. 형식 검사 우회 입력 9건과 잔재 2건을 지적했고 모두 고쳐 시험으로 남겼다.
남은 문제
릴리스 이미지 검사: scripts/ci/trivy-scan.sh image가 기본 이미지(ubuntu 22.04)의 OS 취약점 HIGH 7건과 OS 패키지 라이선스 HIGH 370건으로 막는다. 옛 release.yml과 같은 명령이고, CI가 처음 돌면서 드러났다. 기본 이미지 갱신과 「OS 패키지 라이선스를 막을지」는 소유자 결정이다.
main.yml nightly job의 runner 환경 문제: compose smoke 8 lane, NFS 서버(dind에서 특권 컨테이너), lychee, 알림 chaos의 「이름 댄 suite가 돌았나」 단계(옛 workflow에서도 돈 적이 없던 검사), webJettyCompatTest 시간 초과 1건. desktop에서는 compose smoke 18 lane과 성능 lane이 모두 통과한다.
필수 검사가 늦게 나온다: runner가 하나이고 Gitea는 대기 job을 갱신 시각 순으로 준다. done은 앞 job이 끝난 뒤에야 대기열에 들어가 먼저 올라간 main·release job 뒤로 밀린다. runner를 하나 더 두거나 PR 단계를 한 job으로 합치는 안을 정해야 한다.
기준 커밋부터: 저장소 문서를 태그 없이 일반 test에서 읽는 시험 넷(NotificationReleaseGateTest 등). 이번 diff는 입력 선언만 보강했다.
## 무엇을, 왜
workflow 15개가 모듈 모양으로 나뉘어 같은 Gradle 태스크를 여러 번 돌렸고, 그것을 읽는 판독기(셸·YAML 해석, 운영 3,283줄)가 리뷰 라운드마다 결함을 냈다. 그런데 Gitea Actions가 꺼져 있어 workflow는 한 번도 돈 적이 없다(design-docs `repo-structure/03-ci.md` 2.1·3.4절).
소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧, 2026-11-07)대로 바꾼다.
- **Wave 1** (`de070e16`): 다른 단계가 이미 돌리는 job을 지운다. fileserver-pr 다섯, fileserver-nightly 재실행 셋, jpa-nightly lane 셋, notification `pr`, object storage MinIO 둘, link-check는 main으로.
- **Wave 2·3** (`d46bab96`): `.gitea/workflows/{pr,main,release}.yml` 셋으로 접는다. 무엇을 돌릴지는 Gradle 단계 태스크가 정한다(새 집계 `prCheck`). 필수 검사는 `pr / done` 하나다. `verifyStrictLaneStages`는 그래프 검사와 고정 문자열 형식 검사만 한다. 판독기를 지운다. 검증 진입점 `scripts/verify.sh <단계>`를 더한다.
- **작은 것**: dev overlay heap dump를 named volume으로(`61b1d575`), 알림 문서·ADR을 test 입력으로(`b9866407`), `docs/ci-cd/template-vs-consumer.md` 표 갱신, 릴리스 secret 만드는 법(`a2dfefb6`), 비전·문제 정의 빈 양식(`d0c3f91a`).
- **runner에서 드러나 고친 것**: Nginx lane이 job 컨테이너 안의 앱에 닿게(`b0bca2a6`, `9c202b7b`), Redis topology 포워더의 주소 계산(`74b0599f`).
- **장부**: 예측·실측과 하네스 회고 줄 셋(`78cbc865`).
| 지운 것·옮긴 것 | 어디로 |
| --- | --- |
| `ci-quality-gates.yml`, `docs-check.yml`, `build-logic.yml`(PR 부분) | `pr.yml` `gradle`: `./gradlew :prCheck`(ci + 잠금 + compose 렌더링 + 배치 + 문서 검사) |
| `integration-main.yml` | `main.yml` `main`·`integration`·`configuration-cache`·`http3-experimental`·`compose-smoke`(nightly)·`performance`(nightly, 마지막) |
| `pr-adapters.yml` | 매개 변수 없는 lane은 이미 `mainCheck`·`integrationCheck` 안(지움). 행렬은 `main.yml` nightly `jpa-postgresql`·`httpclient-transport` |
| `build-logic.yml` | `main.yml` `build-logic`(소유자 결정 ⑦) |
| `link-check.yml` | `main.yml` `links` |
| `dependency-vulnerability.yml` | `pr.yml`·`main.yml` `vulnerabilities`(`scripts/ci/trivy-scan.sh`). GitHub 전용 job 둘은 지움 |
| `jpa-nightly.yml`, `jpa-next.yml`, `redis-sdk-topology.yml`, `fileserver-nightly.yml`(NFS), `notification-platform.yml`(chaos), `object-storage-qualification.yml`(AWS) | `main.yml` nightly job |
| `fileserver-pr.yml` | 지움(모두 `ci` 안의 `test`). 지원 매트릭스 증거를 테스트 클래스로 |
| `release.yml` | `release.yml`(Gitea 레지스트리, cosign 키 쌍, 수동 실행은 push 앞까지) |
## 고른 방법과 버린 대안
- 고름: 단계 파일 셋 + 단계 job은 `./gradlew <단계>` 한 줄 + 형식 검사(설계 7절 B).
- 버림: workflow 하나에 `if:`로 단계 나누기(파일만 보고 단계를 모른다), 레지스트리에서 생성(셋째 사본), 바뀐 모듈만 돌리기(결정 30과 충돌), 판독기 유지(6라운드 결함 13건).
- 설계로 답이 안 나온 선택(PR 본문에 근거):
- 형식 검사는 그래프 검사와 같은 태스크다. 단계 계획을 `--dry-run`으로 읽어야 해서 `prCheck`에 넣을 수 없다. 그래서 pr job은 두 줄이고, 형식 검사가 둘째 줄의 존재도 요구한다.
- 문서 검사는 PR에 남겼다. 지금 PR에서 돌고 있었고, 단계를 옮기면 소유자 결정이다.
- `jpa-next`는 지우지 않고 nightly job으로 옮겼다. Experimental PostgreSQL 19 주장의 근거 lane이라 `JpaReleaseRenderingTest`가 요구한다.
- JPA 승격 job은 artifact 대조 대신 `needs: jpa-release-gate`(같은 실행의 행렬 전부)다. Gitea에서 artifact를 쓰지 않으려는 것이다.
- Redis topology lane은 cluster가 `127.0.0.1`을, TLS 인증서가 `localhost`를 전제한다. dind runner의 job 컨테이너에서는 `scripts/ci/forward-ports.py`로 포트를 넘긴다.
## 위험과 영향
- PR이 어댑터 컨테이너 lane과 Redis standalone lane을 더는 막지 않는다. main·nightly에서 빨갛게 된다(소유자 결정 ②). main push는 `ci`를 다시 돌리지 않는다. 보호 규칙 「오래된 브랜치 병합 막기」를 권한다.
- 성능 lane은 매 push가 아니라 nightly에서만, 다른 무거운 job 뒤에 돈다(③).
- `strictLaneStages` 문법, workflow 위치, 릴리스 레지스트리·서명이 바뀌었다. 파생 서비스 안내는 `docs/upgrade/2026-11-maturity-review.md` 3.10절 B-60~B-66.
- 메시징 분리(PR #8)를 merge 커밋으로 받았다(force push 없이). 메시징 인증 lane은 단계 태스크·workflow 어디에도 없다.
- 실제 태그 릴리스(이미지 push·서명)는 secret이 없어 돌려 보지 않았다.
## 검증
**Gitea runner**(desktop-runner, dind, 동시 1개):
| run | workflow | head | 결과 | 비고 |
| --- | --- | --- | --- | --- |
| 29 | pr.yml | `d46bab96` | gradle 성공(:prCheck 756 태스크 실행, 15분 55초), vulnerabilities 성공 | done은 다음 push로 취소 |
| 49 | pr.yml | `4d778c22`(main merge) | 성공(gradle 12분 38초, vulnerabilities, done) | 필수 검사 이름 `pr / done (pull_request)` |
| 53 | pr.yml(버리는 PR #9) | `76e50220` | **실패**: `DeliberateFailureTest > failsOnPurpose() FAILED` → `pr / done` 빨강 | 확인 뒤 PR 닫고 브랜치 지움 |
| 61 | pr.yml | `78cbc865` | 실패: Nginx 하네스 주석 한 줄 100칸 초과(spotless) | `9c202b7b`로 고침 |
| 64 | pr.yml | `9c202b7b`(최종) | **성공**: gradle(:prCheck 526 태스크 실행 11분 57초, verifyStrictLaneStages 통과), vulnerabilities, done | |
| 51 → 62 | release.yml(수동, push 앞까지) | `4d778c22` → `78cbc865` | 62: 증거 job 11개 모두 성공(51에서 실패한 websocket Nginx lane 포함). `app-image-release`는 Trivy 이미지 검사에서 실패: 기본 이미지(ubuntu 22.04) OS 취약점 HIGH 7, 라이선스 HIGH 370 | 남은 문제 1 |
| 52 | main.yml(수동, nightly 포함) | `4d778c22` | build-logic·configuration-cache·vulnerabilities·http3·jpa-postgresql 16/17/18·httpclient-transport 2·jpa-next 3 성공. 실패: main(webJettyCompatTest 시간 초과 1건), integration(Nginx lane, 고침), links, redis-topology 11(포워더 버그, 고침), fileserver-nfs(NFS 서버가 dind에서 못 뜸), notification-chaos(「이름 댄 suite가 돌았나」 단계), compose-smoke(8 lane) | 남은 문제 2 |
| 63 | main.yml(수동) | `78cbc865` | 대기열에서 도는 중 | |
**desktop**(merge 트리 `232d25e5`, 기준 `1272a5e4`, `scripts/verify.sh <단계> --on here --no-cache`, 로그 `~/t2a-backend-ci-logs/final/`):
| 단계 | 결과 | 시간 | 실제 실행 |
| --- | --- | --- | --- |
| pr | rc=0 | 59분(잠금 대기 포함) | `:prCheck` 526 태스크 실행, FROM-CACHE 0, 테스트 6,721 실패 0·건너뜀 28, `verifyStrictLaneStages` 통과 |
| main | rc=0 | 49분 | mainCheck 365 태스크(188 실행, 177은 pr 단계 출력), integrationCheck 205 태스크(117 실행), build-logic 시험, 설정 캐시 재사용. 바깥 FROM-CACHE 0(중첩 생성 명령 빌드 9) |
| release | rc=0 | 22분 | `:releaseCheck` |
| nightly | rc=0 | 32분 | compose smoke 18 lane 통과, `:performanceCheck` |
| Nginx 수정 | rc=0 | | `:adapter:inbound:websocket:websocketNginxTest`(수정 트리) |
| build-logic | rc=0 | | 시험 123 실패 0(`StrictLaneStagesFunctionalTest` 27) |
- 리뷰 반영 전 트리의 첫 main 단계는 `spring70CompatibilityTest` 연결 시간 초과 1건으로 실패했다(부하 18~24, runner job과 겹침). merge 트리 재실행은 통과했다.
- Wave 1 증거: 기준 트리에서 workflow의 Gradle 명령 50개를 `--dry-run`해 이벤트별 태스크 집합을 만들었다. 지우거나 옮긴 job 27개의 태스크는 모두 단계 집계(`:ci`·`:mainCheck`·`:integrationCheck`·`:performanceCheck`·`:releaseCheck`) 계획 안에 있다(밖 0). PR에서 빠진 29개는 어댑터 컨테이너 lane 26(②)과 Redis standalone 3, main push에서 빠진 733개는 `ci` 672(PR이 돈다)와 `performanceCheck` 61(③). 로그 desktop `~/t2a-backend-ci-logs/wave1-base/`.
- 망가뜨린 입력 ①②③(설계 7.4절)과 우회 입력 21가지: `StrictLaneStagesFunctionalTest` 27개 통과(build-logic 시험 123개 실패 0).
- 알림 ADR 존재 시험(`NotificationReleaseGateTest`)은 `:adapter:outbound:notification:test` → `ci` → `prCheck` 계획 안이다.
- `arch-reviewer`(구조 리뷰): HARD-STOP 위반 0. 형식 검사 우회 입력 9건과 잔재 2건을 지적했고 모두 고쳐 시험으로 남겼다.
## 남은 문제
1. **릴리스 이미지 검사**: `scripts/ci/trivy-scan.sh image`가 기본 이미지(ubuntu 22.04)의 OS 취약점 HIGH 7건과 OS 패키지 라이선스 HIGH 370건으로 막는다. 옛 release.yml과 같은 명령이고, CI가 처음 돌면서 드러났다. 기본 이미지 갱신과 「OS 패키지 라이선스를 막을지」는 소유자 결정이다.
2. **main.yml nightly job의 runner 환경 문제**: compose smoke 8 lane, NFS 서버(dind에서 특권 컨테이너), lychee, 알림 chaos의 「이름 댄 suite가 돌았나」 단계(옛 workflow에서도 돈 적이 없던 검사), webJettyCompatTest 시간 초과 1건. desktop에서는 compose smoke 18 lane과 성능 lane이 모두 통과한다.
3. **필수 검사가 늦게 나온다**: runner가 하나이고 Gitea는 대기 job을 갱신 시각 순으로 준다. `done`은 앞 job이 끝난 뒤에야 대기열에 들어가 먼저 올라간 main·release job 뒤로 밀린다. runner를 하나 더 두거나 PR 단계를 한 job으로 합치는 안을 정해야 한다.
4. 기준 커밋부터: 저장소 문서를 태그 없이 일반 `test`에서 읽는 시험 넷(`NotificationReleaseGateTest` 등). 이번 diff는 입력 선언만 보강했다.
## 리뷰어가 볼 곳
- `src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java`의 `formProblems`와 `src/build.gradle`의 `strictLaneStages`.
- `.gitea/workflows/*.yml` 셋.
- `scripts/verify.sh`(원격 실행: 패치 → 새 worktree → 트리 해시 비교 → 잠금 → 테스트 수 → 정리).
- 문서 대부분은 옛 workflow 이름을 새 job 이름으로 바꾼 것이다.
## 관련 문서
- design-docs `repo-structure/03-ci.md` 7절, `repo-structure/README.md` 3.3절, `harness/01-harness-design.md` 6절.
- `docs/work/reference/gates.md`(새 1·3절), `docs/work/operate.md` 4.1절.
workflow 15개 가운데 모듈 모양 파일들이 PR·main·nightly 단계가 이미
계획하는 Gradle 태스크를 한 번 더 돌린다(설계 design-docs
repo-structure/03-ci.md 3.1절 「중복」).
- fileserver-pr.yml 다섯 job: 모두 leaf `test`나 그 부분집합이다.
`ci`가 매 PR 돌린다.
- fileserver-nightly.yml의 --rerun-tasks job 셋: 같은 `test`의
부분집합이다. NFS job만 남긴다.
- jpa-nightly.yml의 failure·query plan·security·pool job: 모두
integration()·performance() lane이라 :integrationCheck·
:performanceCheck가 돈다. PostgreSQL major 행렬만 남긴다.
- notification-platform.yml의 pr job: `ci`와 :integrationCheck의
태스크다. 경로 필터가 docs/adr/로 옮긴 알림 ADR을 보지 못했다.
chaos job만 남긴다.
- object-storage-qualification.yml의 MinIO job 둘: integration lane이다.
보호된 AWS job만 남긴다.
- link-check.yml: 문서 검사라 main 단계로(소유자 결정 2026-09-16).
integration-main.yml의 links job으로 옮긴다.
fileserver 지원 매트릭스는 지운 job id 대신 그 증거를 실제로 만드는
테스트 클래스·모듈 test·남은 job을 적고, FileserverDocumentation
CoverageTest가 행마다 그 이름이 있는지 본다. job이 사라진 시험 문장
(PoolLaneClaimTest의 nightly job 검사, lychee 경로 필터 검사)은
지우거나 새 위치로 맞춘다.
위험: PR에서 경로로 켜지던 컨테이너 lane(notification의 실 PostgreSQL
두 lane, MinIO)은 이제 main push와 nightly에서만 돈다. 어댑터 컨테이너
lane을 main 단계로 옮긴 소유자 결정(2026-11-07 ②)과 같은 쪽이다.
검증: 기준 2959eff0의 desktop worktree에서 workflow의 Gradle 명령 50개를
--dry-run해 태스크 집합을 만들었다. 지운·옮긴 job 27개의 태스크는 모두
:ci·:mainCheck·:integrationCheck·:performanceCheck·:releaseCheck 계획
안에 있다(단계 집계 밖 0). 로그 desktop ~/t2a-backend-ci-logs/wave1-base/.
python3 scripts/check-docs.py, check-work-docs.py 통과.
Refs: design-docs repo-structure/03-ci.md 7.3절 Wave 1
dev lane overlay(src/app-bootstrap/compose-lanes/dev.yaml)가 heap dump
폴더를 bind mount `./tmp/heap-dumps`로 두었다. Docker가 그 폴더를 root
소유로 만들어, compose lane을 돌린 git worktree를 일반 사용자가 지우지
못했다(`git worktree remove`가 Permission denied). 그래서 operate.md
4.1절에 컨테이너로 폴더를 지우는 우회 문장이 있었다.
named volume `heap-dumps`로 바꾼다. dump는 컨테이너가 사라져도 남고,
`docker compose cp`로 꺼낸다. 우회 문장을 지운다.
버린 것: bind mount에 사용자 uid를 맞추기(이미지·환경마다 다르다).
검증: desktop PR 단계(`verifyComposeProfiles`가 렌더링된 모델의 mount
대상 중복을 본다)와 nightly compose smoke.
NotificationReleaseGateTest(알림 leaf의 `test`)는 docs/notification의
문서와 docs/adr의 NOTIF-ADR 넷이 있는지 본다. 그 파일들이 test 태스크의
입력이 아니어서, ADR을 옮기거나 지워도 Gradle이 태스크를 up-to-date나
캐시로 끝내고 시험이 다시 돌지 않았다. 지운 notification-platform.yml의
경로 필터가 docs/adr/로 옮긴 ADR을 못 보던 것과 같은 빈틈이다.
두 경로를 test의 입력으로 선언한다. 이 시험은 `ci` → `prCheck` 안에서
경로 필터 없이 매 PR 돈다(--dry-run 계획으로 확인).
검증: desktop PR 단계.
workflow 15개(+ composite action, jq 설치 스크립트)가 모듈 모양으로
나뉘어 있었고, 그것을 읽는 판독기(ShellScript·WorkflowGradleInvocations·
TaskSelectors, 운영 3,283줄과 그 시험 1,814줄)가 리뷰 라운드마다 새 셸
모양으로 결함을 냈다. 그런데 Gitea에서는 Actions가 꺼져 있어 workflow는
한 번도 돌지 않았다(design-docs repo-structure/03-ci.md 2.1·3.4절).
소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧)대로 바꾼다.
- .gitea/workflows/pr.yml: `gradle` job이 `./gradlew :prCheck`와
`./gradlew :verifyStrictLaneStages --dry-run` 두 줄, `vulnerabilities`
(trivy), 필수 검사 하나 `done`.
- main.yml: push마다 mainCheck·integrationCheck·build-logic 시험·
configuration cache·lychee·trivy·http3(권고). nightly·수동 실행에서
PostgreSQL major·HTTP transport·Redis topology 행렬, NFS, 알림 chaos,
jpa-next, compose smoke, 마지막에 `needs`로 performanceCheck.
- release.yml: releaseCheck와 기존 release lane, 이미지를 이 Gitea
레지스트리에 올리고 cosign 키 쌍으로 서명한다. 수동 실행은 push·서명
앞까지 돈다. upload/download-artifact를 쓰지 않는다. JPA 승격은
`needs: jpa-release-gate`가 대신한다.
- 새 집계 `prCheck` = ci + verifyDependencyLocks + compose 렌더링 +
저장소 배치 + 문서 검사(Exec). workflow와 verify.sh가 같은 한 줄을 쓴다.
- verifyStrictLaneStages: 그래프 검사(모든 strict lane이 선언한 단계의
계획에 있다)는 그대로 두고, workflow 쪽은 고정 문자열 형식 검사로
바꾼다. 단계마다 workflow·이벤트·필터·job·옵션·조건을 build.gradle에
선언하고, 그 job의 step이 `run: ./gradlew <단계> <옵션>`을 가지며 다른
run도 셸 문법 없는 ./gradlew 한 줄이고, 선언 밖의 if:, 조건 없는
needs:, continue-on-error·shell:·defaults:, 따옴표 키·flow 형식, 다른
working-directory, 선언 밖의 이벤트 필터가 없는지 본다. PR 단계 job
하나는 이 검사 자신을 돌려야 한다. 셸 해석 코드와 그 시험을 지운다
(build-logic 운영 코드 −3,167줄, 시험 −2,231줄). 우회 입력 21가지를
TestKit 시험으로 둔다.
- scripts/verify.sh <단계>: 사람·세션의 진입점. 무거운 단계는 지금 작업
트리를 패치로 desktop에 보내 잠금 아래에서 돌린다(operate.md 4.1절의
손 절차). scripts/ci/는 workflow가 부르는 trivy·Redis topology·포트
포워더·configuration cache 스크립트다.
- workflow를 읽는 시험(DeveloperExperienceContractTest, JpaRelease
RenderingTest, FileserverDocumentationCoverageTest)과 입력 선언을
.gitea로 옮기고, keyless 서명 시험을 키 쌍 서명 시험으로 바꾼다.
- 문서: gates.md·operate.md·docs/ci-cd·AGENTS.md(검증 절)·build-logic
AGENTS.md(셸 규칙 문단을 세 줄로)·leaf 문서의 workflow 참조,
docs/upgrade B-57~B-61.
버린 것: workflow 하나에 if:로 단계를 나누기(파일만 보고 단계를 알 수
없다), 레지스트리에서 생성(같은 정보의 셋째 사본), 바뀐 모듈만 돌리기
(결정 30과 충돌). 판독기를 남기고 고치기는 6라운드 13건이 반증했다.
위험: PR이 어댑터 컨테이너 lane과 Redis standalone lane을 더는 막지
않는다(main·nightly에서 빨갛게 된다. 소유자 결정 ②). main push는 ci를
다시 돌리지 않는다. 성능 lane은 매 push가 아니라 nightly에서만 돈다.
`.github/workflows/messaging-certification.yml`은 메시징 분리 작업이
지우므로 남겼다(.gitea가 있으면 Gitea가 읽지 않는다). 서명·push는 secret이
없어 실제 태그로는 돌려 보지 않았다.
BREAKING CHANGE: workflow 파일 위치와 이름, strictLaneStages 문법,
릴리스 레지스트리·서명 방식이 바뀌었다. docs/upgrade/2026-11-maturity-
review.md B-57~B-61을 따른다.
release.yml이 태그에서 이미지를 올리고 서명하려면 repo secret
PACKAGE_TOKEN·COSIGN_PRIVATE_KEY·COSIGN_PASSWORD가 필요하다. 이름만
있고 만드는 법이 없어 소유자가 첫 릴리스 전에 찾아야 했다.
operate.md 4.3절에 각 값의 출처(개인 access token의 package 범위,
cosign generate-key-pair의 cosign.key와 비밀번호)와 공개 키를 어디에
주는지 적는다.
검증: python3 scripts/check-docs.py, check-work-docs.py 통과.
메시징 플랫폼 분리(PR #8)를 받는다. 충돌 둘: 옛 integration-main.yml은
이 브랜치가 지웠으므로 삭제를 둔다(메시징 측정 주석은 main.yml에 옮길
측정 수치가 없어 버린다). 업그레이드 안내는 메시징 절을 3.9(B-57~B-59)로
두고 CI 절을 3.10(B-60~B-66)으로 미룬다.
하네스 설계(design-docs harness/01-harness-design.md)는 검증 진입점
scripts/verify.sh와 비전 문서 docs/vision.md가 함께 생긴다고 했다.
verify.sh는 이 브랜치가 만들었는데 비전과 문제 정의 자리가 없었다.
claude-harness template/docs의 두 양식을 옮긴다. vision.md는 세 문장
자리만 두고 소유자가 쓴다(에이전트는 읽기만 한다). problem-statement.md는
고객의 말 그대로·지금 버티는 법·하지 않는 것·잴 수 있는 성공 기준 칸을
둔다. AGENTS.md 첫 문단과 docs/README.md 「폴더 밖 문서」가 두 파일을
가리킨다.
검증: python3 scripts/check-docs.py, check-work-docs.py 통과.
websocketNginxTest의 Nginx 컨테이너는 host.docker.internal을
host-gateway(Docker 호스트)로 풀어 시험 JVM의 앱에 붙었다. desktop에서는
Docker 호스트가 곧 JVM의 호스트라 됐지만, Gitea runner처럼 job이 자기
컨테이너 안에서 돌면 앱은 거기 없다. release 수동 실행(run 51)의
websocket-stable-release-gate가 upgrade마다 DeploymentException으로
실패했다.
Testcontainers의 호스트 포트 노출(exposeHostPorts, withAccessToHost)로
host.testcontainers.internal을 이 JVM으로 잇는다. 두 환경에서 같은
이름이다. 버린 것: runner 설정을 host 네트워크로 바꾸기(platform-core 몫,
job 격리를 푼다).
위험: Testcontainers가 sshd 보조 컨테이너를 하나 더 띄운다(이미지는
Testcontainers가 고정한 것, container-images.properties 밖).
검증: desktop에서 :adapter:inbound:websocket:websocketNginxTest.
redis-topology.sh는 job 컨테이너의 기본 게이트웨이(=Docker 데몬 호스트)를
/proc/net/route에서 awk로 읽었다. awk는 "0x.." 문자열을 0으로 읽어 주소가
0.0.0.0이 됐고, 포워더가 자기 자신에게 이어 붙어 "Too many open files"로
main.yml 수동 실행(run 52)의 redis-topology 11행이 모두 실패했다.
python3로 little-endian 16진수를 바르게 바꾸고, 주소가 없거나 0.0.0.0이면
그 자리에서 실패한다.
검증: 노트북에서 같은 계산이 기본 게이트웨이를 낸다. runner 재실행은
다음 main.yml 수동 실행에서.
t2a-backend-ci의 착수 예측(p30·p50·p80)과 실측(작업 중 132분, 호출 374,
출력 37.5만, 벽시계 849분)을 더한다. 하네스 회고(claude-harness
docs/retro/2026-11-08.md 7절)가 정한 retro 줄 셋(h3·x2·x3)을 ledger.py
append로 더한다. 이미 있던 줄은 고치지 않았다.
b0bca2a6이 단 주석 한 줄이 100칸을 넘어 spotlessJavaCheck가 PR #7의
pr.yml(run 61)을 막았다. 같은 뜻으로 줄을 다시 나눈다.
검증: desktop :adapter:inbound:websocket:spotlessJavaCheck와 check 통과.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
workflow 15개가 모듈 모양으로 나뉘어 같은 Gradle 태스크를 여러 번 돌렸고, 그것을 읽는 판독기(셸·YAML 해석, 운영 3,283줄)가 리뷰 라운드마다 결함을 냈다. 그런데 Gitea Actions가 꺼져 있어 workflow는 한 번도 돈 적이 없다(design-docs
repo-structure/03-ci.md2.1·3.4절).소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧, 2026-11-07)대로 바꾼다.
de070e16): 다른 단계가 이미 돌리는 job을 지운다. fileserver-pr 다섯, fileserver-nightly 재실행 셋, jpa-nightly lane 셋, notificationpr, object storage MinIO 둘, link-check는 main으로.d46bab96):.gitea/workflows/{pr,main,release}.yml셋으로 접는다. 무엇을 돌릴지는 Gradle 단계 태스크가 정한다(새 집계prCheck). 필수 검사는pr / done하나다.verifyStrictLaneStages는 그래프 검사와 고정 문자열 형식 검사만 한다. 판독기를 지운다. 검증 진입점scripts/verify.sh <단계>를 더한다.61b1d575), 알림 문서·ADR을 test 입력으로(b9866407),docs/ci-cd/template-vs-consumer.md표 갱신, 릴리스 secret 만드는 법(a2dfefb6), 비전·문제 정의 빈 양식(d0c3f91a).b0bca2a6,9c202b7b), Redis topology 포워더의 주소 계산(74b0599f).78cbc865).ci-quality-gates.yml,docs-check.yml,build-logic.yml(PR 부분)pr.ymlgradle:./gradlew :prCheck(ci + 잠금 + compose 렌더링 + 배치 + 문서 검사)integration-main.ymlmain.ymlmain·integration·configuration-cache·http3-experimental·compose-smoke(nightly)·performance(nightly, 마지막)pr-adapters.ymlmainCheck·integrationCheck안(지움). 행렬은main.ymlnightlyjpa-postgresql·httpclient-transportbuild-logic.ymlmain.ymlbuild-logic(소유자 결정 ⑦)link-check.ymlmain.ymllinksdependency-vulnerability.ymlpr.yml·main.ymlvulnerabilities(scripts/ci/trivy-scan.sh). GitHub 전용 job 둘은 지움jpa-nightly.yml,jpa-next.yml,redis-sdk-topology.yml,fileserver-nightly.yml(NFS),notification-platform.yml(chaos),object-storage-qualification.yml(AWS)main.ymlnightly jobfileserver-pr.ymlci안의test). 지원 매트릭스 증거를 테스트 클래스로release.ymlrelease.yml(Gitea 레지스트리, cosign 키 쌍, 수동 실행은 push 앞까지)고른 방법과 버린 대안
./gradlew <단계>한 줄 + 형식 검사(설계 7절 B).if:로 단계 나누기(파일만 보고 단계를 모른다), 레지스트리에서 생성(셋째 사본), 바뀐 모듈만 돌리기(결정 30과 충돌), 판독기 유지(6라운드 결함 13건).--dry-run으로 읽어야 해서prCheck에 넣을 수 없다. 그래서 pr job은 두 줄이고, 형식 검사가 둘째 줄의 존재도 요구한다.jpa-next는 지우지 않고 nightly job으로 옮겼다. Experimental PostgreSQL 19 주장의 근거 lane이라JpaReleaseRenderingTest가 요구한다.needs: jpa-release-gate(같은 실행의 행렬 전부)다. Gitea에서 artifact를 쓰지 않으려는 것이다.127.0.0.1을, TLS 인증서가localhost를 전제한다. dind runner의 job 컨테이너에서는scripts/ci/forward-ports.py로 포트를 넘긴다.위험과 영향
ci를 다시 돌리지 않는다. 보호 규칙 「오래된 브랜치 병합 막기」를 권한다.strictLaneStages문법, workflow 위치, 릴리스 레지스트리·서명이 바뀌었다. 파생 서비스 안내는docs/upgrade/2026-11-maturity-review.md3.10절 B-60~B-66.검증
Gitea runner(desktop-runner, dind, 동시 1개):
d46bab964d778c22(main merge)pr / done (pull_request)76e50220DeliberateFailureTest > failsOnPurpose() FAILED→pr / done빨강78cbc8659c202b7b로 고침9c202b7b(최종)4d778c22→78cbc865app-image-release는 Trivy 이미지 검사에서 실패: 기본 이미지(ubuntu 22.04) OS 취약점 HIGH 7, 라이선스 HIGH 3704d778c2278cbc865desktop(merge 트리
232d25e5, 기준1272a5e4,scripts/verify.sh <단계> --on here --no-cache, 로그~/t2a-backend-ci-logs/final/)::prCheck526 태스크 실행, FROM-CACHE 0, 테스트 6,721 실패 0·건너뜀 28,verifyStrictLaneStages통과:releaseCheck:performanceCheck:adapter:inbound:websocket:websocketNginxTest(수정 트리)StrictLaneStagesFunctionalTest27)spring70CompatibilityTest연결 시간 초과 1건으로 실패했다(부하 18~24, runner job과 겹침). merge 트리 재실행은 통과했다.--dry-run해 이벤트별 태스크 집합을 만들었다. 지우거나 옮긴 job 27개의 태스크는 모두 단계 집계(:ci·:mainCheck·:integrationCheck·:performanceCheck·:releaseCheck) 계획 안에 있다(밖 0). PR에서 빠진 29개는 어댑터 컨테이너 lane 26(②)과 Redis standalone 3, main push에서 빠진 733개는ci672(PR이 돈다)와performanceCheck61(③). 로그 desktop~/t2a-backend-ci-logs/wave1-base/.StrictLaneStagesFunctionalTest27개 통과(build-logic 시험 123개 실패 0).NotificationReleaseGateTest)은:adapter:outbound:notification:test→ci→prCheck계획 안이다.arch-reviewer(구조 리뷰): HARD-STOP 위반 0. 형식 검사 우회 입력 9건과 잔재 2건을 지적했고 모두 고쳐 시험으로 남겼다.남은 문제
scripts/ci/trivy-scan.sh image가 기본 이미지(ubuntu 22.04)의 OS 취약점 HIGH 7건과 OS 패키지 라이선스 HIGH 370건으로 막는다. 옛 release.yml과 같은 명령이고, CI가 처음 돌면서 드러났다. 기본 이미지 갱신과 「OS 패키지 라이선스를 막을지」는 소유자 결정이다.done은 앞 job이 끝난 뒤에야 대기열에 들어가 먼저 올라간 main·release job 뒤로 밀린다. runner를 하나 더 두거나 PR 단계를 한 job으로 합치는 안을 정해야 한다.test에서 읽는 시험 넷(NotificationReleaseGateTest등). 이번 diff는 입력 선언만 보강했다.리뷰어가 볼 곳
src/build-logic/src/main/java/dev/caskeleton/buildlogic/strictlane/StrictLaneStagesPlugin.java의formProblems와src/build.gradle의strictLaneStages..gitea/workflows/*.yml셋.scripts/verify.sh(원격 실행: 패치 → 새 worktree → 트리 해시 비교 → 잠금 → 테스트 수 → 정리).관련 문서
repo-structure/03-ci.md7절,repo-structure/README.md3.3절,harness/01-harness-design.md6절.docs/work/reference/gates.md(새 1·3절),docs/work/operate.md4.1절.