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

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

- 주소: https://copyandrun.com/blog/dockle-image-best-practice-check/
- 분야: DevSecOps
- 발행일: 2026-10-30
- 태그: Dockle, 컨테이너 이미지, CIS, Docker

앞의 [Hadolint 글](/blog/hadolint-dockerfile-lint/)은 Dockerfile이라는 설계도를 읽어 문제를 찾았고, [Trivy 글](/blog/trivy-image-scan-gate/)은 이미지 안의 패키지 취약점을 찾았습니다. 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`)는 다섯 줄입니다.

```dockerfile
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`)는 이렇습니다.

```dockerfile
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`)를 붙여 만들었습니다. 태그를 붙인 이유는 아래 "자주 막히는 곳"에서 설명합니다.

## 2. 나쁜 이미지 점검

<!-- files: dockle_demo.sh -->

```bash
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번에서 설명합니다). 결과는 이렇습니다.

```text
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 파일이 나오는 것을 확인합니다.](https://copyandrun.com/img/dockle-image-best-practice-check/01-dockle-나쁜-이미지.png)

결과 등급은 다섯 가지입니다. FATAL은 바로 고쳐야 할 것, WARN은 고치는 것이 좋은 것, INFO는 알아 둘 것이고, 이 밖에 `SKIP`과 `PASS`가 있습니다. 위 결과의 요약(JSON)은 `fatal 1, warn 1, info 3, skip 0, pass 11`이었습니다. 한 가지 눈에 띄는 점이 있습니다. Dockle은 `DB_PASSWORD`의 값을 `*******`로 가려서 보여 주지만 `API_TOKEN=abc123`은 그대로 보여 줍니다. 이름이 `PASSWORD`인 키만 가리기 때문으로 보이고, 도구가 비밀을 알아본다는 점과 출력 로그에 비밀이 남는다는 점은 별개이므로 CI 로그에 이 출력을 그대로 올릴 때는 주의합니다.

## 3. 내 책임이 아닌 지적: DKL-DI-0004

<!-- files: dockle_demo.sh -->

예외 없이 같은 명령을 실행하면 FATAL이 하나 더 나옵니다.

```text
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이어서 기준을 쓸 수 없습니다.

## 4. 종료 코드 기준

<!-- files: dockle_demo.sh -->

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`로 시작하고, 팀이 준비되면 한 단계씩 낮춥니다.

## 5. ENV 비밀은 이미지 기록에서 그대로 읽힙니다

`CIS-DI-0010`이 FATAL인 이유는 `docker history`로 바로 확인됩니다.

```bash
docker history --no-trunc --format '{{.CreatedBy}}' osk-dockle-bad:1 | grep -o 'DB_PASSWORD=[^ ]* API_TOKEN=[^ ]*'
```

```text
DB_PASSWORD=hunter2 API_TOKEN=abc123
```

이미지를 받은 사람은 누구나 이 명령 한 줄로 값을 읽습니다. 이미 이미지에 넣어 배포한 비밀은 뒤에서 지워도 이전 이미지에 남아 있으므로, 지우는 것이 아니라 바꿔야(키를 폐기하고 새로 발급) 합니다. 층별로 어떻게 남는지는 이 글에서 시험하지 않았습니다. 비밀은 이미지를 만들 때가 아니라 실행할 때 `docker run -e`나 비밀 관리 도구로 넘깁니다. [sops와 age 글](/blog/sops-age-encrypted-config/)이 설정 파일의 비밀을 암호화해 저장하는 방법을 다룹니다.

이어서 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을 확인합니다.](https://copyandrun.com/img/dockle-image-best-practice-check/02-dockle_demo-실행.png)

## 6. CI에 넣는 방법

Dockerfile 점검과 이미지 점검은 서로 다른 것을 잡으므로 순서대로 둡니다. 이미지를 만든 직후에 이렇게 한 줄을 넣습니다.

```bash
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
# 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
# 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`

```python
# app.py
print("hello")
```

`dockle_demo.sh`

```bash
# 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
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| `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 같은 이미지 스캔으로 따로 봅니다.
