Copy & Run

Dockle로 만들어진 컨테이너 이미지 점검하기: 비밀 노출, root 실행, 종료 코드 기준까지

일부러 나쁘게 만든 이미지와 고친 이미지를 Dockle로 점검합니다. CIS-DI 지적을 하나씩 읽고, 베이스 이미지에서 나오는 오탐을 예외로 두고, 이미지 기록에서 ENV 비밀이 그대로 읽히는 것과 종료 코드 기준(--exit-level)을 실행해 확인합니다.

실습 노트 · 2026-10-30 발행 · 10분 · 2026-10 확인

앞의 Hadolint 글은 Dockerfile이라는 설계도를 읽어 문제를 찾았고, Trivy 글은 이미지 안의 패키지 취약점을 찾았습니다. Dockle은 그 사이를 채웁니다. 이미 만들어진 이미지를 열어서 "root로 실행되는가", "비밀이 환경 변수에 들어 있는가", "HEALTHCHECK가 있는가" 같은 CIS Docker 벤치마크 기반의 모범 사례를 점검합니다. 이 글은 일부러 나쁘게 만든 이미지와 고친 이미지를 같은 명령으로 점검하고, 도구가 내는 지적 중 어느 것이 내 책임이 아닌지까지 실행해서 확인합니다.

준비물

항목 확인한 값
Docker 29.5.3 (Windows 11, Git Bash에서 실행)
Dockle 0.4.15 (goodwithtech/dockle 이미지, 설치 없이 컨테이너로 실행)
기반 이미지 python:3.12-alpine
파이썬 3.12 (JSON 읽기용)

Dockle은 이미지를 읽어야 하므로 Docker 소켓(/var/run/docker.sock)을 컨테이너에 연결해서 실행합니다. 소켓을 연결하면 그 컨테이너가 Docker를 조작할 수 있게 되므로, 신뢰하는 도구에만 이렇게 하고 운영 서버에서는 이미지를 파일로 저장해 점검하는 방법을 먼저 검토합니다(이 글에서는 파일로 저장하는 방법은 시험하지 않았습니다).

1. 나쁜 이미지와 고친 이미지

나쁜 이미지(Dockerfile.bad)는 다섯 줄입니다.

FROM python:3.12-alpine
ENV DB_PASSWORD=hunter2 API_TOKEN=abc123
COPY app.py /app/app.py
RUN chmod 4755 /bin/busybox && echo "debug" > /tmp/.env
CMD ["python", "/app/app.py"]

비밀을 ENV에 넣었고, 파일 이름이 .env인 파일을 남겼고, 실행 파일에 setuid 비트(4755)를 주었고, 사용자와 HEALTHCHECK를 지정하지 않았습니다. 고친 이미지(Dockerfile.good)는 이렇습니다.

FROM python:3.12-alpine
RUN adduser -D -u 10001 appuser
COPY --chown=appuser app.py /app/app.py
USER appuser
HEALTHCHECK --interval=30s CMD python -c "print('ok')"
CMD ["python", "/app/app.py"]

비밀과 .env와 setuid를 없애고, 일반 사용자(appuser, 10001)로 실행하고, HEALTHCHECK를 더했습니다. 두 이미지 모두 app.py는 print("hello") 한 줄이고, 이름에 태그(:1)를 붙여 만들었습니다. 태그를 붙인 이유는 아래 "자주 막히는 곳"에서 설명합니다.

이 단계의 파일 내려받기:Dockerfile.badDockerfile.goodapp.py

2. 나쁜 이미지 점검

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock \
  goodwithtech/dockle:latest --no-color -i DKL-DI-0004 osk-dockle-bad:1

--no-color는 색 코드를 끄고, -i DKL-DI-0004는 이 규칙을 예외로 둡니다(이유는 3번에서 설명합니다). 결과는 이렇습니다.

