ci(release): needs 대기 원인과 공개 경로·mainCheck 설명을 지금 동작에 맞춘다 #29

Merged
donghyeon.kang merged 6 commits from claude/w2-be-ci-perf-4 into main 2026-11-13 01:52:39 +00:00
Owner

무엇을, 왜

세 가지를 고친다. 모두 주석과 문서이고 동작은 바뀌지 않는다.

  1. release의 이미지·서명 job이 몇 시간씩 queued인 이유를 workflow에 적는다(5feb0698).
    • 수동 release run 157에서 app-image-release는 gate가 끝나고 3.0시간 뒤에 시작했다. app-image-signing은 이미지 job이 끝나고 2.0시간 뒤에 시작했다.
    • runner label(ubuntu-latest)은 다른 job과 같고 environment도 없다. 원인은 needs다.
    • Gitea는 runner에 실행할 수 있게 된 지 가장 오래된 job을 준다. 이 runner를 쓰는 모든 repo의 job이 대상이다.
    • needs가 있는 job은 앞 job이 끝나야 실행할 수 있게 된다. 그래서 그 시각 전에 만들어진 모든 job 뒤에 선다. 같은 runner를 쓰는 프론트 repo의 job도 포함한다.
    • main.yml performance 주석의 「만든 순서」도 「실행할 수 있게 된 순서」로 바로잡는다.
  2. 공개 경로 스냅숏 검사의 설명을 넓어진 범위에 맞춘다(3b71a3ca).
    • 스냅숏은 이제 기본값, profile 덮어쓰기, 운영 코드 filter chain의 permitAll·securityMatcher 문장을 고정한다.
    • 그런데 설명 세 곳은 아직 「기본 공개 경로」라고 적는다: gates.md, 루트 verifyPublicPathSnapshot, app-bootstrap publicPathSnapshotTest.
  3. round9 확인 리뷰가 넘긴 Low 셋(66a7190a, d3084340).
    • 루트 build.gradle Lifecycle 주석과 gates.md mainCheck 행에 graphqlStableTest가 빠져 있었다.
    • build.gradle bootstrap 주석이 「migrate-and-start」라고 적었다. 기본 조립은 web뿐이라 startup Flyway가 돌지 않는다.
    • build-logic/AGENTS.md는 저장소 루트를 「두 레인에만 준다」고 적었다. 실제로는 태그 두 개의 레인에, 그 leaf의 build.gradle이 준다.

근거(run 157과 같은 시간대, 두 repo의 job 시각, UTC):

job 실행할 수 있게 된 시각 먼저 돈 job 뒤에 돈 job
app-image-release 17:50:01(마지막 gate 끝) 17:0317:47에 만들어진 프론트 run 169172 17:51:28에 만들어진 프론트 173
app-image-signing 21:01:52(이미지 job 끝) 18:47~19:28에 만들어진 프론트 173·178·180·192, 18:58에 만들어진 백엔드 183 22:30:44에 만들어진 백엔드 218

고른 방법과 버린 대안

결정 고른 것 버린 것과 이유
release 대기 비용과 측정값을 주석에 적고, 태그는 대기 중인 run이 없을 때 자르라고 적는다 needs 빼고 파일 순서에 맡기기: gate가 실패해도 이미지가 publish될 수 있다. 서명을 이미지 job에 합치기: 서명 키가 빌드하는 job에 들어간다. runner 늘리기: 이번 프로그램 범위 밖
공개 경로 설명 세 곳 모두 지금 범위로 정본 하나만 고치기: 나머지 둘이 계속 좁게 말한다

위험과 영향

  • 대기는 고치지 않았다. runner가 바쁠 때 태그 release의 벽시계 시간이 몇 시간 늘 수 있다. 대기는 job 시간 합에 들어가지 않으므로, 목표 「release ≤ 35분」에는 영향이 없다.
  • 없애려면 위 대안 중 하나를 골라야 한다. 둘 다 gate 보장이나 서명 키 분리를 약하게 하므로 소유자가 정할 일이다.
  • 나머지는 주석·문서·태스크 description이다.

검증

명령 커밋 rc 비고
desktop scripts/verify.sh pr --no-cache 5feb0698(트리 bebce6f3, 시작 부하 14.4) 0 :prCheck 7분 11초, 528 태스크 전부 실행, FROM-CACHE 0. 시험 6,805개, 실패 0. 로그 desktop ~/claude-w2-be-ci-perf-4-logs/pr.log
scripts/verify.sh docs(노트북) 5feb0698 0
  • 바꾼 문구를 고정하는 시험은 없다(git grep 0건).
  • release.yml을 읽는 시험은 DeveloperExperienceContractTest와 JpaReleaseRenderingTest다. 주석 문구는 보지 않는다. 주석에 JPA gate 태스크 이름은 넣지 않았다.

