Files
service-catalog/images/keycloak/suse.Dockerfile
T
wbsong111 4e12e38293 add-keycloakx: micrometer 오버레이 추가 (CI 에서 새로 잡힌 차단 2건)
CI(31148639764)의 trivy 취약점 DB 가 로컬보다 최신이라 로컬 스캔에는 없던
CVE-2026-40983·CVE-2026-40984(io.micrometer:micrometer-core)가 차단으로 잡혔다.
netty·jackson 과 동일한 성격의 번들 jar CVE 라 같은 오버레이 메커니즘으로 처리한다.

micrometer 1.16.3 → 1.16.6. netty 와 같은 이유로 CVE 가 붙은 micrometer-core 만이
아니라 패밀리 전체 4종(commons·core·observation·registry-prometheus-simpleclient)을
함께 올린다 — 아티팩트 간 버전 혼용이 비지원이다.

Dockerfile 의 ARG 선언을 처음에 빠뜨렸는데 overlay-jars.sh 의 `: "${VAR:?}"` 가드가
설계대로 빌드를 세웠다("parameter null or not set"). 조용히 통과하지 않는다.

재빌드 결과(로컬 trivy DB 캐시를 지우고 CI 와 같은 최신 DB 로 재판정):

  차단 0건 — 게이트 PASS
  docker.io/paasup/keycloak:26.7.1-bci15.7-hardened-20260807 push 완료

태그는 빌드일 기준이라 같은 날 재빌드가 같은 태그를 덮는다(프레임워크 설계대로).
직전에 push 된 것은 micrometer 취약점이 남아 있던 빌드이고 어디에도 소비되지 않았다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 14:05:05 +09:00

113 lines
5.5 KiB
Docker