FATAL	- CIS-DI-0010: Do not store credential in environment variables/files
	* Suspicious filename found : tmp/.env (You can suppress it with "-af .env")
	* Suspicious ENV key found : DB_PASSWORD on ENV DB_PASSWORD=******* API_TOKEN=abc123 (You can suppress it with --accept-key)
WARN	- CIS-DI-0001: Create a user for the container
	* Last user should not be root
INFO	- CIS-DI-0005: Enable Content trust for Docker
INFO	- CIS-DI-0006: Add HEALTHCHECK instruction to the container image
INFO	- CIS-DI-0008: Confirm safety of setuid/setgid files
	* setuid file: urwxr-xr-x bin/busybox

Dockle로 나쁜 이미지를 점검한 결과에서 FATAL로 CIS-DI-0010(비밀과 .env 파일), WARN으로 CIS-DI-0001(root 사용자), INFO로 content trust, HEALTHCHECK 없음, setuid 파일이 나오는 것을 확인합니다.
Dockle로 나쁜 이미지를 점검한 결과에서 FATAL로 CIS-DI-0010(비밀과 .env 파일), WARN으로 CIS-DI-0001(root 사용자), INFO로 content trust, HEALTHCHECK 없음, setuid 파일이 나오는 것을 확인합니다.

결과 등급은 다섯 가지입니다. FATAL은 바로 고쳐야 할 것, WARN은 고치는 것이 좋은 것, INFO는 알아 둘 것이고, 이 밖에 SKIP과 PASS가 있습니다. 위 결과의 요약(JSON)은 fatal 1, warn 1, info 3, skip 0, pass 11이었습니다. 한 가지 눈에 띄는 점이 있습니다. Dockle은 DB_PASSWORD의 값을 *******로 가려서 보여 주지만 API_TOKEN=abc123은 그대로 보여 줍니다. 이름이 PASSWORD인 키만 가리기 때문으로 보이고, 도구가 비밀을 알아본다는 점과 출력 로그에 비밀이 남는다는 점은 별개이므로 CI 로그에 이 출력을 그대로 올릴 때는 주의합니다.

이 단계의 파일 내려받기:dockle_demo.sh

3. 내 책임이 아닌 지적: DKL-DI-0004

예외 없이 같은 명령을 실행하면 FATAL이 하나 더 나옵니다.

FATAL	- DKL-DI-0004: Use "apk add" with --no-cache
	* Use --no-cache option if use 'apk add': RUN /bin/sh -c set -eux; apk add --no-cache --virtual .build-deps ...

이 줄은 이상합니다. 내 Dockerfile에는 apk add가 없고, 지적된 명령에는 이미 --no-cache가 들어 있습니다. 이것은 베이스 이미지(python:3.12-alpine)가 만들어질 때의 명령 기록이며, 고친 이미지에서도 똑같이 나왔습니다. 베이스 이미지의 기록 전체를 훑는 규칙이 긴 명령 안의 apk add를 잘못 판단한 것으로 추정합니다. 이 글에서는 이 판정이 맞는지 Dockle 쪽 코드로 확인하지는 않았습니다. 확인한 것은 이 규칙이 내 Dockerfile을 고쳐도 사라지지 않는다는 점입니다. 이런 지적은 근거를 적고 -i DKL-DI-0004로 예외를 둡니다. 예외를 두지 않으면 고친 이미지도 항상 FATAL이어서 기준을 쓸 수 없습니다.

이 단계의 파일 내려받기:dockle_demo.sh

4. 종료 코드 기준

CI에서는 종료 코드가 필요합니다. --exit-code 1은 지적이 있으면 종료 코드를 1로 하라는 뜻이고, --exit-level은 어느 등급부터 지적으로 칠지 정합니다. 예외(DKL-DI-0004)를 둔 채로 세 기준을 두 이미지에 적용했습니다.

--exit-level 나쁜 이미지 고친 이미지
fatal 1 0
warn 1 0
info 1 1