리뷰어가 볼 곳

  • .gitea/workflows/release.yml app-image-release 위 주석: 시각과 판단이 위 표와 맞는지.
  • docs/work/reference/gates.md verifyPublicPathSnapshot 행: docs/security/public-paths-snapshot.txt의 세 절과 맞는지.

관련

  • PR #15·#18(같은 CI 개선 흐름), 공유 노트 w2-be-ci-perf.md
  • round9 확인 리뷰(r9-be가 넘긴 Low, 리뷰 기록 5절 10번)
## 무엇을, 왜 세 가지를 고친다. 모두 주석과 문서이고 동작은 바뀌지 않는다. 1. **release의 이미지·서명 job이 몇 시간씩 queued인 이유를 workflow에 적는다**(5feb0698). - 수동 release run 157에서 `app-image-release`는 gate가 끝나고 3.0시간 뒤에 시작했다. `app-image-signing`은 이미지 job이 끝나고 2.0시간 뒤에 시작했다. - runner label(`ubuntu-latest`)은 다른 job과 같고 environment도 없다. 원인은 `needs`다. - Gitea는 runner에 실행할 수 있게 된 지 가장 오래된 job을 준다. 이 runner를 쓰는 모든 repo의 job이 대상이다. - `needs`가 있는 job은 앞 job이 끝나야 실행할 수 있게 된다. 그래서 그 시각 전에 만들어진 모든 job 뒤에 선다. 같은 runner를 쓰는 프론트 repo의 job도 포함한다. - main.yml `performance` 주석의 「만든 순서」도 「실행할 수 있게 된 순서」로 바로잡는다. 2. **공개 경로 스냅숏 검사의 설명을 넓어진 범위에 맞춘다**(3b71a3ca). - 스냅숏은 이제 기본값, profile 덮어쓰기, 운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장을 고정한다. - 그런데 설명 세 곳은 아직 「기본 공개 경로」라고 적는다: gates.md, 루트 `verifyPublicPathSnapshot`, app-bootstrap `publicPathSnapshotTest`. 3. **round9 확인 리뷰가 넘긴 Low 셋**(66a7190a, d3084340). - 루트 build.gradle Lifecycle 주석과 gates.md `mainCheck` 행에 `graphqlStableTest`가 빠져 있었다. - build.gradle bootstrap 주석이 「migrate-and-start」라고 적었다. 기본 조립은 web뿐이라 startup Flyway가 돌지 않는다. - build-logic/AGENTS.md는 저장소 루트를 「두 레인에만 준다」고 적었다. 실제로는 태그 두 개의 레인에, 그 leaf의 `build.gradle`이 준다. 근거(run 157과 같은 시간대, 두 repo의 job 시각, UTC): | job | 실행할 수 있게 된 시각 | 먼저 돈 job | 뒤에 돈 job | |---|---|---|---| | `app-image-release` | 17:50:01(마지막 gate 끝) | 17:03~17:47에 만들어진 프론트 run 169~172 | 17:51:28에 만들어진 프론트 173 | | `app-image-signing` | 21:01:52(이미지 job 끝) | 18:47~19:28에 만들어진 프론트 173·178·180·192, 18:58에 만들어진 백엔드 183 | 22:30:44에 만들어진 백엔드 218 | ## 고른 방법과 버린 대안 | 결정 | 고른 것 | 버린 것과 이유 | |---|---|---| | release 대기 | 비용과 측정값을 주석에 적고, 태그는 대기 중인 run이 없을 때 자르라고 적는다 | `needs` 빼고 파일 순서에 맡기기: gate가 실패해도 이미지가 publish될 수 있다. 서명을 이미지 job에 합치기: 서명 키가 빌드하는 job에 들어간다. runner 늘리기: 이번 프로그램 범위 밖 | | 공개 경로 설명 | 세 곳 모두 지금 범위로 | 정본 하나만 고치기: 나머지 둘이 계속 좁게 말한다 | ## 위험과 영향 - **대기는 고치지 않았다.** runner가 바쁠 때 태그 release의 벽시계 시간이 몇 시간 늘 수 있다. 대기는 job 시간 합에 들어가지 않으므로, 목표 「release ≤ 35분」에는 영향이 없다. - 없애려면 위 대안 중 하나를 골라야 한다. 둘 다 gate 보장이나 서명 키 분리를 약하게 하므로 소유자가 정할 일이다. - 나머지는 주석·문서·태스크 description이다. ## 검증 | 명령 | 커밋 | rc | 비고 | |---|---|---|---| | desktop `scripts/verify.sh pr --no-cache` | 5feb0698(트리 bebce6f3, 시작 부하 14.4) | 0 | `:prCheck` 7분 11초, 528 태스크 전부 실행, FROM-CACHE 0. 시험 6,805개, 실패 0. 로그 desktop `~/claude-w2-be-ci-perf-4-logs/pr.log` | | `scripts/verify.sh docs`(노트북) | 5feb0698 | 0 | | - 바꾼 문구를 고정하는 시험은 없다(`git grep` 0건). - release.yml을 읽는 시험은 `DeveloperExperienceContractTest`와 `JpaReleaseRenderingTest`다. 주석 문구는 보지 않는다. 주석에 JPA gate 태스크 이름은 넣지 않았다. ## 리뷰어가 볼 곳 - `.gitea/workflows/release.yml` `app-image-release` 위 주석: 시각과 판단이 위 표와 맞는지. - `docs/work/reference/gates.md` `verifyPublicPathSnapshot` 행: `docs/security/public-paths-snapshot.txt`의 세 절과 맞는지. ## 관련 - PR #15·#18(같은 CI 개선 흐름), 공유 노트 `w2-be-ci-perf.md` - round9 확인 리뷰(r9-be가 넘긴 Low, 리뷰 기록 5절 10번)
donghyeon.kang added 5 commits 2026-11-13 00:36:30 +00:00
`mainCheck`는 `:adapter:inbound:graphql:graphqlStableTest`에 기댄다
(build.gradle `mainCheck` 태스크). 그런데 루트 build.gradle Lifecycle 주석과
gates.md 1절 `mainCheck` 행에는 이 lane이 없다. docs/build.md 표는 gates.md
1절을 정본으로 가리키므로 정본이 빠진 셈이다.

