Files
messaging-library/scripts/release/check-staging.py
T
DongHyeonka 2e9298ec33 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절
2026-11-08 16:11:52 +09:00

86 lines
3.6 KiB
Python

#!/usr/bin/env python3
"""Checks a staged release (build/staging-repository) file by file before anything is uploaded.
check-staging.py <repository dir> <group> <version> signed|unsigned <artifact>...
For every module: the jar, sources and javadoc jars, POM and Gradle module file, each with its
.md5/.sha1/.sha256/.sha512 checksum (and .asc when signed), and every dependency in the POM and the
module file carries a version. The last check is the publishing trap the design names: the modules
declare most dependencies without a version and let a BOM fill it, and a published file written
from the declarations would leave consumers nothing to resolve. For the SBOM artifact
(messaging-library): its POM and the CycloneDX JSON.
"""
import json
import sys
import xml.etree.ElementTree as ET
from pathlib import Path
CHECKSUMS = (".md5", ".sha1", ".sha256", ".sha512")
POM = "{http://maven.apache.org/POM/4.0.0}"
def expect(path: Path, signed: bool, problems: list[str]) -> None:
if not path.is_file():
problems.append(f"missing {path.name}")
return
for suffix in CHECKSUMS + ((".asc",) if signed else ()):
if not path.with_name(path.name + suffix).is_file():
problems.append(f"missing {path.name}{suffix}")
def unversioned_pom(pom: Path) -> list[str]:
root = ET.parse(pom).getroot()
out = []
for dependency in root.iter(f"{POM}dependency"):
version = dependency.findtext(f"{POM}version")
if not version or not version.strip():
out.append(f"{dependency.findtext(f'{POM}groupId')}:{dependency.findtext(f'{POM}artifactId')}")
return out
def unversioned_module(module: Path) -> list[str]:
data = json.loads(module.read_text(encoding="utf-8"))
out = []
for variant in data.get("variants", []):
for dependency in variant.get("dependencies", []):
version = dependency.get("version") or {}
if not any(version.get(k) for k in ("requires", "strictly", "prefers")):
out.append(f"{variant['name']}: {dependency['group']}:{dependency['module']}")
return out
def main() -> int:
if len(sys.argv) < 6:
print(__doc__, file=sys.stderr)
return 2
repository, group, version, signing = Path(sys.argv[1]), sys.argv[2], sys.argv[3], sys.argv[4]
signed = signing == "signed"
failed = False
for artifact in sys.argv[5:] + ["messaging-library"]:
directory = repository / group.replace(".", "/") / artifact / version
base = directory / f"{artifact}-{version}"
problems: list[str] = []
if artifact == "messaging-library":
expect(base.with_name(base.name + ".pom"), signed, problems)
expect(base.with_name(base.name + "-cyclonedx.json"), signed, problems)
else:
for suffix in (".jar", "-sources.jar", "-javadoc.jar", ".pom", ".module"):
expect(base.with_name(base.name + suffix), signed, problems)
pom, module = base.with_name(base.name + ".pom"), base.with_name(base.name + ".module")
if pom.is_file():
problems += [f"POM dependency without a version: {d}" for d in unversioned_pom(pom)]
if module.is_file():
problems += [f"module dependency without a version: {d}" for d in unversioned_module(module)]
if problems:
failed = True
print(f"{group}:{artifact}:{version}", file=sys.stderr)
for problem in problems:
print(f" - {problem}", file=sys.stderr)
else:
print(f"staged: {group}:{artifact}:{version}{' (signed)' if signed else ''}")
return 1 if failed else 0
if __name__ == "__main__":
sys.exit(main())