fatal과 warn에서는 나쁜 이미지만 실패해 기준으로 쓸 수 있습니다. info에서는 고친 이미지도 실패하는데, 남은 INFO 하나가 CIS-DI-0005(Docker 콘텐츠 신뢰, DOCKER_CONTENT_TRUST=1)이기 때문입니다. 이것은 이미지가 아니라 이미지를 받고 만드는 환경의 설정이라 이 글의 이미지에서는 고칠 수 없습니다. 예외를 하나 더 두면(-i CIS-DI-0005) info 기준에서도 고친 이미지는 종료 코드 0이 되었습니다. 처음에는 warn이나 fatal로 시작하고, 팀이 준비되면 한 단계씩 낮춥니다.

이 단계의 파일 내려받기:dockle_demo.sh

5. ENV 비밀은 이미지 기록에서 그대로 읽힙니다

CIS-DI-0010이 FATAL인 이유는 docker history로 바로 확인됩니다.

docker history --no-trunc --format '{{.CreatedBy}}' osk-dockle-bad:1 | grep -o 'DB_PASSWORD=[^ ]* API_TOKEN=[^ ]*'
DB_PASSWORD=hunter2 API_TOKEN=abc123

이미지를 받은 사람은 누구나 이 명령 한 줄로 값을 읽습니다. 이미 이미지에 넣어 배포한 비밀은 뒤에서 지워도 이전 이미지에 남아 있으므로, 지우는 것이 아니라 바꿔야(키를 폐기하고 새로 발급) 합니다. 층별로 어떻게 남는지는 이 글에서 시험하지 않았습니다. 비밀은 이미지를 만들 때가 아니라 실행할 때 docker run -e나 비밀 관리 도구로 넘깁니다. sops와 age 글이 설정 파일의 비밀을 암호화해 저장하는 방법을 다룹니다.

이어서 root 문제를 직접 확인했습니다. 나쁜 이미지를 실행해 id를 확인하면 uid=0(root)이었고, 고친 이미지는 uid=10001(appuser)였습니다. HEALTHCHECK는 docker inspect로 [CMD-SHELL python -c "print('ok')"]가 들어간 것을 확인했습니다. 고친 이미지를 같은 방식으로 점검하면 INFO 하나(CIS-DI-0005)만 남습니다.

dockle_demo.sh 실행 결과에서 두 이미지를 점검하고, 예외 후 요약과 종료 코드 표, docker history로 읽히는 비밀, root와 appuser의 id, 고친 이미지의 남은 INFO 하나와 info 기준 종료 코드 0을 확인합니다.
dockle_demo.sh 실행 결과에서 두 이미지를 점검하고, 예외 후 요약과 종료 코드 표, docker history로 읽히는 비밀, root와 appuser의 id, 고친 이미지의 남은 INFO 하나와 info 기준 종료 코드 0을 확인합니다.

이 단계의 파일 내려받기:dockle_demo.sh

6. CI에 넣는 방법

Dockerfile 점검과 이미지 점검은 서로 다른 것을 잡으므로 순서대로 둡니다. 이미지를 만든 직후에 이렇게 한 줄을 넣습니다.

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock goodwithtech/dockle:latest \
  --exit-code 1 --exit-level warn -i DKL-DI-0004 myapp:1.0

권장하는 순서는 Hadolint(Dockerfile), Dockle(이미지 구성), Trivy(이미지의 취약점)입니다. 이 글에서는 CI 서비스에 실제로 올려 보지 않았고, 위 명령의 종료 코드 동작만 확인했습니다. latest 태그를 쓰면 DKL-DI-0006(latest 태그 회피) 경고가 나오므로 점검할 이미지에는 버전 태그를 붙입니다.

전체 코드

아래 파일들을 같은 폴더에 두고 bash dockle_demo.sh를 실행하면 이 글의 출력을 다시 얻습니다. 이 PC에서 약 1분이 걸렸고, 끝에 시험 이미지 두 개를 지웁니다.

Dockerfile.bad