build.gradle의 bootstrap 주석은 단계를 「migrate-and-start」로 적는다. 기본
조립은 web뿐이고 persistence-jpa 줄이 꺼져 있어 startup Flyway가 돌지 않는다.
「start」로 고치고, Flyway는 persistence-jpa 줄을 켰을 때만 돈다고 적는다.

동작 변경 없음: build.gradle은 주석만 바꿨다.

검증: scripts/verify.sh docs(노트북) rc=0.

Refs: round9 확인 리뷰(r9-be 그룹 C가 넘긴 Low 둘)
build-logic/AGENTS.md는 「저장소 루트(`ca.repository.root`)는 이 두
레인에만 준다」고 적는다. 실제로 루트를 주는 것은 build-logic convention이
아니라 leaf `build.gradle`의 레인 선언(`systemProperty`)이다. 지금은
app-bootstrap의 `documentContractTest`·`repositoryContractTest` 둘이지만,
다른 leaf의 document-contract 레인도 같은 방식으로 받을 수 있다. 그러면
「두 레인」은 틀린 말이 된다.

태그 두 개로 범위를 적고, 주는 쪽이 그 leaf의 `build.gradle`이라고 적는다.

검증: scripts/verify.sh docs(노트북) rc=0. 이 문장을 읽는 시험은 없다
(git grep 'build-logic/AGENTS.md' -- '*.java': 0건).

Refs: round9 리뷰 기록 5절 10번(r9-be 그룹 C)
공개 경로 스냅숏은 이제 기본 공개 경로만이 아니라 profile 덮어쓰기와
운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장까지 고정한다
(`docs/security/public-paths-snapshot.txt`). 그런데 그 검사를 설명하는 세
곳은 아직 「기본 공개 경로」만 본다고 적는다.

- gates.md 2절 `verifyPublicPathSnapshot` 행
- 루트 build.gradle `verifyPublicPathSnapshot` 태스크 description
- app-bootstrap build.gradle `publicPathSnapshotTest` 레인 description

세 곳 모두 지금 범위(기본값, profile 덮어쓰기, filter chain 문장)로 고친다.
동작 변경 없음.

검증: scripts/verify.sh docs(노트북) rc=0. 이 문구를 고정하는 시험은 없다
(git grep 'shipped public path default' -- '*.java': 0건).

