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
6 Commits
Author SHA1 Message Date
DongHyeonka 46c9ab81f5 build(test): 실패한 시험이 job 로그에 메시지와 원인을 남긴다
pr / done (pull_request) Successful in 13m29s
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 본문에 적는다).
2026-11-13 10:31:18 +09:00
DongHyeonka 5feb06982d ci(release): needs가 있는 job이 runner 대기열 뒤로 가는 비용을 적는다
pr / done (pull_request) Canceled after 0s
수동 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 태스크 이름이 없다.
2026-11-13 08:32:49 +09:00
DongHyeonka 3b71a3ca32 docs(security): 공개 경로 스냅숏 검사의 설명을 넓어진 범위에 맞춘다
공개 경로 스냅숏은 이제 기본 공개 경로만이 아니라 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, 공개 경로 범위 확장 뒤)
2026-11-13 08:32:49 +09:00
DongHyeonka b671054653 merge: main(3d31896a, round9 묶음 #28)을 받는다 2026-11-13 08:31:11 +09:00
DongHyeonka d30843407f docs(build-logic): 저장소 루트를 누가 어느 레인에 주는지 바로 적는다
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)
2026-11-13 06:37:43 +09:00
DongHyeonka 66a7190a83 docs(build): mainCheck·bootstrap 설명을 지금 태스크와 기본 조립에 맞춘다
`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 둘)
2026-11-13 05:05:46 +09:00