WIP: pr / done이 빨강인지 보는 버리는 PR(병합 금지) #9

Closed
donghyeon.kang wants to merge 3 commits from claude/t2a-red-check into main
Owner

PR #7의 검증용이다. DeliberateFailureTest가 일부러 실패한다. 필수 검사 pr / done이 빨강인 것을 보고 닫고 브랜치를 지운다. 병합하지 않는다.

PR #7의 검증용이다. `DeliberateFailureTest`가 일부러 실패한다. 필수 검사 `pr / done`이 빨강인 것을 보고 닫고 브랜치를 지운다. 병합하지 않는다.
donghyeon.kang added 5 commits 2026-11-08 12:58:34 +00:00
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 단계.
ci!: workflow를 pr·main·release 셋으로 접고 단계 job 모양만 검사한다
pr / gradle (pull_request) Successful in 16m42s
pr / vulnerabilities (pull_request) Successful in 37s
pr / done (pull_request) Canceled after 0s
d46bab9659
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을 따른다.
test: 일부러 실패하는 시험으로 pr / done이 빨강인지 본다(버리는 PR)
pr / vulnerabilities (pull_request) Canceled after 0s
pr / done (pull_request) Canceled after 0s
pr / gradle (pull_request) Canceled after 9m25s
9fa1051eac
donghyeon.kang added 3 commits 2026-11-08 13:27:41 +00:00
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 통과.
Merge remote-tracking branch 'origin/main' into claude/t2a-backend-ci-451e3b
pr / gradle (pull_request) Successful in 12m38s
pr / vulnerabilities (pull_request) Successful in 36s
pr / done (pull_request) Successful in 0s
4d778c2293
메시징 플랫폼 분리(PR #8)를 받는다. 충돌 둘: 옛 integration-main.yml은
이 브랜치가 지웠으므로 삭제를 둔다(메시징 측정 주석은 main.yml에 옮길
측정 수치가 없어 버린다). 업그레이드 안내는 메시징 절을 3.9(B-57~B-59)로
두고 CI 절을 3.10(B-60~B-66)으로 미룬다.
test: PR #7 새 head(4d778c22) 위에서 일부러 실패하는 시험을 다시 돌린다(버리는 PR)
pr / gradle (pull_request) Failing after 9m36s
pr / vulnerabilities (pull_request) Successful in 31s
pr / done (pull_request) Canceled after 0s
fc59a021b7
donghyeon.kang added 1 commit 2026-11-08 13:53:33 +00:00
test: 일부러 실패하는 시험의 형식을 맞춰 단언에서 실패하게 한다(버리는 PR)
pr / gradle (pull_request) Failing after 9m4s
pr / vulnerabilities (pull_request) Successful in 32s
pr / done (pull_request) Failing after 1s
76e5022069
donghyeon.kang closed this pull request 2026-11-09 01:53:59 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
This pull request is marked as a work in progress.
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#9