Files
DongHyeonka c10f4af8b6
pr / ci (pull_request) Successful in 4m18s
fix(build-logic): registry 행의 build 칸을 거절한다
build-logic 사본의 ModuleRegistry는 행마다 `build` 칸을 읽었다(템플릿의
두 번째 빌드용). 이 repo에는 빌드가 하나라, main이 아닌 값(오타 포함)을
적은 모듈은 settings가 include하지 않고 방향 검사도 보지 않는데 ci는
초록으로 남는다. 템플릿 구조 리뷰가 같은 구멍을 템플릿 쪽에서 찾았다.

칸이 있으면 read에서 실패한다. 시험은 칸이 없으면 main, 칸이 있으면
(빈 값 포함) 그 모듈 id와 'build'를 이름 대고 거절함을 본다.
UPSTREAM.md 「고친 것」에 적었다.

검증: 템플릿에서 같은 시험이 고치기 전 실패(RED), 고친 뒤 통과(GREEN)를
desktop에서 봤다. 이 repo에서는 desktop ci(buildLogicTest 포함).
2026-11-08 13:25:14 +09:00

3.8 KiB

build-logic의 출처 — 백엔드 템플릿에서 복사해 줄였다

  • 복사한 곳: clean-architecture-backend-template main 22df3525의 src/build-logic/(2026-11-08)
  • 함께 복사: src/gradle/libs.versions.toml(이 repo가 쓰는 항목만), src/gradle/wrapper/, src/gradlew*, src/config/checkstyle/, src/config/spotbugs/(이 repo 클래스와 일반 규칙만), src/config/testing/container-images.properties(postgres-16만)
  • 근거: design-docs repo-structure/05-library-repos.md 10.3절 L1(복사 후 줄이기). 다시 열 조건: 라이브러리 repo가 셋 이상이 되거나, 6개월 안에 템플릿에서 이 사본으로 옮긴 수정이 3번을 넘으면 공통 빌드 규칙 repo(L3)를 본다.

뺀 것

무엇 이유
ca.bootrun-dotenv, ca.redis-topology-lane, ca.config-contract, ca.spring-library 이 repo 모듈이 쓰지 않는다
ca.optional-architecture-registry, MainBuild 템플릿 안 두 번째 빌드(optional build)를 위한 것. 여기서는 repo 루트가 곧 Gradle 루트다
VerifyApplicationCoreDependencyPurityTask(ca.architecture 안) 템플릿 계층 이름(domain-core·application-*·shared-contract)에만 걸린다
README.md, 템플릿 AGENTS.md 템플릿 빌드 설명이다. 이 폴더 AGENTS.md로 바꿨다
위 플러그인의 테스트 플러그인과 함께

ca.api-surface는 남겼다. 설계 10.1절은 라이브러리 모듈에 켜기를 권하지만, 공개 타입 기준선 파일과 정책은 새 결정이라 아직 어느 모듈에도 켜지 않았다.

고친 것

파일 바뀐 점
settings/ArchitectureRegistrySettingsPlugin repo 루트 = Gradle 루트. registry의 source_path는 Gradle 루트 기준이다(템플릿은 src/의 부모 기준)
architecture/ArchitecturePlugin 위와 같은 기준, optional build 분기와 purity 태스크를 뺐다
java/JavaConventionsPlugin group을 gradle.properties의 libraryGroup에서 읽는다(템플릿은 dev.caskeleton 고정). 버전은 RELEASE_TAG/-PreleaseTag(vX.Y.Z)에서도 읽는다. 이미지 목록·도구 설정은 루트의 config/만 본다
quality/QualityConventionsPlugin 도구 설정은 루트의 config/만 본다
convention/PlatformModuleConventionPlugin ca.library-publishing을 함께 켠다
ModuleRegistry registry 행의 build 칸을 거절한다. main이 아닌 값(오타 포함)이면 그 모듈이 조용히 빌드에서 빠졌다. 템플릿 91804ec1 뒤 브랜치 claude/x2-grpc-library-43dd09에 같은 수정이 있다
strictlane/StrictLaneStagesPlugin 단계의 계획을 따라갈 때 included build 태스크(ci가 부르는 build-logic test)는 묻지 않는다. 템플릿 ci에는 그런 의존이 없어 드러나지 않았다. 템플릿에도 옮길 만한 수정이다
새 publishing/LibraryPublishingPlugin(ca.library-publishing) 모듈마다 Maven publication(sources·javadoc jar, 해석된 버전), 저장소 gitea·staging, SIGNING_KEY가 있으면 PGP 서명
테스트 fixture source_path를 Gradle 루트 기준으로, PlatformModuleConventionTest에 libraryGroup

Java 패키지 dev.caskeleton.buildlogic은 그대로 두었다. 배포하지 않는 빌드 도구이고, 템플릿 파일과 나란히 비교하기 쉽게 하려는 것이다.

템플릿 수정을 옮기는 법

  1. 템플릿에서 git log --oneline 22df3525..main -- src/build-logic으로 이후 변경을 본다.
  2. 위 「뺀 것」에 해당하지 않는 변경만 같은 파일에 옮긴다. 옮긴 커밋은 본문에 템플릿 커밋 SHA를 적는다.
  3. 옮긴 뒤 이 파일의 「복사한 곳」 커밋을 그 템플릿 커밋으로 바꾸고, 옮긴 횟수를 세어 다시 열 조건과 비교한다.