fix(ci): 라이선스 판정을 배포하는 의존성에 두고 빌드한 뒤에 돈다
pr / done (pull_request) Successful in 13m37s

문제: PR 단계를 job 하나로 접자 Trivy filesystem 검사가 Gradle 빌드 뒤에 돌게
됐고, 처음으로 lockfile의 라이선스를 읽었다(run 95). Trivy는 같은 기계의 Gradle
캐시에서만 lockfile의 라이선스를 읽는데, 예전의 따로 된 검사 job에는 캐시가 없어
「High/Critical 라이선스는 막는다」는 검사가 라이선스를 한 번도 본 적이 없었다.
보이게 되자 lockfile마다 SpotBugs·Checkstyle(LGPL), Error Prone dataflow(GPL+CPE),
Jakarta API(EPL/GPL 이중), org.reflections(WTFPL, Trivy 분류 forbidden) 등이 걸렸다.
대부분 배포하지 않는 빌드 도구·시험 구성이다. 한편 릴리스 이미지 검사는 jar의
라이선스를 읽지 못한다(run 62의 Licenses 칸이 모든 jar에서 비어 있다). 그래서 앞
커밋의 「앱 의존성 금지 라이선스는 이미지에서 막는다」도 빈 검사였다.

고른 방법(2026-11-11 소유자 결정 「배포하는 의존성의 금지 라이선스만 실패」):
- filesystem 검사가 `src/bootstrap/app/gradle.lockfile`의 runtimeClasspath 항목
  (기본 조립 jar에 실리는 것)만 골라 forbidden(CRITICAL)이면 실패한다.
- Gradle 캐시가 없으면 건너뛴다고 적는다. 캐시가 있는데 라이선스를 하나도 읽지
  못하면 빈 검사이므로 실패한다.
- 나머지 라이선스 결과(OS, 도구, 시험, restricted)는 보고만 한다. 이미지 검사의
  빈 라이선스 gate는 지우고 보고만 남긴다. 정책 문서를 실제 동작에 맞춘다.

버린 대안: lockfile 전체에 High/Critical을 그대로 막고 예외를 다는 것. Trivy의
라이선스 예외는 라이선스 이름 단위라 도구용 LGPL을 빼면 배포 의존성의 LGPL도 빠진다.

위험·한계: main.yml의 vulnerabilities job은 빌드하지 않아 라이선스 판정을 건너뛴다.
판정은 병합을 막는 PR 단계에 있다. runtimeClasspath 밖에서 jar에 실리는 것(다른
조립)이 생기면 grep 조건을 넓혀야 한다.

