Copy & Run

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

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

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

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. 사람이 읽는 표

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개가 묶여 표시되는 것을 확인합니다.
Syft 표 출력의 NAME, VERSION, TYPE 열에서 apk 패키지가 한 줄씩 나오고, Simple Launcher는 binary 종류로 중복 5개가 묶여 표시되는 것을 확인합니다.

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

2. 저장용 SBOM 만들기

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

docker run --rm anchore/syft:latest python:3.9-alpine -o cyclonedx-json > sbom.json
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로 나뉘는 것을 확인합니다.
count.py 실행 결과에서 CycloneDX 1.7 문서의 구성 요소가 1048개이고 file 975, library 57, application 15, operating-system 1로 나뉘는 것을 확인합니다.

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

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이 나오는 것을 확인합니다.
syft_more.sh 실행 결과에서 폴더 스캔이 flask, requests, left-pad, demo 네 줄을 보여 주고, 형식별 크기가 나오며, 두 이미지의 패키지 수 39와 56이 비교되고, scope 별 구성 요소 937과 940이 나오는 것을 확인합니다.

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

전체 코드

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

make_sbom.sh 실행 결과에서 표의 앞 10줄, 449999바이트 sbom.json, CycloneDX 1.7 문서의 종류별 개수가 차례로 나오는 것을 확인합니다.
make_sbom.sh 실행 결과에서 표의 앞 10줄, 449999바이트 sbom.json, CycloneDX 1.7 문서의 종류별 개수가 차례로 나오는 것을 확인합니다.

# 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
# 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

#!/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
이 단계의 파일 내려받기:count.pymake_sbom.shsyft_more.sh

자주 막히는 곳

증상 원인과 해결
윈도우에서 -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 이미지 기준입니다.
이 단계의 파일 내려받기:syft_more.sh

이 글의 다음 단계

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

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

교육 문의하기

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

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

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

같은 카테고리의 글