# Syft로 컨테이너 이미지의 SBOM 만들기: 패키지 목록을 파일로 남기는 법

> 오픈소스 도구 Syft를 도커로 실행해 python:3.9-alpine 이미지의 구성 요소 목록을 만들고, CycloneDX JSON으로 저장해 항목 종류별로 세어 봅니다. 목록만 있으면 나중에 새로 알려진 취약점과 다시 맞춰 볼 수 있다는 점까지 확인합니다.

- 주소: https://copyandrun.com/blog/syft-sbom-container-image/
- 분야: DevSecOps
- 발행일: 2026-10-28
- 태그: Syft, SBOM, CycloneDX, Docker

SBOM(Software Bill of Materials)은 이미지나 프로그램 안에 어떤 패키지가 들어 있는지 적은 목록입니다. 취약점이 새로 공개되면 "우리 이미지에 그 패키지가 있나"라는 질문에 이미지를 다시 열지 않고 목록만으로 답할 수 있습니다. 이 글에서는 오픈소스 도구 Syft로 목록을 만들고 파일로 저장합니다. 다음 글에서 이 파일을 Grype로 점검합니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11) |
| Syft | 1.55.0 (`anchore/syft:latest` 이미지) |
| 분석 대상 | `python:3.12-alpine`, `python:3.9-alpine` |

Syft를 PC에 설치하지 않고 컨테이너로 실행했습니다.

## 1. 사람이 읽는 표

<!-- files: make_sbom.sh -->

```bash
docker run --rm anchore/syft:latest python:3.12-alpine -o table
```

```
# 기대 출력(일부)
NAME                    VERSION           TYPE
alpine-baselayout       3.7.2-r1          apk
busybox                 1.37.0-r31        apk
ca-certificates         20261020-r0       apk
...
```

머리글 포함 42줄이 나왔고, 이 PC에서 약 9초 걸렸습니다. `TYPE`이 `apk`인 항목은 알파인 리눅스의 패키지입니다. 도커 소켓을 연결하지 않았는데도 분석이 됐습니다.