검증: runner PR `pr / done`(이 PR 본문에 적는다).
This commit is contained in:
DongHyeonka
2026-11-12 02:26:58 +09:00
parent 24dde5867d
commit aeb6033990
2 changed files with 47 additions and 16 deletions
+8 -3
View File
@@ -26,9 +26,14 @@ GitHub dependency review와 dependency submission은 GitHub.com API에만 있어
- 기본 이미지는 고칠 수 있는 최신 digest로 둔다(`Dockerfile`, 지금 `eclipse-temurin:21-jre-noble`).
OS 패키지의 High/Critical도 아래 표대로 막는다. 고친 버전이 있으면 새 digest로 고친다.
- 아직 고친 버전이 없는 High/Critical만 `.trivyignore.yaml`에 이유와 `expired_at`을 달아 둔다.
- 라이선스: 앱 의존성(`--pkg-types library`)의 금지 라이선스(Trivy CRITICAL)만 막는다. 그 밖의 라이선스
결과는 OS 패키지 것까지 보고만 한다. 배포판의 GPL 패키지는 이 애플리케이션의 이용 조건이 아니다.
- pull request의 `filesystem` 검사는 그대로다(앱 의존성의 High/Critical 라이선스도 막는다).
- 라이선스: 배포하는 의존성의 금지 라이선스(Trivy CRITICAL)만 막는다. 배포하는 것은 기본 조립의 jar이므로
`src/bootstrap/app/gradle.lockfile`의 `runtimeClasspath` 항목을 본다. 그 밖의 라이선스 결과(OS 패키지,
빌드 도구 SpotBugs·Checkstyle·Error Prone, 시험 라이브러리, restricted 등급)는 보고만 한다. 배포판의 GPL
패키지는 이 애플리케이션의 이용 조건이 아니다.
- 이 라이선스 판정은 pull request의 `done` job이 빌드한 뒤에 돈다. Trivy는 같은 기계의 Gradle 캐시에서만
lockfile의 라이선스를 읽고, 이미지 안 jar의 라이선스는 읽지 못한다. 예전의 따로 된 검사 job에는 캐시가
없어 라이선스 검사가 라이선스를 한 번도 보지 못했다(2026-11-12 확인). 캐시가 없으면 건너뛴다고 적고,
캐시가 있는데 라이선스를 하나도 읽지 못하면 실패한다.
## 심각도와 대응
+39 -13
View File
@@ -3,11 +3,13 @@
# (`filesystem`) and release.yml (`image <reference>`); not by Gradle and not on the desktop, because
# it downloads and installs its tools (docs/work/operate.md 4.1).
#
# bash scripts/ci/trivy-scan.sh filesystem dependency tree: block High/Critical, report
# Medium/Low, fail on any CISA KEV match
# bash scripts/ci/trivy-scan.sh filesystem dependency tree: block High/Critical
# vulnerabilities and a forbidden license on a
# shipped dependency (after a build), report the
# rest, fail on any CISA KEV match
# bash scripts/ci/trivy-scan.sh image <reference> release image: write image-sbom.cdx.json,
# block High/Critical vulnerabilities and
# forbidden application licenses, report the rest
# block High/Critical vulnerabilities, report
# the rest and the licenses
#
# Tools are pinned release binaries with an asserted SHA-256, installed under RUNNER_TEMP (or a
# temporary directory): a checksum is a supply-chain claim that can be checked offline, an action
@@ -48,9 +50,36 @@ chmod 0755 "${tools}/trivy" "${tools}/jq"
export PATH="${tools}:${PATH}"
[ "$(jq --version)" = "jq-${JQ_VERSION}" ] || { echo "trivy-scan: unexpected $(jq --version)" >&2; exit 1; }
# A forbidden license on a dependency that ships fails (owner decision 2026-11-11). What ships is
# the default composition's jar, so the gate reads the bootstrap leaf's runtimeClasspath lockfile
# entries. Trivy finds a lockfile's licenses only in the Gradle cache of the same machine; the
# release image scan cannot read a jar's license at all (its Licenses column is empty for every
# jar), and the old separate scan job had no cache, so until the pull-request stage became one job
# that builds first no license gate here had ever seen a license. With no cache this says so and
# skips; with a cache and not one license read, the check would be empty, so it fails.
scan_shipped_licenses() {
local cache="${GRADLE_USER_HOME:-${HOME}/.gradle}/caches/modules-2"
if [ ! -d "${cache}" ]; then
echo "trivy-scan: no Gradle cache at ${cache}; the shipped-license gate runs after a build (pr.yml)"
return 0
fi
local shipped="${tools}/shipped"
mkdir -p "${shipped}"
grep -E '=([^=]*,)?runtimeClasspath(,|$)' src/bootstrap/app/gradle.lockfile > "${shipped}/gradle.lockfile" \
|| { echo "trivy-scan: src/bootstrap/app/gradle.lockfile has no runtimeClasspath entry" >&2; exit 1; }
trivy fs --scanners license --format json --output "${tools}/shipped-licenses.json" "${shipped}"
jq -e '[.Results[]?.Licenses[]?] | length > 0' "${tools}/shipped-licenses.json" > /dev/null \
|| { echo "trivy-scan: Trivy read no license for the shipped dependencies; the gate would be empty" >&2; exit 1; }
trivy fs --scanners license --severity CRITICAL --exit-code 1 --ignorefile .trivyignore.yaml "${shipped}"
}
scan_filesystem() {
trivy fs --scanners vuln,license --severity CRITICAL,HIGH --exit-code 1 --ignorefile .trivyignore.yaml .
trivy fs --scanners vuln,license --severity MEDIUM,LOW --exit-code 0 --ignorefile .trivyignore.yaml .
trivy fs --scanners vuln --severity CRITICAL,HIGH --exit-code 1 --ignorefile .trivyignore.yaml .
trivy fs --scanners vuln --severity MEDIUM,LOW --exit-code 0 --ignorefile .trivyignore.yaml .
scan_shipped_licenses
# Every other license finding is reported only: the lockfiles also list build tools (SpotBugs,
# Checkstyle, Error Prone) and test libraries that never ship.
trivy fs --scanners license --exit-code 0 --ignorefile .trivyignore.yaml .
trivy fs --scanners vuln --severity CRITICAL,HIGH,MEDIUM,LOW,UNKNOWN --exit-code 0 \
--ignorefile .trivyignore.yaml --format json --output "${tools}/trivy-kev.json" .
@@ -103,13 +132,10 @@ scan_image() {
# carried in .trivyignore.yaml with its expiry (owner decision 2026-11-11).
trivy image --scanners vuln --severity CRITICAL,HIGH --exit-code 1 --ignorefile .trivyignore.yaml "$1"
trivy image --scanners vuln --severity MEDIUM,LOW --exit-code 0 --ignorefile .trivyignore.yaml "$1"
# Licenses (same decision): an application dependency under a forbidden license (Trivy's
# CRITICAL) fails the release. Every other license finding, the OS packages' included, is
# reported and does not block: a distribution's GPL packages are not this application's terms.
trivy image --scanners license --pkg-types library --severity CRITICAL --exit-code 1 \
--ignorefile .trivyignore.yaml "$1"
trivy image --scanners license --severity HIGH,MEDIUM,LOW,UNKNOWN --exit-code 0 \
--ignorefile .trivyignore.yaml "$1"
# Licenses are reported only (same decision): the OS packages' are the distribution's terms, not
# this application's, and Trivy reads no license from a jar in an image. The shipped jars' gate is
# the filesystem scan's (scan_shipped_licenses), which pull requests run after building.
trivy image --scanners license --exit-code 0 --ignorefile .trivyignore.yaml "$1"
}
case "${1:-}" in