# Dockerfile.bad
FROM python:3.12-alpine
ENV DB_PASSWORD=hunter2 API_TOKEN=abc123
COPY app.py /app/app.py
RUN chmod 4755 /bin/busybox && echo "debug" > /tmp/.env
CMD ["python", "/app/app.py"]

Dockerfile.good

# Dockerfile.good
FROM python:3.12-alpine
RUN adduser -D -u 10001 appuser
COPY --chown=appuser app.py /app/app.py
USER appuser
HEALTHCHECK --interval=30s CMD python -c "print('ok')"
CMD ["python", "/app/app.py"]

app.py

# app.py
print("hello")

dockle_demo.sh

# dockle_demo.sh
#!/usr/bin/env bash
# Dockle 로 "만들어진 이미지"의 모범 사례 위반을 점검한다. 일부러 나쁘게 만든 이미지(bad)와 고친 이미지(good)를 비교한다.
# 준비: Docker, 같은 폴더에 Dockerfile.bad, Dockerfile.good, app.py. 내 컴퓨터에서 만든 이미지만 검사한다.
# 실행(Git Bash): bash dockle_demo.sh   (약 1분)
export MSYS_NO_PATHCONV=1
# Dockle 은 이미지를 읽으려고 Docker 소켓을 마운트한다. --no-color 로 색 코드를 끈다
DK="docker run --rm -v /var/run/docker.sock:/var/run/docker.sock goodwithtech/dockle:latest --no-color"

echo "## 1. 이미지 두 개 만들기(태그를 꼭 붙인다. 태그가 없으면 latest 로 보고 경고한다)"
docker build -q -f Dockerfile.bad  -t osk-dockle-bad:1  . >/dev/null
docker build -q -f Dockerfile.good -t osk-dockle-good:1 . >/dev/null
$DK --version

echo "## 2. 나쁜 이미지를 그대로 검사: 앞 한 줄씩만(긴 줄은 자른다)"
$DK osk-dockle-bad:1 2>&1 | grep -E '^(FATAL|WARN|INFO)' | cut -c1-110