![Syft 표 출력의 NAME, VERSION, TYPE 열에서 apk 패키지가 한 줄씩 나오고, Simple Launcher는 binary 종류로 중복 5개가 묶여 표시되는 것을 확인합니다.](https://copyandrun.com/img/syft-sbom-container-image/01-syft-표.png)

## 2. 저장용 SBOM 만들기

<!-- files: make_sbom.sh -->

표는 눈으로 보는 용도이고, 도구끼리 주고받는 형식은 CycloneDX나 SPDX입니다. CycloneDX JSON으로 저장합니다.

```bash
docker run --rm anchore/syft:latest python:3.9-alpine -o cyclonedx-json > sbom.json
```

```python
import json
from collections import Counter
d = json.load(open("sbom.json"))
print(d["bomFormat"], d["specVersion"], len(d["components"]))
print(Counter(c["type"] for c in d["components"]))
```

```
# 기대 출력(이 PC)
CycloneDX 1.7 1048
Counter({'file': 975, 'library': 57, 'application': 15, 'operating-system': 1})
```

파일 크기는 449,999바이트였습니다. 구성 요소 1,048개 가운데 975개는 `file` 항목이고, 패키지로 볼 수 있는 `library`는 57개, 실행 프로그램인 `application`은 15개였습니다. "구성 요소 1,048개"를 곧바로 패키지 수로 읽으면 크게 부풀려집니다.

![count.py 실행 결과에서 CycloneDX 1.7 문서의 구성 요소가 1048개이고 file 975, library 57, application 15, operating-system 1로 나뉘는 것을 확인합니다.](https://copyandrun.com/img/syft-sbom-container-image/02-sbom-집계.png)

## 3. 읽는 법

- **종류를 먼저 나눕니다.** `file` 항목은 개별 파일 기록이라 취약점 대조 대상이 아닙니다. 패키지 수를 말할 때는 `library`와 `application`만 셉니다.
- **파일은 이미지 태그가 아니라 그 시점의 내용입니다.** `python:3.9-alpine` 태그는 계속 갱신되므로, 같은 명령도 날짜가 지나면 다른 목록이 나올 수 있습니다. 보관하려면 파일 이름에 날짜와 이미지 다이제스트를 적어 둡니다.
- **목록은 만든 시점의 사실입니다.** 취약점은 그 뒤에 알려집니다. 그래서 목록을 보관해 두고 나중에 다시 대조합니다(다음 글).

## 4. 더 해 보기: 폴더, 형식, 이미지 비교, 범위

`syft_more.sh`로 네 가지를 더 확인했습니다.

**폴더 스캔.** 이미지가 아니라 소스 폴더도 읽습니다. `requirements.txt`(requests, flask)와 `package-lock.json`(left-pad)만 든 폴더를 `dir:/src`로 주었더니 네 줄이 나왔습니다. `requirements.txt`에서 `flask 1.0`, `requests 2.19.1`, 잠금 파일에서 `left-pad 1.3.0`과 프로젝트 자신(`demo 1.0.0`)입니다. 이미지를 만들기 전에 소스 단계에서 의존성 목록을 뽑을 수 있다는 뜻입니다. `requirements.txt`의 두 줄은 pip-audit 글에서 점검한 파일의 일부와 같습니다. 같은 의존성을 Syft는 목록으로, pip-audit는 취약점으로 읽는 셈입니다.

**출력 형식.** 같은 이미지(python:3.12-alpine)를 세 형식으로 저장했습니다.

| 형식 | 크기 |
|---|---|
| `syft-json`(Syft 고유 형식) | 878,041바이트 |
| `spdx-json` | 787,143바이트 |
| `cyclonedx-json` | 330,664바이트 |

CycloneDX가 가장 작고 Syft 고유 형식에는 파일 위치 등 부가 정보가 더 들어 있습니다. 다른 도구에 넘길 때는 상대가 읽는 형식을 확인합니다(다음 글의 Grype에는 이 글에서 만든 CycloneDX 파일을 넘깁니다).

**이미지 두 개의 차이.** python:3.12-alpine과 python:3.9-alpine의 `library` 종류 구성 요소를 비교했습니다.

| 항목 | 값 |
|---|---|
| 3.12의 패키지 수 | 39 |
| 3.9의 패키지 수 | 56 |
| 이름과 버전이 모두 같은 것 | 4 |
| 이름은 같은데 버전이 다른 것 | 34 |
| 3.12에만 있는 이름 | `libapk` |
| 3.9에만 있는 이름(일부) | `autocommand`, `backports-tarfile`, `importlib-metadata`, `inflect`, `jaraco-collections`, `jaraco-context` |

오래된 3.9 이미지는 패키지가 17개 더 많고, 같은 이름도 대부분 버전이 달랐습니다. 이미지 버전을 올릴 때 무엇이 바뀌는지 보려면 SBOM 두 개를 이렇게 비교합니다. 위 숫자 39와 56은 `library`만 센 값이라 아래 범위 항목에 나오는 937개(파일 등 모든 종류)와 다릅니다.

**범위(scope).** 기본은 최종 이미지에 보이는 것만 읽는 `squashed`입니다. `--scope all-layers`로 모든 레이어를 읽었더니 구성 요소가 937개에서 940개로 3개 늘었습니다. 지워졌지만 이전 레이어에 남은 파일을 찾을 때 씁니다. 이 이미지에서는 차이가 작았습니다.

![syft_more.sh 실행 결과에서 폴더 스캔이 flask, requests, left-pad, demo 네 줄을 보여 주고, 형식별 크기가 나오며, 두 이미지의 패키지 수 39와 56이 비교되고, scope 별 구성 요소 937과 940이 나오는 것을 확인합니다.](https://copyandrun.com/img/syft-sbom-container-image/04-심화-결과.png)

## 전체 코드

아래 두 파일을 같은 폴더에 저장하고 `bash make_sbom.sh`로 실행하면 표, SBOM 파일, 종류별 집계가 한 번에 나옵니다. 이미지 두 개는 파일 위쪽의 변수로 바꿉니다.

![make_sbom.sh 실행 결과에서 표의 앞 10줄, 449999바이트 sbom.json, CycloneDX 1.7 문서의 종류별 개수가 차례로 나오는 것을 확인합니다.](https://copyandrun.com/img/syft-sbom-container-image/03-전체-스크립트-결과.png)

```bash
# make_sbom.sh
#!/usr/bin/env bash
# Syft 로 컨테이너 이미지의 패키지 목록을 표와 CycloneDX JSON(SBOM)으로 만들고 종류별로 센다.
# 준비: Docker, 파이썬. Syft 는 설치하지 않고 컨테이너로 실행한다.
# 실행: bash make_sbom.sh   (같은 폴더에 sbom.json 이 만들어진다)
set -u
IMAGE_TABLE=python:3.12-alpine
IMAGE_SBOM=python:3.9-alpine

echo "## 1. 사람이 읽는 표(앞 10줄)"
docker run --rm anchore/syft:latest "$IMAGE_TABLE" -o table 2>/dev/null | head -10

echo "## 2. 저장용 SBOM(CycloneDX JSON)"
docker run --rm anchore/syft:latest "$IMAGE_SBOM" -o cyclonedx-json > sbom.json 2>/dev/null
ls -l sbom.json | awk '{print $5, "bytes", $9}'

echo "## 3. 종류별로 세기"
python -X utf8 count.py
```

```python
# count.py
import json
from collections import Counter
d = json.load(open("sbom.json"))
print(d["bomFormat"], d["specVersion"], len(d["components"]))
print(Counter(c["type"] for c in d["components"]))
```

`syft_more.sh`

```bash
#!/usr/bin/env bash
# Syft 심화: 폴더 스캔, 출력 형식 비교, 이미지 두 개의 차이, 레이어 범위(scope) 비교.
# 준비: Docker, 파이썬(결과 집계용). Syft 는 컨테이너로 실행한다.
# 실행(Git Bash): bash syft_more.sh   (약 2분)
set -u
export MSYS_NO_PATHCONV=1
HERE="$(pwd -W 2>/dev/null || pwd)"
SYFT="docker run --rm anchore/syft:latest"

echo "## 1. 폴더 스캔: 작은 예제 프로젝트(requirements.txt 와 package-lock.json)"
rm -rf sample && mkdir sample
printf 'requests==2.19.1\nflask==1.0\n' > sample/requirements.txt
cat > sample/package-lock.json <<'JSON'
{"name":"demo","version":"1.0.0","lockfileVersion":3,"requires":true,
 "packages":{"":{"name":"demo","version":"1.0.0","dependencies":{"left-pad":"1.3.0"}},
             "node_modules/left-pad":{"version":"1.3.0","resolved":"https://registry.npmjs.org/left-pad/-/left-pad-1.3.0.tgz"}}}
JSON
docker run --rm -v "$HERE/sample:/src:ro" anchore/syft:latest dir:/src -o table 2>/dev/null

echo "## 2. 출력 형식별 크기(python:3.12-alpine)"
for f in syft-json cyclonedx-json spdx-json; do
  $SYFT python:3.12-alpine -o $f 2>/dev/null > "out-$f.json"
  printf '%-16s %8s bytes\n' $f "$(wc -c < out-$f.json | tr -d ' ')"
done

echo "## 3. 이미지 두 개의 차이: python:3.12-alpine 과 python:3.9-alpine"
$SYFT python:3.9-alpine -o cyclonedx-json 2>/dev/null > out-39.json
python -X utf8 - <<'PY'
import json
def pk(f):
    return {(c["name"], c.get("version", "")) for c in json.load(open(f, encoding="utf-8"))["components"] if c["type"] == "library"}
a, b = pk("out-cyclonedx-json.json"), pk("out-39.json")
print("3.12 패키지", len(a), "/ 3.9 패키지", len(b))
print("양쪽에 같은 이름·버전:", len(a & b))
na, nb = {n for n, _ in a}, {n for n, _ in b}
print("이름은 같은데 버전이 다른 것:", len({n for n, _ in a - b} & {n for n, _ in b - a}))
print("3.12 에만 있는 이름:", sorted(na - nb)[:6])
print("3.9 에만 있는 이름:", sorted(nb - na)[:6])
PY

echo "## 4. 범위(scope): 최종 이미지(squashed)와 모든 레이어(all-layers)"
for s in squashed all-layers; do
  n=$($SYFT python:3.12-alpine --scope $s -o cyclonedx-json 2>/dev/null | python -X utf8 -c "import json,sys; print(len(json.load(sys.stdin)['components']))")
  echo "scope=$s 구성 요소 $n"
done
rm -rf sample out-*.json
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| 윈도우에서 `-v` 경로 오류 | Git Bash가 `/w` 같은 경로를 윈도우 경로로 바꿈. `MSYS_NO_PATHCONV=1`을 앞에 붙임 |
| `sbom.json`에 경고 문구가 섞임 | 경고는 표준 오류로 나옴. `> sbom.json`만 쓰고 `2>`는 따로 받음 |
| 버전이 글과 다름 | `latest` 태그를 썼기 때문. 재현하려면 버전 고정 |

## 확인 범위

- **해 본 것(심화 점검 포함):** 2026-10-28, Windows 11 · Docker 29.5.3 · Syft 1.55.0으로 `python:3.12-alpine`은 표, `python:3.9-alpine`은 CycloneDX JSON으로 한 번씩 실행했습니다. `syft_more.sh`로 폴더 스캔, 출력 형식 비교, 이미지 두 개의 차이, 범위 비교도 실행했습니다.
- **해 보지 않은 것:** SPDX 파일 내용 검증, git 저장소 전체 분석, 이미지 서명 첨부, 비공개 레지스트리 인증.
- **읽을 때 주의:** 숫자는 이 날짜의 `python:3.9-alpine` 이미지 기준입니다.
