Debian 13 강좌 / Quadlet 사용자 서비스와 재시작·linger·부팅 확인
Debian 13에서 rootless 컨테이너를 사용자 서비스로 운영하려면 Quadlet 원본을 작성하고 사용자 systemd가 생성한 서비스를 관리합니다. 비정상 종료의 재시작, 명시적인 중지, 로그아웃 후 유지와 부팅 자동 시작은 서로 다른 조건이므로 각각 확인해야 합니다. 이 강좌에서는 별도 웹 컨테이너와 볼륨을 만들고 linger의 원래 값을 보존한 뒤 HTTP 응답까지 검증합니다.
Quadlet 원본과 생성 서비스를 구분하기
Quadlet은 .container 같은 파일을 읽어 systemd 서비스를 생성하는 Podman 기능입니다. 일반 사용자는 보통 ~/.config/containers/systemd에 원본을 두고 systemctl --user로 관리합니다. 생성된 /run/user/UID/systemd/generator 아래 .service를 직접 수정하면 재생성 때 사라지므로 원본을 고칩니다.
이 강좌는 Podman 5.4.2·cgroup v2·systemd 사용자 관리자 환경에서 실행했습니다. Podman 5.4.2 Quadlet 설명서의 지원 키를 기준으로 Image·ContainerName·PublishPort·Volume·Pull을 사용합니다. 더 최신 문서의 키를 그대로 붙여 서비스가 생성되지 않는 문제를 피하려면 설치 버전과 generator 출력을 먼저 확인합니다.
생성 서비스는 일반적인 영구 서비스 파일처럼 systemctl enable로 관리하는 대상이 아닙니다. 원본의 [Install]에 WantedBy=default.target을 넣으면 generator가 사용자 기본 target의 연결을 만듭니다. rootless 원본에 User=를 넣어 계정을 전환하려 하지 말고, 실제 해당 일반 사용자로 작업합니다.
사용자 환경·이미지·전용 볼륨 준비
앞 강좌에서 확인한 일반 사용자 Podman 환경을 사용합니다. 패키지 설치만 sudo로 수행하며 아래 podman·systemctl --user 명령은 일반 사용자로 실행합니다. 8080 포트와 lf-web28 이름은 비어 있어야 합니다. 이번 예제는 앞 강좌 볼륨과 다른 lf-web28-data를 사용합니다.
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
podman info --format json
systemctl --user is-system-running
loginctl show-user "$(id -un)" -p Linger
ss -ltn
새 Bash 터미널에서 다음 준비 블록을 실행합니다. linger는 해당 계정의 사용자 관리자 전체에 적용하므로 다른 사용자 서비스가 있는 계정에서는 유지보수 범위를 먼저 판단합니다. 원래 yes였던 계정을 정리하면서 no로 바꾸지 않도록 원래 값을 따로 보관합니다.
set -euo pipefail
record="$HOME/lf-course28-linger-before.txt"
qdir="$HOME/.config/containers/systemd"
for p in "$record" "$qdir/lf-web28.container"; do
if test -e "$p"; then
echo "이미 존재하는 경로입니다: $p" >&2
exit 1
fi
done
if podman container exists lf-web28; then exit 1; fi
if podman volume exists lf-web28-data; then exit 1; fi
loginctl show-user "$(id -un)" -p Linger --value > "$record"
cat "$record"
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
podman image exists "$image"
podman volume create lf-web28-data
podman run --rm --network none -v lf-web28-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF QUADLET 28\n" > /data/index.html'
mkdir -p "$qdir"
이 실습은 이미지를 미리 가져오고 digest를 사용합니다. 서비스의 Pull=never는 부팅 때 다운로드를 시도하지 않게 하므로 이미지가 로컬에 없으면 시작에 실패합니다. 이미지를 지운 뒤에도 자동으로 복구될 것이라고 생각하지 말고 이미지 보관과 업데이트 절차를 함께 정합니다. 공식 httpd 이미지의 웹 루트는 httpd 이미지 안내에서 확인할 수 있습니다.
전체 Quadlet 작성과 생성 결과 확인
같은 터미널에서 다음 전체 설정을 저장합니다. heredoc의 CONF를 인용하지 않아 앞에서 정한 $image가 실제 digest로 확장됩니다. 이 파일은 해당 사용자의 설정입니다.
cat > "$qdir/lf-web28.container" <<CONF
[Unit]
Description=LF rootless web lab 28
[Container]
Image=$image
ContainerName=lf-web28
PublishPort=127.0.0.1:8080:80
Volume=lf-web28-data:/usr/local/apache2/htdocs:ro
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=180
[Install]
WantedBy=default.target
CONF
| 설정 | 의미 |
|---|---|
| PublishPort=127.0.0.1:8080:80 | VM의 loopback에만 포트를 게시합니다. |
| Volume=...:ro | 웹 데이터 볼륨을 읽기 전용으로 연결합니다. |
| Restart=on-failure | 실패로 종료한 서비스를 다시 시작하도록 systemd에 요청합니다. |
| RestartSec=2 | 재시작 사이에 대기합니다. 반복 실패 제한까지 없애는 설정은 아닙니다. |
| TimeoutStartSec=180 | 서비스 시작 완료 대기 한도를 정합니다. HTTP 준비 상태를 검사하는 설정은 아닙니다. |
| WantedBy=default.target | 사용자 관리자 기본 target에서 시작하도록 generator가 연결합니다. |
새 원본을 읽게 하기 전, 제한된 디렉터리의 generator 출력을 확인하고 daemon-reload를 수행합니다. --dryrun은 생성 내용을 보는 기능으로 컨테이너를 시작하지 않습니다.
QUADLET_UNIT_DIRS="$qdir" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user daemon-reload
systemctl --user cat lf-web28.service
systemctl --user show lf-web28.service -p FragmentPath -p SourcePath
이 VM에서는 SourcePath가 홈의 lf-web28.container, FragmentPath가 /run/user/1000/systemd/generator/lf-web28.service였습니다. 생성 파일에는 Podman 실행·정리 명령과 이미지 digest가 포함됐습니다. 서비스가 없으면 원본 경로·파일 확장자·지원 키·generator 오류를 확인하고, 생성 파일을 손으로 만들어 덮어두지 않습니다.
linger와 시작·응답 상태 확인
linger를 활성화하면 이 사용자의 관리자가 부팅 때 시작되고 로그아웃 후에도 유지될 수 있습니다. Debian loginctl 설명서의 범위대로 사용자 하나의 서비스만을 위한 스위치는 아닙니다. 실습에서는 원래 no였으며 검증 동안만 yes로 바꿨습니다.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
systemctl --user start lf-web28.service
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman port lf-web28
예상 응답은 LF QUADLET 28입니다. active는 생성 서비스가 활성이라는 뜻이며 HTTP 준비 완료와 같지 않습니다. 검증에서도 시작 직후 한 요청이 Empty reply from server로 실패했다가 준비 후 성공했습니다. 실패를 모두 준비 지연으로 치부하지 말고 잠시 뒤 다시 요청하고, 계속 실패하면 다음 로그와 포트·볼륨 상태를 확인합니다.
systemctl --user status lf-web28.service --no-pager
journalctl --user -u lf-web28.service -n 50 --no-pager
podman logs lf-web28
podman inspect lf-web28
비정상 종료와 명시적인 중지 비교
다음 비교는 정적 파일만 제공하는 전용 실습 컨테이너에 한정합니다. 데이터베이스 같은 실제 쓰기 서비스에 강제 종료 시험을 그대로 적용하지 않습니다. 먼저 컨테이너 ID와 재시작 횟수를 기록한 뒤 KILL 신호를 보내 실패 종료를 만듭니다.
first=$(podman inspect lf-web28 --format '{{.Id}}')
systemctl --user show lf-web28.service -p NRestarts
podman kill --signal KILL lf-web28
sleep 3
systemctl --user is-active lf-web28.service
systemctl --user show lf-web28.service -p NRestarts
podman inspect lf-web28 --format '{{.Id}}'
curl --noproxy '*' -fsS http://127.0.0.1:8080/
검증에서는 NRestarts가 증가하고 컨테이너 ID가 바뀐 뒤 HTTP 응답이 다시 성공했습니다. 3초는 확인을 시작하기 위한 예시이며 모든 환경의 복구 시간 보장이 아닙니다. 반복 실패로 제한에 걸리면 journal에서 원인을 고친 뒤 해당 서비스만 reset-failed하고 다시 시작합니다. 재시작 횟수는 관리자 재시작 등으로 초기화될 수 있어 장기 장애 통계로 그대로 사용하지 않습니다.
이제 systemd에 명시적으로 중지를 요청합니다. Restart=on-failure가 있다고 관리자의 stop 요청까지 되돌려 다시 실행하는 것은 아닙니다. 정책의 조건은 systemd 서비스 재시작 설명에 따릅니다.
systemctl --user stop lf-web28.service
sleep 3
if systemctl --user is-active --quiet lf-web28.service; then
echo "명시적으로 중지한 서비스가 활성 상태입니다." >&2
exit 1
fi
systemctl --user show lf-web28.service -p ActiveState
podman ps -a --filter name=lf-web28
systemctl --user start lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
중지 후 결과는 inactive였고 전용 컨테이너도 제거됐습니다. 예제는 활성 상태가 남아 있으면 오류로 중단하고, 정상적으로 멈췄으면 ActiveState=inactive를 확인한 뒤 다시 시작합니다. 시작 직후 응답이 준비되지 않았다면 앞 절의 방식으로 상태와 로그를 확인하고 재요청합니다. 볼륨은 컨테이너 제거와 별개로 남았습니다.
로그인 자체가 시작을 유발하지 않았는지 확인
재부팅 후 같은 사용자로 SSH 로그인한 뒤 서비스가 active인 것만으로 로그인 전 자동 시작을 증명할 수 없습니다. 로그인 과정에서 사용자 관리자가 시작될 수 있기 때문입니다. 이 강좌에서는 사용자 서비스에 의존성을 걸지 않는 root의 읽기 전용 HTTP 프로브를 예약해, 로그인 세션이 없는 시점의 응답과 세션 목록을 기록했습니다.
같은 방식으로 확인하려면 아래 전용 경로가 모두 없는지 확인한 뒤 root 관리용 프로브를 준비할 수 있습니다. 다른 서버의 기존 타이머·로그를 바꾸지 않습니다. 코드가 root로 실행되더라도 HTTP 요청과 세션 조회만 수행하며 user@1000.service 같은 의존성을 추가하지 않습니다.
for p in /var/backups/lf-debian13-28 /usr/local/sbin/lf-boot28-probe /etc/systemd/system/lf-boot28-probe.service /etc/systemd/system/lf-boot28-probe.timer; do
if test -e "$p"; then echo "이미 존재합니다: $p" >&2; exit 1; fi
done
sudo install -d -m 700 /var/backups/lf-debian13-28
sudo tee /usr/local/sbin/lf-boot28-probe > /dev/null <<'PROBE'
#!/bin/bash
set -euo pipefail
label=${1:-boot}
case "$label" in boot|logout) ;; *) exit 1;; esac
dest="/var/backups/lf-debian13-28/$label-$(cat /proc/sys/kernel/random/boot_id).txt"
{
date -u --iso-8601=seconds
cat /proc/uptime
loginctl list-sessions --no-legend
for i in $(seq 1 15); do
if curl --noproxy '*' --max-time 2 -fsS http://127.0.0.1:8080/ | grep -Fx 'LF QUADLET 28'; then echo HTTP_PROBE_PASSED; exit 0; fi
sleep 1
done
exit 1
} > "$dest" 2>&1
PROBE
sudo chmod 700 /usr/local/sbin/lf-boot28-probe
sudo tee /etc/systemd/system/lf-boot28-probe.service > /dev/null <<'UNIT'
[Unit]
Description=Read-only HTTP evidence before user login for lab 28
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-boot28-probe boot
UNIT
sudo tee /etc/systemd/system/lf-boot28-probe.timer > /dev/null <<'TIMER'
[Unit]
Description=One boot HTTP evidence for lab 28
[Timer]
OnBootSec=35s
AccuracySec=1s
Unit=lf-boot28-probe.service
[Install]
WantedBy=timers.target
TIMER
sudo systemctl daemon-reload
sudo systemctl enable lf-boot28-probe.timer
먼저 로그아웃 후 유지 여부를 시험합니다. 아래 예약이 성공하면 모든 해당 사용자 로그인 세션을 종료하고, 20초 이상 기다린 뒤 다시 로그인해 기록을 읽습니다. 예약한 직후 세션을 계속 열어 두면 로그아웃 검증이 아닙니다. 같은 이름의 transient unit이 남아 있다면 기존 상태를 확인하고 중복 실행하지 않습니다.
sudo systemd-run --unit=lf-logout28-probe --on-active=15s --timer-property=AccuracySec=1s /usr/local/sbin/lf-boot28-probe logout
다시 로그인한 후 다음 명령으로 프로브의 시각·세션 목록·HTTP_PROBE_PASSED를 확인합니다. manager 클래스의 사용자 관리자 세션과 user 클래스의 실제 로그인 세션을 구분합니다. 프로브가 실행된 시점에 다른 user 세션이 있었다면 로그아웃 후 유지의 증거로 쓰지 않습니다.
sudo cat "/var/backups/lf-debian13-28/logout-$(cat /proc/sys/kernel/random/boot_id).txt"
sudo systemctl show lf-logout28-probe.service -p Result -p ExecMainStatus
다음은 콘솔 접근과 작업 중인 다른 서비스의 영향을 확인한 뒤 VM을 정상 재부팅하는 단계입니다. 시작 전 boot ID를 적어 두고, 재부팅 후에는 50초 이상 해당 사용자로 로그인하지 않은 상태를 유지합니다. 타이머가 실행되기 전 접속하면 결과를 혼동할 수 있으므로 기록 시각과 실제 로그인 시각도 대조합니다.
cat /proc/sys/kernel/random/boot_id
sudo systemctl reboot
다시 로그인한 뒤 새 boot ID가 이전과 다른지 확인하고, 해당 부팅의 기록을 읽습니다. 로그가 없거나 실패했다면 자동 시작 성공으로 처리하지 않습니다.
cat /proc/sys/kernel/random/boot_id
sudo cat "/var/backups/lf-debian13-28/boot-$(cat /proc/sys/kernel/random/boot_id).txt"
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
검증 VM에서는 새 부팅 약 46초 시점에 manager 세션만 존재하고 상태가 lingering일 때 HTTP가 성공했습니다. 별도의 로그아웃 시험도 실제 user 세션이 없는 시점에 성공했습니다. 초기 기본 시간 허용 오차의 예약은 확인용 재로그인과 겹쳐 증거로 사용하지 않았으며, AccuracySec=1s를 명시해 다시 확인했습니다. 정확한 실행 시각보다 로그인 전 결과가 남았는지가 판단 기준입니다.
원본·볼륨·linger를 구분해 정리하기
중지하면 이번 실행은 멈추지만 [Install]이 있는 원본이 남아 있으면 다음 사용자 관리자 시작 때 다시 올라올 수 있습니다. 실습을 제거하려면 해당 원본을 지우고 daemon-reload해 생성된 연결까지 정리합니다. 아래 첫 블록은 일반 사용자로 실행합니다.
systemctl --user stop lf-web28.service
rm -- "$HOME/.config/containers/systemd/lf-web28.container"
systemctl --user daemon-reload
podman ps -a --filter name=lf-web28
podman volume rm lf-web28-data
볼륨 삭제는 데이터 삭제이므로 필요한 내용은 먼저 보관합니다. 이어서 실습용 시스템 타이머·스크립트만 제거합니다. 증거 기록은 root 전용 백업 경로에 남겨 둘 수 있습니다.
sudo systemctl disable --now lf-boot28-probe.timer
sudo rm -- /etc/systemd/system/lf-boot28-probe.timer /etc/systemd/system/lf-boot28-probe.service /usr/local/sbin/lf-boot28-probe
sudo systemctl daemon-reload
original_linger=$(cat "$HOME/lf-course28-linger-before.txt")
case "$original_linger" in
no) sudo loginctl disable-linger "$(id -un)" ;;
yes) echo "원래 활성 상태를 유지합니다." ;;
*) echo "원래 linger 값을 확인할 수 없습니다." >&2; exit 1 ;;
esac
loginctl show-user "$(id -un)" -p Linger
ss -ltn
실제 정리에서는 전용 원본·생성 서비스·컨테이너·볼륨·프로브가 제거됐고 8080 리스너가 닫혔으며 linger는 원래 no로 돌아갔습니다. 기존 이미지와 다른 서비스는 보존했습니다. 일반 사용자 서비스를 지속 실행할지 결정할 때는 계정 수명과 데이터 보관, 업데이트·복원 절차까지 함께 관리합니다.