Refs: round9 확인 리뷰(r9-be가 넘긴 Low, 공개 경로 범위 확장 뒤)
수동 release run 157에서 `app-image-release`는 gate가 끝나고 3시간 뒤에,
`app-image-signing`은 이미지 job이 끝나고 2시간 뒤에 시작했다. runner
label(`ubuntu-latest`)은 다른 job과 같고 environment도 없다. 원인은
`needs`다. Gitea는 runner에 실행할 수 있게 된 지 가장 오래된 job을 준다.
그 runner가 받는 모든 repo가 대상이다. `needs`가 없는 job은 run을 만들 때부터
실행할 수 있다. `needs`가 있는 job은 앞 job이 끝나야 실행할 수 있다. 그래서
그 시각 전에 만들어진 모든 job 뒤에 선다.

같은 시간대 두 repo의 job 시각이 이 순서와 맞는다.
- 이미지 job(17:50 실행 가능): 17:47에 만들어진 프론트 run까지 먼저 돌았다.
  17:51에 만들어진 run보다는 앞이었다.
- 서명 job(21:01 실행 가능): 19:28에 만들어진 run까지 먼저 돌았다. 22:30에
  만들어진 run보다는 앞이었다.

release.yml에 그 비용과 측정값을 적고, 태그는 대기 중인 run이 없을 때
자르라고 적는다. main.yml `performance` 주석의 「만든 순서」도 「실행할 수
있게 된 순서」로 고친다. `needs`가 없는 job에서는 둘이 같다.

고르지 않은 안:
- `needs`를 빼고 파일 순서에 맡긴다. gate가 실패해도 이미지가 publish될 수
  있다.
- 서명을 이미지 job에 합친다. 서명 키가 빌드하는 job에 들어간다.
- runner를 늘린다. 이번 프로그램의 범위 밖이다.
대기는 runner가 바쁠 때만 생기고, release 비용(job 시간 합)에는 들어가지
않는다.

동작 변경 없음: 주석만 바꿨다.

검증: scripts/verify.sh docs(노트북) rc=0. release.yml을 읽는 시험
(DeveloperExperienceContractTest, JpaReleaseRenderingTest)은 주석 문구를
보지 않고, 넣은 주석에는 JPA gate 태스크 이름이 없다.
donghyeon.kang added 1 commit 2026-11-13 01:31:21 +00:00
main push run 221(3d31896a)의 main job이 gRPC 시험 하나로 빨갛다.
`GrpcP1BoundaryWireTest`의 「deadline 없이 부른 느린 호출은 서버 기본
deadline에서 DEADLINE_EXCEEDED로 끝난다」다. job 로그에는
「AssertionFailedError at GrpcP1BoundaryWireTest.java:276」 한 줄뿐이라
어떤 status가 왔는지 알 수 없다.
- Gradle 기본 exceptionFormat(SHORT)은 예외 타입과 줄만 찍는다.
- Gitea runner는 job이 끝나면 시험 보고서를 남기지 않는다.
- desktop에서 같은 lane을 1코어에 고정해 15번 돌렸지만 모두 통과했다.
그래서 원인을 가릴 증거가 없다.

고친 것:
- java 규약(`ca.java-library`가 적용하는 JavaConventionsPlugin)의 모든 Test
  태스크가 실패를 FULL 형식으로 찍는다. 메시지와 원인 사슬이 job 로그에
  남는다. strict lane도 Test 태스크라 같이 적용된다.
- 그 시험의 status 단언에 받은 예외를 설명으로 붙인다(`as("status of %s")`).
  다음에 실패하면 어느 경로였는지 바로 보인다. 다른 status가 왔는지, 5초
  대기가 끝났는지(UNKNOWN), 다른 예외였는지다.

원인을 고친 커밋이 아니다. 재시도로 덮지 않았고, 시간 상한도 바꾸지 않았다.
코드로 확인한 범위는 이렇다. 응답이 성공으로 왔다면 단언 전에
`Status.fromThrowable(null)`이 NPE를 냈어야 한다. 그러니 실패는
DEADLINE_EXCEEDED가 아닌 status이거나 5초 대기 초과다.

위험: 실패가 많은 실행에서는 로그가 길어진다. 기본 stack trace 필터
(TRUNCATE)가 시험 진입점 아래를 자른다.

검증: desktop `./gradlew -p build-logic test`(새 시험
everyTestTaskLogsAFailureWithItsMessageAndCauses 포함)와 grpc lane, `verify.sh pr`
(PR 본문에 적는다).
donghyeon.kang merged commit 3ac824ae60 into main 2026-11-13 01:52:39 +00:00
donghyeon.kang deleted branch claude/w2-be-ci-perf-4 2026-11-13 01:52:39 +00:00
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#29