build: 템플릿 밖에서 혼자 빌드·배포되는 Gradle 루트를 만든다

옮겨 온 메시징 19개 모듈은 템플릿의 src/settings.gradle·build-logic·
카탈로그·registry에 기대고 있어 이 repo만으로는 빌드되지 않는다.
repo 루트를 Gradle 루트로 하는 단독 빌드를 만든다.

- build-logic/: grpc-library main 2e880c7의 줄인 사본(템플릿
  22df3525에서 복사, 템플릿 2959eff0까지의 변경도 같은 내용)에서
  gRPC BOM 규칙(ca.grpc-platform-module)만 뺐다. 배포 플러그인
  ca.library-publishing과 서명 키 해석(SigningKeys)은 그대로다.
  출처·뺀 것·고친 것은 build-logic/UPSTREAM.md.
- settings.gradle·build.gradle·gradle.properties: group
  dev.cakit.messaging, 단계 태스크 ci·mainCheck·releaseCheck와
  배포(release·releaseRehearsal·verifySigningKey)는 grpc-library와
  같은 모양이다. 메시징만 다른 점: Buf가 없고, 성능 lane이 없고,
  mainCheck와 releaseCheck가 브로커 인증 증거 게이트
  (verifyMessagingCertificationEvidence)를 부른다. 템플릿은 이 게이트를
  따로 messaging-certification.yml로 돌렸다. 그 workflow는 지운다.
- config/: registry 19행(source_path만 messaging/<leaf>로), 메시징
  클래스만 남긴 SpotBugs 제외 목록, 이미지 셋(postgres-16, kafka,
  toxiproxy, 모두 digest 고정), checkstyle 사본.
- gradle/libs.versions.toml: 메시징이 쓰는 항목만(avro, cloudevents,
  protobuf 4.33.2, toxiproxy, jmh)과 kafka-clients가 끌고 오는 취약
  버전을 덮는 pinned-lz4-java·pinned-snappy-java.
- 저장소 계약 테스트: MessagingPublicSurfaceContractTest(템플릿
  app-bootstrap에서 이력째 옮김)와 새 MessagingSettingsOwnerContractTest
  (app.messaging 주인은 starter 하나)를 messaging-testkit의
  repositoryContractTest lane에 둔다. check에 들어가 PR 단계에서 돈다.
- messaging-kafka: 인증 manifest 경로를 새 배치로 고친다.

버린 대안: 계약 테스트를 build-logic 테스트로 두는 안. 빌드 플러그인
시험과 모듈 계약이 섞이고, 소스·build.gradle을 입력으로 선언하는
기존 lane 장치를 쓸 수 없다.

위험: 이 커밋 단독으로는 lockfile을 다시 쓰지 않았다(뒤 커밋에서
desktop에서 쓴다). 패키지는 아직 dev.caskeleton.messaging이다.

검증: desktop ./gradlew projects rc=0(19개 모듈 포함).

Refs: design-docs repo-structure/05-library-repos.md 4·10.3·13.1절
This commit is contained in:
DongHyeonka
2026-11-08 16:11:52 +09:00
parent f593229fda
commit 2e9298ec33
87 changed files with 13862 additions and 78 deletions
@@ -0,0 +1,89 @@
package dev.caskeleton.buildlogic.apisurface;
import dev.caskeleton.buildlogic.ApiSurfacePolicy;
import java.io.File;
import java.io.IOException;
import java.io.UncheckedIOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.util.List;
import org.gradle.api.DefaultTask;
import org.gradle.api.GradleException;
import org.gradle.api.file.ConfigurableFileCollection;
import org.gradle.api.file.RegularFileProperty;
import org.gradle.api.provider.ListProperty;
import org.gradle.api.provider.Property;
import org.gradle.api.tasks.Input;
import org.gradle.api.tasks.InputFiles;
import org.gradle.api.tasks.OutputFile;
import org.gradle.api.tasks.TaskAction;
import org.gradle.work.DisableCachingByDefault;
@DisableCachingByDefault(because = "This task intentionally updates a committed review baseline")
public abstract class UpdateApiSurfaceTask extends DefaultTask {
@InputFiles
public abstract ConfigurableFileCollection getSourceRoots();
@OutputFile
public abstract RegularFileProperty getBaseline();
@Input public abstract Property<String> getLabel();
@Input public abstract Property<String> getSurfaceDescription();
@Input public abstract ListProperty<String> getRationale();
@Input public abstract Property<String> getOwningProjectPath();
@Input public abstract Property<String> getApprovalProperty();
@Input public abstract Property<String> getCeilingProperty();
@Input public abstract Property<Boolean> getApproved();
@Input public abstract Property<Boolean> getCeilingRaiseApproved();
@TaskAction
public void updateSurface() {
if (!getApproved().get()) {
throw new GradleException(
getName()
+ " requires -P"
+ getApprovalProperty().get()
+ ": growing the public surface is a review decision, not a build step.");
}
List<File> roots = getSourceRoots().getFiles().stream().sorted().toList();
String rendered;
File baseline = getBaseline().get().getAsFile();
try {
rendered =
ApiSurfacePolicy.render(
roots,
getLabel().get(),
getSurfaceDescription().get(),
getRationale().get(),
getOwningProjectPath().get(),
getName(),
getApprovalProperty().get());
if (baseline.isFile()) {
ApiSurfacePolicy.requireNoUnapprovedGrowth(
getName(),
getOwningProjectPath().get(),
getApprovalProperty().get(),
getCeilingProperty().get(),
ApiSurfacePolicy.countTypes(
Files.readString(baseline.toPath(), StandardCharsets.UTF_8)),
rendered,
getCeilingRaiseApproved().get());
}
} catch (IOException exception) {
throw new UncheckedIOException("failed to read " + baseline, exception);
} catch (IllegalStateException invalidSurface) {
throw new GradleException(invalidSurface.getMessage(), invalidSurface);
}
File parent = baseline.getParentFile();
if (!parent.isDirectory() && !parent.mkdirs()) {
throw new GradleException("Could not create API surface baseline directory " + parent);
}
try {
Files.writeString(baseline.toPath(), rendered, StandardCharsets.UTF_8);
} catch (IOException exception) {
throw new UncheckedIOException("failed to write " + baseline, exception);
}
getLogger().lifecycle("{}: wrote {}", getName(), baseline);
}
}