문제:
- ca.spring-library가 모든 spring leaf(30)의 testImplementation에
spring-boot-starter-webmvc-test를 넣어, MockMvc를 쓰지 않는 23 leaf가 Tomcat을
시험 classpath에 resolve하고 lock했다.
- container-images.properties 머리말은 「digest로 고정」이라는데 postgres-17·18이
tag만이었다. 머리말은 「쓰는 lane만 다시 돈다」고 했지만 파일 전체가 모든 Test
task의 입력이라 이미지 하나만 바꿔도 모든 lane이 다시 돈다. postgres-16-4는
아무도 읽지 않았다.
- libs.versions.toml에 아무도 읽지 않는 칸이 있었다(라이브러리 9, 버전 4,
루트에 적용하지 않는 플러그인 4).
- config/spotbugs/exclude.xml에 없는 클래스의 항목이 있었다(exclude-test.xml에
이미 있다).
- notification의 API surface가 상대 경로로 application-notification 소스를
가리켰고, ApiSurface 플러그인은 없는 추가 root를 말없이 건너뛰어 승인 update가
줄어든 표면을 기록할 수 있었다.
- verify-mongodb-platform.sh가 고르는 클래스가 없는 :app-bootstrap:test
--tests '*CleanArchitectureTest'를 불러 늘 실패했고, 이미지 기록이 카탈로그와
다른 tag였다.
고친 것:
- 규약은 spring-boot-starter-test만 준다. 시험이 실제로 쓰는 것을 leaf가 직접
선언한다. MockMvc를 쓰는 web·web-advanced·web-fileserver·web-notification·
app-bootstrap은 webmvc-test starter, graphql은 TestRestTemplate의
spring-boot-resttestclient, durable-operation은 WebApplicationContextRunner의
spring-web, 시험이 JSON을 읽는 objectstorage·persistence-jpa·persistence-mongo·
notification-platform은 jackson-databind, redis-runtime은 jackson-annotations
(compileOnly, 본 코드와 같은 이유)다. 모든 Java source set을 한 빌드에서 컴파일해
빠진 곳이 없음을 확인하고 lockfile을 다시 만들었다(Tomcat·webmvc 시험 자동설정이
빠짐). graphql·persistence-mongo AGENTS의 허용·시험 목록을 같이 고쳤다.
- postgres 17·18을 desktop runner에서 받은 digest로 고정했다(17.11, 18.6). 목록을
읽을 때 digest 없는 값을 GradleException으로 거절한다(ContainerImageCatalogTest).
머리말을 실제 캐시 동작으로 고쳤고 postgres-16-4를 지웠다. persistence-jpa
release registry의 PostgreSQL tag는 아무도 읽지 않아 지우고, 이미지는 카탈로그가
정한다고 적었다.
- 카탈로그의 미사용 칸을 지우고 머리말을 지금 쓰임에 맞췄다.
- 죽은 spotbugs 항목을 지웠다.
- notification은 project(':application-notification')로 root를 잡고, 없는 추가
root는 설정 단계에서 실패한다(ApiSurfaceConventionTest).
- mongo 스크립트는 :app-bootstrap:architectureTest를 부르고, 이미지 기록은
카탈로그 mongo-8 값을 읽는다.
- graphql build.gradle에 앞 커밋의 document-contract lane을 함께 둔다. 저장소 루트
(ca.repository.root)와 읽는 registry 파일은 그 lane만 받고, 시험은 그 속성으로만
루트를 읽는다(cwd에서 거슬러 찾지 않는다).
버린 대안: 이미지마다 쓰는 lane을 선언해 입력을 나누기 — lane 수십 개에 키
목록을 다시 적어야 하고 빠뜨리면 캐시가 거짓 통과한다.
검증: 아래 PR 본문(desktop resolveAndLockAll·build-logic test·모든 source set 컴파일·
leaf check).
BREAKING CHANGE: ca.spring-library가 시험 classpath에 spring-boot-starter-webmvc-test를
넣지 않는다. MockMvc·TestRestTemplate·Jackson을 그 starter로 받던 파생 leaf는 의존을
직접 선언해야 시험이 컴파일된다. 카탈로그의 digest 없는 이미지와 없는 API surface 추가
root는 설정 단계에서 실패한다. version catalog의 미사용 칸을 지웠다. 할 일은
docs/upgrade/2026-11-round9-build.md다.
Refs: RR9-04-06, RR9-04-11, RR9-04-12, RR9-04-13, RR9-04-14, RR9-04-15, RR9-04-16
3.2 KiB
3.2 KiB
업그레이드 안내 — 2026-11 시험 classpath·이미지 카탈로그·빌드 정리
- 범위:
ca.spring-library규약의 시험 의존, 컨테이너 이미지 카탈로그, version catalog, API surface 플러그인, graphql의 registry 대조 시험 위치. 운영 코드와 HTTP 응답은 그대로다. 빌드와 시험만 바뀐다. - 근거: 2026-11-12 전체 리뷰(
docs/reviews/2026-11-12-round9-review/)의 빌드·시험 발견
1. 누가 읽나
이 템플릿을 upstream remote로 두고 merge해 받는 파생 서비스가 읽는다. 자기 leaf를 더한 서비스가 특히 본다.
2. 할 일
| # | 할 일 | 안 하면 | 해당 서비스 |
|---|---|---|---|
| 1 | 자기 leaf 시험이 쓰는 web 시험 도구를 그 leaf build.gradle에 직접 선언한다. MockMvc(@WebMvcTest, @AutoConfigureMockMvc)는 testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test', TestRestTemplate만이면 spring-boot-resttestclient, WebApplicationContextRunner는 spring-web, 시험이 tools.jackson.databind로 JSON을 읽으면 tools.jackson.core:jackson-databind다. 그다음 ./gradlew resolveAndLockAll --write-locks로 lockfile을 다시 만든다 |
시험 컴파일이 실패한다(cannot find symbol, class file for ... not found). 운영 코드는 영향이 없다 |
ca.spring-library를 쓰는 자기 leaf가 있는 서비스 |
| 2 | gradle/container-images.properties에 더한 이미지를 이름@sha256:<digest>로 고정한다 |
설정 단계에서 GradleException으로 빌드가 멈춘다 |
카탈로그에 이미지를 더한 서비스 |
| 3 | 시험이 ca.test.image.postgres-16-4를 읽었다면 ca.test.image.postgres-16으로 바꾼다. 그 칸은 지웠다 |
속성이 비어 Testcontainers가 이미지를 못 찾는다 | 그 칸을 쓰던 서비스 |
| 4 | version catalog에서 지운 칸을 쓰던 빌드 스크립트는 자기 칸을 둔다. 지운 라이브러리 칸: errorprone-core, findsecbugs-plugin, jackson3-core, jmh-core, jmh-generator-annprocess, junit-platform-launcher, protobuf-java-legacy, spock-core-groovy4, spock-core-groovy5. 지운 플러그인 칸: spring-dependency-management, spotless, spotbugs, errorprone(규약 플러그인이 쓰는 버전은 그대로다) |
빌드 스크립트 컴파일이 실패한다 | 그 alias를 쓰던 서비스 |
| 5 | apiSurface의 추가 source root가 실제로 있는 폴더를 가리키는지 본다. 상대 경로 대신 project(':x').file('src/main/java').path를 쓴다 |
설정 단계에서 실패한다. 전에는 말없이 건너뛰어 줄어든 표면을 승인할 수 있었다 | API surface에 추가 root를 둔 leaf |
| 6 | graphql의 GraphQlDeploymentModeRegistryParityTest는 test가 아니라 main 단계 lane :adapter:inbound:graphql:graphqlDocumentContractTest에서 돈다. 손으로 돌릴 때 그 lane을 부른다 |
test만 돌리면 registry 대조를 보지 않는다 |
graphql을 실은 서비스 |
3. 확인
./gradlew resolveAndLockAll --write-locks뒤git diff --stat -- '*gradle.lockfile'로 시험 classpath에서 빠진 항목을 본다../gradlew <자기 leaf>:check가 시험 컴파일부터 통과하는지 본다.