echo "## 3. DKL-DI-0004 는 내 Dockerfile 이 아니라 베이스 이미지(python:3.12-alpine)의 빌드 기록에서 나온다. 예외로 두고 JSON 으로 본다"
$DK -i DKL-DI-0004 -f json osk-dockle-bad:1 2>/dev/null | python -X utf8 -c "
import json, sys
d = json.load(sys.stdin)
print('summary:', d['summary'])
for x in d['details']:
    print(f\"  {x['level']:6} {x['code']:11} {x['alerts'][0][:70]}\")"

echo "## 4. 실패 기준(--exit-level)에 따른 종료 코드. 예외: DKL-DI-0004"
for lv in fatal warn info; do
  for n in bad good; do
    $DK -i DKL-DI-0004 --exit-code 1 --exit-level $lv osk-dockle-$n:1 >/dev/null 2>&1
    echo "  level=$lv  $n  exit=$?"
  done
done

echo "## 5. 왜 ENV 의 비밀이 문제인가: 이미지 기록을 읽기만 해도 값이 보인다"
docker history --no-trunc --format '{{.CreatedBy}}' osk-dockle-bad:1 | grep -o 'DB_PASSWORD=[^ ]* API_TOKEN=[^ ]*' | head -1
docker run --rm osk-dockle-bad:1 id

echo "## 6. 고친 이미지: 비밀은 이미지에 넣지 않고, 일반 사용자로 실행하고, HEALTHCHECK 를 둔다"
docker run --rm osk-dockle-good:1 id
docker inspect --format 'healthcheck: {{.Config.Healthcheck.Test}}' osk-dockle-good:1
$DK -i DKL-DI-0004 osk-dockle-good:1 2>&1 | grep -E '^(FATAL|WARN|INFO)' | cut -c1-110

echo "## 7. 남은 INFO(CIS-DI-0005, 콘텐츠 신뢰)는 빌드 환경의 설정이라 이 이미지에서는 예외로 두고 기준을 INFO 로 둔다"
$DK -i DKL-DI-0004 -i CIS-DI-0005 --exit-code 1 --exit-level info osk-dockle-good:1 >/dev/null 2>&1
echo "  good, level=info, 예외 2개: exit=$?"

echo "## 8. 정리"
docker rmi osk-dockle-bad:1 osk-dockle-good:1 >/dev/null
docker images --format '{{.Repository}}' | grep -c osk-dockle
이 단계의 파일 내려받기:Dockerfile.badDockerfile.goodapp.pydockle_demo.sh

자주 막히는 곳

증상 원인과 해결
DKL-DI-0006: Avoid 'latest' tag 경고 태그 없이 만든 이미지는 latest로 취급. 처음에는 태그 없이 만들어 이 경고가 나왔고, :1을 붙이자 사라짐
고친 이미지도 DKL-DI-0004로 FATAL 베이스 이미지의 기록에서 나오는 지적. 3번처럼 근거를 적고 -i로 예외 처리
Cannot connect to the Docker daemon 오류 소켓 마운트가 빠졌거나 경로가 바뀐 경우. Git Bash에서는 export MSYS_NO_PATHCONV=1을 먼저 실행
.env 지적을 끄고 싶은 경우 정말 비밀이 없는 파일이면 파일 내용을 확인한 뒤 -af .env나 --accept-key 키이름으로 허용
출력 줄이 너무 긴 경우 베이스 이미지의 명령이 통째로 출력됨. cut -c1-130으로 자르거나 -f json으로 받아 필요한 필드만 읽기

확인 범위

  • 해 본 것: 2026-10-30, Windows 11 · Docker 29.5.3 · Dockle 0.4.15에서 나쁜 이미지와 고친 이미지의 점검, 베이스 이미지에서 나오는 DKL-DI-0004 확인과 예외, JSON 요약, --exit-level 세 값에서의 종료 코드, docker history로 ENV 비밀 읽기, 두 이미지의 id와 HEALTHCHECK 확인을 실행했습니다. 끝난 뒤 시험 이미지를 지웠습니다.
  • 해 보지 않은 것: 이미지를 파일로 저장해 점검하는 방법(--input), 원격 레지스트리의 이미지, 다른 베이스 이미지(Debian, Ubuntu 등)에서의 결과, setuid 파일을 실제로 악용하는 시험, .dockleignore 파일, 여러 단계 빌드, Linux와 macOS.
  • 읽을 때 주의: 규칙 번호와 등급은 이 버전(0.4.15)의 값입니다. DKL-DI-0004가 베이스 이미지의 기록에서 나왔다는 설명은 이 글의 관찰이며 도구 내부는 확인하지 않았습니다. 점검을 통과했다고 이미지가 안전하다는 뜻은 아닙니다. 이미지 안 패키지의 취약점은 Trivy 같은 이미지 스캔으로 따로 봅니다.

이 글의 다음 단계

  • Trivy로 컨테이너 이미지 취약점을 스캔하고 빌드 게이트 만들기오래된 베이스 이미지와 고정 버전 패키지로 작은 이미지를 빌드해 Trivy로 스캔하고, 결과 표 읽는 법과 HIGH,CRITICAL 필터, --ignore-unfixed, --exit-code 1 게이트, 만료일이 있는 .trivyignore 예외를 거쳐 베이스 이미지를 올려 통과시킵니다.
  • 컨테이너 이미지에 서명하고 서명 없는 이미지 거부하기(cosign)내 컴퓨터의 로컬 레지스트리에 작은 이미지를 올리고 cosign으로 서명해 검증합니다. SBOM 증명을 붙이고, 같은 태그로 다른 이미지를 덮어쓰면 검증이 실패하는 것과 서명 없는 이미지가 거부되는 것을 재현한 뒤, 다이제스트로 고정해 배포하는 게이트 스크립트로 마무리합니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글