문제:
- 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
adapter:outbound:messaging-kafka — Kafka 발행 capability
- Module ID:
adapter-outbound-messaging-kafka - Gradle path:
:adapter:outbound:messaging-kafka - Package:
dev.caskeleton.adapter.outbound.messaging.kafka(테스트만 있다) - 테스트:
./gradlew :adapter:outbound:messaging-kafka:test --console=plain
제공하는 것
이 모듈 하나를 붙이면 Kafka 발행이 들어온다. 유스케이스는 application-core 포트만 호출한다. 이 leaf에는 코드가 없다. 선택 한 줄과 설정 기본값을 묶는 capability 단위다.
adapter:outbound:messaging-kafka
├─ config/module-defaults/messaging.yml (설정 기본값, support 로더가 읽음)
├─ adapter:outbound:messaging OutboxMessagePublishPort,
│ IntegrationEventPublishPort bridge
└─ dev.cakit.messaging:messaging-spring-boot-starter-kafka 메시징 라이브러리 + Kafka transport
(별도 repo messaging-library, 카탈로그 messagingLibrary)
| 포트 (application-core) | 구현 |
|---|---|
OutboxMessagePublishPort |
claim된 row의 validated event → IntegrationEventPublishPort |
IntegrationEventPublishPort |
platform EncodedMessagePublisher |
OutboxRelayFailureReportPort |
구조화 로그 |
- 켜기와 끄기: 모듈이 있으면 켜진다.
APP_MESSAGING_ENABLED=false로만 끈다. 끄면 messaging bean, Kafka producer, 스레드가 하나도 생기지 않는다. - 설정:
config/module-defaults/messaging.yml을 support의ModuleDefaultsEnvironmentPostProcessor가 읽는다. 우선순위가 가장 낮아서application*.yml, 환경 변수, 시스템 속성이 항상 이긴다. app-bootstrap은 이 파일을 모른다. - broker 주소는
APP_MESSAGING_KAFKA_BROKERS하나(app.messaging.brokers.kafka.bootstrap-servers).spring.kafka.bootstrap-servers는 읽지 않는다. 논리 broker 이름은kafka하나다. Kafka 연결의 TLS·SASL은 메시징 라이브러리의 broker profile이 소유한다(그 repo의 configuration-reference.md). - 발행 경로는 하나다. 옛
KafkaSenderseam(TLS/SASL 없는 R0 producer)은 outbox를 canonical로 통일하면서 삭제했다(2026-09-28). - 발행할 event의 contract마다 destination을 선언해야 한다(
app.messaging.destinations.<logical destination>). 템플릿의 durable operation event는durable-operations로 간다.
추가할 한 줄
// src/bootstrap/app/build.gradle
runtimeOnly project(':adapter:outbound:messaging-kafka') // Kafka 발행
이 줄을 지우면 발행 포트 구현, Kafka client, 메시징 라이브러리, 설정 기본값이 모두 함께 빠진다.
필요한 env 키
전체 목록과 타입은 docs/registries/env-keys.yaml의 APP_MESSAGING_* 행이 SSOT다.
| 언제 | 키 |
|---|---|
| 항상 | APP_MESSAGING_KAFKA_BROKERS (CSV host:port). 비어 있으면 기동이 실패한다 |
| 항상 | APP_MESSAGING_PRODUCER_ID (배포와 무관한 논리적 서비스 이름). 비어 있으면 기동이 실패한다 — 모든 발행이 canonical bridge를 지난다 |
| 끌 때 | APP_MESSAGING_ENABLED=false |
APP_MESSAGING_BROKER는 메시징 라이브러리가 쓸 broker 선택값이고 기본값이 kafka다. 등록된 broker가 Kafka
하나라 바꿀 일이 없다. destination·broker profile·보안 설정은 messaging-library repo의
configuration-reference.md다.
실제 broker로 도는 앱 발행 경로 lane (messagingKafkaRelayIntegrationTest)
앱이 실제로 쓰는 발행 경로 — composition:outbox-relay relay → OutboxMessagePublishAdapter →
platform bridge → DefaultMessagePublisher → Kafka — 를 Testcontainers Kafka(apache/kafka:4.1.0,
-PmessagingKafkaImage=로 교체)로 끝까지 돌린다(리뷰 2026-11-01 06-09). 메시징 라이브러리 쪽 broker lane
(그 repo의 인증 lane)은 라이브러리 자기 relay와 publisher 직접 호출만 검증하므로 앱 경로의 증거가 아니다.
- 정상 발행: append한 row를 relay가 보내고, 테스트가 topic에서 읽은 레코드 값이 envelope 바이트와 같고 key가 partition key와 같다.
- broker 정지(컨테이너 pause) 중 claim된 row는 DEAD가 아니라 FAILED로 남고, broker가 돌아오면 운영자 개입 없이 PUBLISHED가 된다.
- outbox store는 port 소유자의 in-memory fake다. claim SQL·FIFO gate는 persistence-jpa의 PostgreSQL lane이 따로 검증한다.
- strict lane(
integration())이라:integrationCheck에 들어가고 skip을 거부한다.
./gradlew :adapter:outbound:messaging-kafka:messagingKafkaRelayIntegrationTest --console=plain