# Keycloak — SUSE BCI 기반 자체 빌드 (+ 취약 jar 오버레이)
#
# 업스트림: https://github.com/keycloak/keycloak/blob/main/quarkus/container/Dockerfile
#
# 업스트림과의 대응 관계
# registry.access.redhat.com/ubi9 (빌더) → registry.suse.com/bci/bci-base:15.7
# ubi-null.sh (rootfs 구성 후 불필요 rpm erase) → bci-micro 파일시스템 씨앗 + zypper --installroot
# registry.access.redhat.com/ubi9-micro (최종) → FROM scratch + 위 rootfs
# ADD $KEYCLOAK_DIST → tar → /opt/keycloak → 동일
# keycloak:x:0:root / uid 1000 / ENTRYPOINT → 동일
# (없음) → 취약 jar 오버레이 + kc.sh build 재augmentation
#
# 왜 자체 빌드인가 (상위 태그·베이스 OS 교체로 안 풀리는 근거)
# 차단 17건 중 12건이 배포본에 정적으로 들어 있는 jar 다. keycloak 26.6.4 와 26.7.1 의
# quarkus.version 이 둘 다 3.33.2.1 이고 그 BOM 이 netty 4.1.135.Final / jackson-bom
# 2.21.2 를 고정한다 — 상위 태그로 올려도 그대로다. 베이스 OS 교체도 jar 에는 통하지
# 않는다. 그래서 jar 를 직접 교체하는 자체 빌드가 유일한 수단이다.
# (etcd 이미지의 `go.work replace golang.org/x/text` 와 같은 성격의 의존성 override)
#
# 왜 SUSE BCI 인가
# 기존 자체 빌드 3종(cloudnative-pg·cnpg-postgresql·etcd)이 전부 SUSE BCI 이고,
# trivy 의 SLES 15.7 커버리지는 양성 대조로 실측 확인돼 있다
# (doc/analysis/sles-oval-measurement.md). "업스트림과 최대한 동일하게" 원칙과
# 충돌하지만 카탈로그 내 일관성을 우선했다 — 근거는 README.md.
#
# ARG 는 반드시 첫 FROM 이전(전역 스코프)에 선언한다. 스테이지 내부에 두면 지역 변수가
# 되어 이후 FROM 의 이미지명 해석에 쓰이지 않는다 (.claude/image-authoring.md 원칙 3).
ARG BUILDER_BASE=registry.suse.com/bci/bci-base:15.7
ARG MICRO_BASE=registry.suse.com/bci/bci-micro:15.7
# 최종 런타임 rootfs 의 씨앗. 여기서 직접 빌드하지 않고 파일시스템만 가져다 쓴다.
FROM ${MICRO_BASE} AS micro
FROM ${BUILDER_BASE} AS builder
ARG KEYCLOAK_VERSION
ARG RUNTIME_PACKAGES
ARG NETTY_OLD
ARG NETTY_VERSION
ARG JACKSON_OLD
ARG JACKSON_VERSION
ARG PGJDBC_OLD
ARG PGJDBC_VERSION
ARG MICROMETER_OLD
ARG MICROMETER_VERSION
# (a) 런타임 rootfs 구성.
#
# bci-micro 의 파일시스템을 씨앗으로 깔고 그 위에 zypper --installroot 로 설치한다.
# 별도 installroot 를 만들어 micro 위에 COPY 로 덮는 방식(업스트림 ubi-null.sh 가
# ubi9-micro 에 하는 것)을 쓰지 않는 이유: 그러면 micro 의 rpmdb 가 새 rpmdb 로 가려져
# micro 자체 패키지가 SBOM 에서 사라진다 — CVE 가 줄어드는 게 아니라 스캔 사각지대가
# 생기는 것이다. 씨앗 방식은 rpmdb 가 micro 것 위에 이어 써져 전부 보인다.
#
# rpm --import 를 먼저 한다. 안 하면 installroot 의 rpmdb 에 SUSE 키가 없어 설치되는
# 패키지마다 "Header V3 RSA/SHA256 Signature, key ID ...: NOKEY" 로 개별 서명 검증이
# 생략된다(저장소 메타데이터 서명은 zypper 가 확인하지만 패키지 단위 검증은 별개다).
COPY --from=micro / /rootfs
RUN set -eux; \
rpm --root /rootfs --import /usr/lib/rpm/gnupg/keys/*.asc; \
zypper --non-interactive --installroot /rootfs --gpg-auto-import-keys refresh; \
zypper --non-interactive --installroot /rootfs install -y --no-recommends \
${RUNTIME_PACKAGES}; \
zypper --non-interactive --installroot /rootfs clean --all; \
rm -rf /rootfs/var/log/zypp /rootfs/var/cache/zypp /rootfs/var/cache/zypper
# (b) 업스트림 배포본 전개 — 업스트림의 ADD $KEYCLOAK_DIST + tar 단계와 동일하다.
ADD https://github.com/keycloak/keycloak/releases/download/${KEYCLOAK_VERSION}/keycloak-${KEYCLOAK_VERSION}.tar.gz /tmp/keycloak/
RUN set -eux; \
cd /tmp/keycloak; \
tar -xf keycloak-*.tar.gz; \
rm keycloak-*.tar.gz; \
mv keycloak-* /opt/keycloak; \
mkdir -p /opt/keycloak/data; \
chmod -R g+rwX /opt/keycloak
# (c) 취약 jar 오버레이. 파일명은 그대로 두고 내용만 수정 버전으로 바꾼다 — 상세는
# overlay-jars.sh 주석. 대상 파일을 하나도 못 찾으면 스크립트가 실패한다.
COPY overlay-jars.sh /tmp/
RUN bash /tmp/overlay-jars.sh /opt/keycloak
FROM scratch AS final
COPY --from=builder /rootfs/ /
COPY --from=builder --chown=1000:0 /opt/keycloak /opt/keycloak
ENV LANG=en_US.UTF-8
# 업스트림과 동일 — 컨테이너 실행 여부 판별 플래그
ENV KC_RUN_IN_CONTAINER=true
RUN echo "keycloak:x:0:root" >> /etc/group && \
echo "keycloak:x:1000:0:keycloak user:/opt/keycloak:/sbin/nologin" >> /etc/passwd
# SUSE 는 java 를 update-alternatives 심볼릭 링크로 노출한다. chroot 설치라 이 링크가
# 안 만들어질 수 있어 빌드 시점에 단정한다 — 런타임에 "java: not found" 로 죽는 것보다
# 여기서 깨지는 게 낫다.
RUN java -version 2>&1 | head -1
# 오버레이한 jar 로 augmentation 이 실제로 통과하는지 빌드 시점에 확인한다.
# 옵션 없는 build 는 릴리스 tar 의 사전 augmentation 상태를 그대로 재현하므로
# 런타임 동작은 업스트림 이미지와 같다(최적화 이미지로 만드는 것이 아니다).
RUN /opt/keycloak/bin/kc.sh build && chown -R 1000:0 /opt/keycloak
USER 1000
EXPOSE 8080
EXPOSE 8443
EXPOSE 9000
ENTRYPOINT [ "/opt/keycloak/bin/kc.sh" ]