Debian 13 강좌 / Podman rootless 컨테이너와 볼륨 데이터 보존
Debian 13에서는 Podman을 일반 사용자로 실행해 rootless 컨테이너를 만들 수 있습니다. 교체 후에도 필요한 파일을 유지하려면 컨테이너의 임시 쓰기 계층과 별도 볼륨을 구분하고, 같은 사용자·같은 볼륨으로 다시 실행해야 합니다. 이 강좌는 공식 httpd 이미지를 digest로 고정하고 loopback 포트에서 응답과 데이터 보존을 검증합니다.
이미지·컨테이너·볼륨을 먼저 구분하기
이미지는 프로그램과 실행에 필요한 파일을 담은 배포 단위이며, 컨테이너는 이미지에서 생성한 실행 인스턴스입니다. 컨테이너에 쓴 파일은 해당 컨테이너의 쓰기 계층에 남을 수 있지만 컨테이너를 삭제하면 함께 잃습니다. 명명 볼륨은 별도 이름으로 관리하는 저장 공간으로, 컨테이너 교체와 수명을 분리할 수 있습니다.
rootless는 호스트에서 일반 사용자 권한으로 실행한다는 뜻입니다. 컨테이너 안의 UID 0을 호스트 root와 동일하게 취급하지 않습니다. 다만 해당 사용자의 데이터와 자원을 사용할 수 있고 커널을 공유하므로 VM과 같은 격리라고 생각해서도 안 됩니다. 기본 실행 구조는 Podman 5.4.2 설명서를 참고할 수 있습니다.
| 대상 | 실습 이름 | 교체 시 처리 |
|---|---|---|
| 이미지 | docker.io/library/httpd의 digest | 같은 내용을 다시 실행하는 기준으로 기록합니다. |
| 컨테이너 | lf-web27 | 중지·삭제하고 새로 생성합니다. |
| 명명 볼륨 | lf-web27-data | 컨테이너 교체 중에는 보존하고 새 컨테이너에 연결합니다. |
| 외부 포트 | 127.0.0.1:8080 | Debian VM 내부에서만 접근하며 실행 후 다시 확인합니다. |
패키지와 일반 사용자 실행 환경 확인
sudo 가능한 별도 Debian 13 VM과 이미지 레지스트리에 접근할 네트워크가 필요합니다. 설치만 sudo로 수행하고 이후 podman 명령은 모두 로그인한 일반 사용자로 실행합니다. sudo podman으로 바꾸면 root의 별도 이미지·컨테이너 저장소를 보게 되므로 문제 해결 과정에서도 섞지 않습니다.
sudo apt update
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
id
printf '%s\n' "$XDG_RUNTIME_DIR"
grep "^$(id -un):" /etc/subuid /etc/subgid
systemctl --user is-system-running
podman info --format json
실습에서는 Podman 5.4.2, 일반 사용자 UID/GID 1000, /run/user/1000의 실행 경로를 사용했습니다. /etc/subuid와 /etc/subgid에는 각각 lfstudent:100000:65536이 있었고 사용자 관리자는 running이었습니다. 이 범위는 컨테이너의 추가 사용자 ID를 매핑할 때 사용합니다. 다른 계정의 범위를 복사해 중복 할당하지 않습니다.
podman info의 host.security.rootless는 true, cgroupVersion은 v2, cgroupManager는 systemd, 저장소는 사용자 홈 아래 overlay였습니다. 환경 변수나 사용자 관리자 연결 오류가 나면 실제 일반 사용자 SSH·콘솔 로그인 세션에서 다시 확인합니다. XDG_RUNTIME_DIR를 아무 경로로 꾸미거나 sudo 환경을 억지로 섞어 정상으로 보이게 만들지 않습니다.
이 예제의 이름과 8080 포트가 이미 사용 중이면 기존 자원을 제거하지 않고 실습 이름·포트를 바꿀 계획을 세웁니다. 같은 Bash 터미널에서 다음 준비 블록을 실행하면 뒤의 오류 발생 시 중단하도록 설정됩니다.
set -euo pipefail
if podman container exists lf-web27; then
echo "같은 컨테이너가 있습니다." >&2
exit 1
fi
if podman volume exists lf-web27-data; then
echo "같은 볼륨이 있습니다." >&2
exit 1
fi
if test -e "$HOME/lf-course27-image.txt"; then
echo "이미지 기록 파일이 있습니다." >&2
exit 1
fi
ss -ltn
공식 이미지 출처와 digest 기록하기
짧은 httpd 이름 대신 레지스트리와 네임스페이스가 포함된 주소를 사용합니다. httpd Docker Official Image 안내에서 태그·Dockerfile·웹 루트 경로를 확인하고 선택했습니다. 이 이미지는 Apache HTTP Server의 공식 이미지 배포 경로이며, 호스트의 Nginx와 다른 프로그램을 컨테이너 안에서 실행합니다.
podman pull docker.io/library/httpd:2.4.71-trixie
image=$(podman image inspect docker.io/library/httpd:2.4.71-trixie --format '{{index .RepoDigests 0}}')
case "$image" in
docker.io/library/httpd@sha256:*) ;;
*) echo "예상과 다른 이미지 참조입니다." >&2; exit 1 ;;
esac
printf '%s\n' "$image" | tee "$HOME/lf-course27-image.txt"
podman image inspect "$image" --format '{{.Architecture}} {{.Os}} {{.Id}}'
검증 때 기록한 참조는 다음과 같습니다. 실제 실행에서는 위 inspect로 얻은 값을 사용하며 태그가 변경되면 새 digest가 나올 수 있습니다. 아키텍처는 amd64, 운영체제는 linux였습니다.
docker.io/library/httpd@sha256:32e9403360ab2f1047523e72f256527fb9aee68b342abf6ad03f0d629157f3d9
태그는 다른 이미지로 이동할 수 있지만 digest는 내용 식별에 사용합니다. digest를 기록해도 누가 만든 이미지인지의 검토나 취약점 대응이 자동으로 해결되지는 않습니다. 고정한 이미지는 자동으로 최신 보안 수정으로 바뀌지 않으므로 새 버전 검토·시험·교체 일정을 별도로 운영합니다. pull이 실패하면 레지스트리 인증·요청 제한·DNS·TLS·네트워크 오류를 구분하고 임의의 동명 이미지를 대신 실행하지 않습니다.
전용 볼륨에 파일을 넣고 loopback으로 실행하기
명명 볼륨을 먼저 만든 뒤 일회성 컨테이너로 index.html을 기록합니다. 준비 컨테이너는 네트워크가 필요 없어서 none으로 실행하고 종료 후 --rm으로 제거합니다. 볼륨 자체는 남습니다. 이 볼륨은 새 실습 전용이므로 기존 서비스의 웹 루트를 덮어쓰지 않습니다.
podman volume create lf-web27-data
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF PODMAN 27\n" > /data/index.html'
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
podman ps
podman port lf-web27
curl --noproxy '*' -fsS http://127.0.0.1:8080/
-p의 왼쪽은 호스트 주소·포트, 오른쪽 80은 컨테이너 안 포트입니다. 127.0.0.1을 명시해 VM 내부에서만 받습니다. -v의 끝 :ro는 이 웹 서버에 볼륨을 읽기 전용으로 연결합니다. 다른 컨테이너나 호스트에서도 쓸 수 없게 만드는 전역 설정은 아니므로, 준비 컨테이너가 기록하는 단계와 구분합니다.
실제 포트 출력은 80/tcp → 127.0.0.1:8080이었고 응답은 LF PODMAN 27이었습니다. 시작 직후라면 잠시 후 다시 요청합니다. 계속 실패하면 podman logs lf-web27, podman inspect lf-web27과 포트 충돌을 확인합니다. 컨테이너가 running이라고 HTTP 제공까지 성공한 것은 아닙니다.
컨테이너를 삭제·교체해 데이터 보존 확인하기
다음은 볼륨 파일의 해시를 보관하고 컨테이너의 /tmp에 비교용 파일을 만드는 단계입니다. 볼륨 경로를 읽기 위해 inspect를 사용하지만 Podman 저장소 안의 다른 디렉터리를 직접 수정하지 않습니다. 컨테이너를 중지·삭제한 뒤에도 볼륨의 파일이 같은지 확인합니다.
point=$(podman volume inspect lf-web27-data --format '{{.Mountpoint}}')
hash_before=$(sha256sum "$point/index.html")
podman exec lf-web27 sh -c 'printf "ephemeral\n" > /tmp/lf-web27-marker'
podman stop lf-web27
podman rm lf-web27
test -f "$point/index.html"
test "$hash_before" = "$(sha256sum "$point/index.html")"
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman exec lf-web27 test ! -e /tmp/lf-web27-marker
검증에서는 새 컨테이너의 HTTP 응답이 동일했고 index.html의 해시도 같았습니다. 반면 이전 컨테이너의 /tmp 파일은 새 컨테이너에 없었습니다. 마지막 test는 성공하면 아무것도 출력하지 않고 종료 코드 0을 반환합니다. 이 결과로 볼륨과 컨테이너 쓰기 계층의 수명 차이를 구분할 수 있습니다.
새 컨테이너의 준비가 늦어 curl이 실패하면 실제 상태·로그를 보고 다시 요청합니다. 오류 시 중단하는 셸에서 이후 정리까지 수행한 것으로 생각하지 말고 podman ps -a와 volume ls로 남은 자원을 확인합니다. 볼륨 보존은 백업과 다릅니다. 사용자 홈이나 호스트 디스크를 잃으면 같은 로컬 볼륨도 잃을 수 있습니다.
실행 중 AppArmor 적용 상태 확인하기
AppArmor가 호스트에서 활성화되어 있어도 모든 rootless 컨테이너가 강제 프로파일로 제한된다고 단정하면 안 됩니다. 교체한 컨테이너가 실행 중인 지금, 다음 명령으로 inspect 정보와 실제 프로세스 상태를 대조합니다.
podman info --format json
podman inspect lf-web27 --format '{{.AppArmorProfile}}'
podman exec lf-web27 cat /proc/self/attr/current
이 강좌에서는 첫 컨테이너가 실행 중일 때 확인했습니다. 호스트 AppArmor 모듈은 Y였지만 rootless 정보의 apparmorEnabled는 false, 컨테이너 AppArmorProfile은 비어 있었으며 프로세스 출력은 crun (unconfined)였습니다. 이 결과를 강제 모드의 컨테이너 프로파일 적용으로 해석하지 않습니다. 오류를 피하려고 AppArmor나 seccomp를 끄거나 --privileged를 추가하지 않았습니다.
호스트와 컨테이너의 UID가 다른 이유
rootless 컨테이너의 사용자 이름보다 숫자 ID와 매핑을 확인합니다. 이 실습의 기본 네임스페이스에서는 컨테이너 UID 0이 호스트 1000, UID 1부터 65536개가 호스트 100000부터 대응했습니다. 그룹도 같은 구조였습니다. 다른 계정이나 --userns 옵션에서는 달라질 수 있습니다.
podman unshare cat /proc/self/uid_map /proc/self/gid_map
stat -c '%u:%g' "$point/index.html"
podman unshare stat -c '%u:%g' "$point/index.html"
index.html은 호스트에서 1000:1000, podman unshare 안에서 0:0으로 보였습니다. unshare는 Podman의 사용자 네임스페이스에 들어가 같은 파일을 다른 ID 관점에서 살펴보는 도구이며, 호스트 전체의 root가 되는 명령은 아닙니다. podman unshare 설명서에 범위가 정리되어 있습니다.
추가 비교는 서버를 중지한 뒤 같은 실습 볼륨에 파일 하나를 만들고 컨테이너 UID/GID 33으로 지정합니다. 이 숫자는 매핑 관찰용이며 모든 이미지가 같은 서비스 계정을 쓴다는 뜻은 아닙니다.
podman stop lf-web27
podman rm lf-web27
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "mapped\n" > /data/mapped.txt; chown 33:33 /data/mapped.txt'
stat -c '%u:%g' "$point/mapped.txt"
podman unshare stat -c '%u:%g' "$point/mapped.txt"
실제 결과는 호스트 100032:100032, 네임스페이스 안 33:33이었습니다. 호스트의 숫자 33으로 파일 소유자를 바꾸는 것과 같지 않습니다. 권한 문제를 해결하려고 사용자 홈 전체에 chown을 적용하지 않습니다. :U 옵션은 호스트 쪽 소유권을 재귀 변경할 수 있고 :z·:Z는 SELinux 라벨과 관련되므로 AppArmor 문제의 일반 해결책으로 붙이지 않습니다. 볼륨 옵션은 Podman run의 볼륨·보안 옵션에서 정확한 영향을 확인합니다.
전용 볼륨과 이미지의 정리 범위
이 실습에서 남은 전용 볼륨을 삭제하면 그 데이터도 삭제됩니다. 필요한 파일을 보존할지 먼저 판단한 뒤 정확한 이름 하나만 제거합니다. 명명 볼륨의 생성·관리 범위는 Podman volume create 설명서에서 확인할 수 있습니다.
podman ps -a
podman volume inspect lf-web27-data
podman volume rm lf-web27-data
podman volume ls
ss -ltn
실제 정리에서는 lf-web27 컨테이너와 lf-web27-data 볼륨만 제거했습니다. 받아 둔 이미지와 lf-course27-image.txt의 digest 기록은 보관했으며 다른 이미지·볼륨을 일괄 삭제하는 prune은 사용하지 않았습니다. 지속 데이터와 이미지 재현 정보의 보관 여부를 각각 결정하면 실습 정리와 운영 데이터 삭제를 혼동하지 않을 수 있습니다.




