# etcd — 소스 컴파일형 자체 빌드 (유일한 변종) # # build-hardened-image.sh 가 source 한다. BUILD_ARGS 에 나열한 이름만 --build-arg 로 넘어간다. # 이 이미지는 소스를 직접 컴파일하므로 "베이스 OS" 선택지가 없다 — BASE_OS=source 로 호출한다: # IMAGE=etcd BASE_OS=source bash scripts/build/build-hardened-image.sh # # 왜 자체 빌드하는가·CVE 근거 → README.md # 결정 → doc/decisions/0004-etcd-image-self-build.md DOCKERFILE=source.Dockerfile TARGET=final TAG_SLUG=security # build-hardened-image.sh 가 태그·verify.sh 전달용으로 요구하는 범용 필수값. # 업스트림 stock 이미지(quay.io/coreos/etcd:v3.7.1)와는 태그 슬러그(TAG_SLUG=security)로 # 구분되므로 버전 문자열 자체는 그대로 둔다. APP_VERSION=3.7.1 # v3.7.1 태그가 가리키는 실제 커밋(태그 객체가 아니라 peeled commit), 2026-07-31 확인: # git ls-remote --tags https://github.com/etcd-io/etcd.git v3.7.1 v3.7.1^{} SOURCE_COMMIT=5e7fd0de9a57db03ecc11794dc40403a734c07bb # go.mod 의 `go 1.26`/`toolchain go1.26.5` 요구를 만족하는 공식 golang 이미지 태그. # 이 이미지는 builder 스테이지에서만 쓰이고 최종 이미지에는 남지 않는다. # # 값은 go.mod 최소 요구가 아니라 **stdlib 차단 CVE 를 해소하는 지점**으로 정한다 — 소스를 # 안 바꿔도 CVE 데이터가 갱신되면 여기가 올라간다. 손으로 고르지 않는다: # python3 scripts/build/suggest-go-upgrades.py --reports --image etcd GO_BUILDER_TAG=1.26.6-trixie # 최종 런타임 베이스 — 카탈로그는 SUSE BCI 하나만 쓴다(decisions/0001). 정적 링크 # 바이너리(CGO_ENABLED=0)라 패키지 매니저가 없는 가장 가벼운 bci-micro 로 충분하다. RUNTIME_BASE=registry.suse.com/bci/bci-micro:15.7 # CVE-2026-56852 대응 — golang.org/x/text 를 이 버전 이상으로 강제 업그레이드한다. # v3.7.1/release-3.7 브랜치는 아직 이 CVE 를 백포트하지 않았다(go.mod 실측 x/text # v0.37.0). etcd 메인테이너가 release-3.7 브랜치에 패치를 백포트하면(그리고 v3.7.2 가 # 나오면) 이 자체 빌드는 걷어내고 상위 태그로 돌아간다(대응 우선순위 a 가 c 보다 우선). XTEXT_FIX_VERSION=0.39.0 BUILD_ARGS="SOURCE_COMMIT GO_BUILDER_TAG APP_VERSION RUNTIME_BASE XTEXT_FIX_VERSION"