Debian 13 강좌 / systemd timer 정기 작업과 실패 확인

Debian 13에서 systemd timer는 실행 시점을 정하고, 연결된 service가 실제 작업을 수행합니다. 타이머가 active여도 작업은 실패할 수 있으므로 다음 일정뿐 아니라 서비스 종료 코드·로그·생성 결과를 함께 확인해야 합니다.

실습할 정기 작업과 필요한 조건

이번에는 일반 사용자 lfstudent의 전용 폴더에서 텍스트 파일 하나를 결과 파일로 복사합니다. 원본과 결과 내용이 같으면 다시 쓰지 않고, 동시에 다른 실행이 있으면 잠금으로 거부합니다. 여러 시점의 데이터를 보존하는 백업 프로그램은 아니며, 원본이 작업 중 바뀌지 않는 작은 테스트 파일을 대상으로 합니다.

Debian 13의 systemd 257에서 flock·mktemp·cmp를 사용합니다. flock은 파일을 기준으로 프로세스 사이의 배타적 잠금을 잡는 명령입니다. 새 유닛·폴더·스크립트가 이미 있으면 내용을 먼저 확인하고 덮어쓰지 마세요.

id lfstudent
command -v flock mktemp cmp
systemctl show lf-timer18.timer -p LoadState
ls -ld /home/lfstudent/lf-timer18
ls -l /usr/local/libexec/lf-timer18.sh /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer

타이머가 not-found이고 나머지 실습 경로가 없음을 확인합니다. 파일 없음 오류는 사전 확인의 예상 결과입니다. 도구가 없다면 apt-cache show util-linux coreutils diffutils 등으로 패키지를 확인하여 필요한 도구를 설치합니다. 서비스 실행과 자동 시작 연결은 systemd 서비스와 drop-in 실습에서 다룬 구분을 사용합니다.

반복 실행해도 결과가 중복되지 않는 스크립트

lfstudent로 로그인하여 전용 원본을 만듭니다. 같은 폴더가 있으면 아래 명령은 이어서 덮어쓰지 않습니다.

mkdir /home/lfstudent/lf-timer18 &&
printf 'scheduled-copy-v1\n' > /home/lfstudent/lf-timer18/source.txt

관리자 권한으로 스크립트를 저장할 폴더를 준비하고 sudo nano /usr/local/libexec/lf-timer18.sh에서 다음 전체 내용을 작성합니다. nano가 없으면 사용 중인 편집기를 선택하세요.

sudo install -d /usr/local/libexec
#!/bin/sh
set -eu
task_dir=/home/lfstudent/lf-timer18
exec 9>"$task_dir/.lock"
if ! flock -n 9; then
    printf 'Another copy is running\n' >&2
    exit 75
fi
test -r "$task_dir/source.txt"
if test -f "$task_dir/snapshot.txt" && cmp -s "$task_dir/source.txt" "$task_dir/snapshot.txt"; then
    printf 'Snapshot unchanged\n'
    exit 0
fi
task_tmp=$(mktemp "$task_dir/.snapshot.XXXXXX")
trap 'rm -f -- "$task_tmp"' EXIT HUP INT TERM
cat "$task_dir/source.txt" > "$task_tmp"
mv -- "$task_tmp" "$task_dir/snapshot.txt"
printf 'Snapshot updated\n'

이는 파일에 저장할 스크립트이며 터미널에 붙여 넣어 현재 셸 전체를 대체하는 명령으로 실행하지 않습니다. 저장한 뒤 실행 권한과 구문을 확인합니다.

sudo chmod 755 /usr/local/libexec/lf-timer18.sh
sh -n /usr/local/libexec/lf-timer18.sh
ls -l /usr/local/libexec/lf-timer18.sh

관리자 소유의 실행 파일은 일반 사용자가 고치지 못하게 하고, 실제 데이터 폴더는 lfstudent가 씁니다. mktemp로 같은 폴더에 임시 파일을 만들고 복사를 마친 뒤 이름을 바꾸므로, 정상적인 교체 시 독자는 반쯤 쓰인 결과 경로를 읽지 않습니다. 디스크 장애 시 내구성이나 변경 중인 데이터베이스의 일관성까지 보장하는 예제는 아닙니다. 새 결과 파일은 mktemp의 제한된 접근 권한을 이어받습니다.

같은 입력에 재실행해도 결과를 덧붙이지 않는 성질을 멱등성이라고 합니다. 이 스크립트는 내용이 같으면 Snapshot unchanged를 출력하고 종료합니다. 잠금은 같은 파일을 사용하는 협력적인 실행 사이에서만 작동합니다. 다른 프로그램이 원본을 고치는 것까지 막지는 않습니다. flock 설명서에서 비차단 잠금과 종료 동작을 확인할 수 있습니다.

작업 서비스와 실습용 타이머 작성

sudo nano /etc/systemd/system/lf-timer18.service로 작업 유닛을 저장합니다.

[Unit]
Description=Copy one lesson 18 test file

[Service]
Type=oneshot
User=lfstudent
ExecStart=/usr/local/libexec/lf-timer18.sh

짧게 실행하고 끝나는 작업이므로 oneshot을 사용합니다. 반복 호출해야 하므로 RemainAfterExit=yes로 계속 active 상태를 유지시키지 않습니다. 이 서비스는 타이머가 호출할 것이므로 별도의 [Install] 연결을 만들지 않습니다.

sudo nano /etc/systemd/system/lf-timer18.timer에 아래를 저장합니다. 5초·20초는 결과를 빨리 관찰하기 위한 실습 간격이며 운영 주기로 권장하는 값은 아닙니다.

[Unit]
Description=Lesson 18 interval timer

[Timer]
OnActiveSec=5s
OnUnitInactiveSec=20s
AccuracySec=1s
Unit=lf-timer18.service

[Install]
WantedBy=timers.target

타이머 활성화 후 약 5초에 첫 실행을 요청하고, 작업 유닛이 비활성 상태로 들어간 시점에서 약 20초 뒤 다시 실행하도록 구성했습니다. 정확한 실시간 보장 장치는 아니며 부하·정확도 설정 등에 따라 지연될 수 있습니다. 같은 서비스가 실행 중이면 타이머가 별도 서비스 인스턴스를 겹쳐 실행하지 않습니다. 직접 스크립트를 실행하는 다른 진입점까지 고려하여 스크립트 안에도 잠금을 넣었습니다. 일정 옵션은 systemd.timer 설명서를 기준으로 합니다.

sudo systemd-analyze verify /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer
sudo systemctl daemon-reload
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt
sudo systemctl enable --now lf-timer18.timer
systemctl list-timers lf-timer18.timer --no-pager

서비스 수동 실행이 success·종료 코드 0이고 cmp가 출력 없이 성공해야 합니다. 그 뒤 타이머를 켭니다. 실행을 마친 oneshot 서비스의 inactive는 정상 결과일 수 있으므로 Result와 종료 코드를 함께 읽습니다. 타이머에는 다음 실행 예정과 마지막 실행 시각이 표시됩니다.

첫 예정 시각이 지난 뒤 다음을 확인합니다.

systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 20
cat /home/lfstudent/lf-timer18/snapshot.txt
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt

로그의 실행 시각과 Snapshot updated 또는 Snapshot unchanged, 실제 결과를 함께 확인합니다. 이 실습에서는 타이머가 직접 호출해 결과 파일을 만들고, 같은 원본으로 재실행했을 때 변경 없음으로 종료하는 것을 확인했습니다.

작업 실패와 타이머 활성 상태 비교

원본을 지우지 않고 이름만 바꿔 읽기 실패를 만듭니다. 기존 source.saved가 없는지 먼저 확인하세요. 같은 데이터 폴더를 쓰는 다른 작업이 없는 전용 실습에서만 실행합니다.

test ! -e /home/lfstudent/lf-timer18/source.saved &&
mv /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/source.saved
sudo systemctl start lf-timer18.service
systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 12
systemctl list-timers lf-timer18.timer --no-pager

start 요청은 실패하고 작업의 Result는 exit-code, ExecMainStatus는 1로 나타납니다. 타이머는 계속 active일 수 있으며 다음 일정도 남습니다. 즉 예약이 유지된다는 사실은 파일 복사가 성공했다는 뜻이 아닙니다. 실습에서는 실패 후에도 이전 정상 결과 파일이 그대로 남는 것을 확인할 수 있습니다. 타이머가 다시 실행하기 전에 복구하지 않으면 같은 실패가 반복될 수 있습니다.

mv /home/lfstudent/lf-timer18/source.saved /home/lfstudent/lf-timer18/source.txt
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainStatus
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt

원본 복구 후 수동 재실행으로 success·0과 내용 일치를 확인합니다. 단순히 reset-failed를 실행하는 것으로 원본 파일이 되살아나는 것은 아닙니다. 운영에서는 로그를 보관하고 작업 결과를 감시하거나 실패 알림을 별도로 구성해야 합니다.

잠금 충돌과 해제 후 재실행

자동 호출과 비교가 섞이지 않도록 먼저 이 실습 타이머를 중지합니다. disable은 이 타이머의 부팅 연결도 제거합니다.

sudo systemctl disable --now lf-timer18.timer

lfstudent 터미널 A에서 잠금을 잠시 점유합니다.

flock /home/lfstudent/lf-timer18/.lock sleep 20

20초가 지나기 전에 같은 사용자의 터미널 B에서 실행합니다.

/usr/local/libexec/lf-timer18.sh
echo $?

Another copy is running과 스크립트가 정한 종료 코드 75가 예상됩니다. flock 자체의 기본 충돌 코드를 그대로 출력한 것이 아니라 스크립트에서 구분한 값입니다. 터미널 A의 명령이 끝난 뒤 다시 실행하면 성공합니다. 잠금 파일이 남아 있다는 사실만으로 잠금 중이라고 판단하지 마세요. 실행 중인 프로세스가 파일을 잡고 있는지가 기준이며, 충돌을 해결하려고 파일부터 지우면 별도 잠금 대상이 생겨 중복 실행을 허용할 수 있습니다.

달력 일정과 cron을 선택하는 기준

실습의 간격 타이머 대신 매일 한국 시각 오전 2시처럼 달력 기준이 필요하면 OnCalendar를 검토합니다. 표현은 먼저 아래처럼 파싱하여 예상 시각을 확인합니다.

systemd-analyze calendar '*-*-* 02:00:00 Asia/Seoul'

아래는 기존 timer 파일을 교체할 때 사용할 수 있는 별도의 예시입니다. OnActiveSec·OnUnitInactiveSec를 유지한 채 덧붙이지 않습니다. 여러 일정 조건을 함께 쓰면 어느 하나의 조건으로도 호출될 수 있기 때문입니다. 이 강좌의 실제 자동 실행·실패 비교는 앞의 짧은 간격 타이머로 수행했습니다.

[Unit]
Description=Daily lesson 18 file copy

[Timer]
OnCalendar=*-*-* 02:00:00 Asia/Seoul
Persistent=true
Unit=lf-timer18.service

[Install]
WantedBy=timers.target

Persistent=true는 달력 타이머가 비활성 상태인 동안 놓친 실행이 있으면 다시 활성화할 때 작업을 보충 호출하는 데 사용합니다. 놓친 횟수만큼 모든 실행을 차례로 재현하거나, 앞의 간격 타이머에 같은 효과를 주는 옵션은 아닙니다. 달력 기준 작업은 시스템 시각·시간대와 동기화도 확인해야 합니다. 표현 규칙은 systemd.time 설명서에서 확인할 수 있습니다.

필요한 조건 판단 기준
서비스 계정·의존성·종료 코드·journal 통합 관리 systemd service와 timer 조합 검토
기존의 단순한 사용자별 정기 명령 유지 cron 운영 체계와 환경 변수·출력 처리 확인
꺼져 있던 시간의 달력 작업 보충 timer Persistent의 조건 확인; 일반 cron만으로 같은 동작을 가정하지 않음
동일 스크립트의 중복 실행 방지 어느 예약 도구든 다른 진입점과 잠금 설계까지 확인

Debian crontab 설명서처럼 cron은 실행 사용자·환경·메일 또는 출력 처리 조건을 따로 살펴야 합니다. 같은 작업을 cron과 timer 양쪽에 중복 등록하지 마세요. 도구 선택보다 실제 실행 결과와 실패를 관찰할 수 있는 구성이 중요합니다.

전용 예약과 파일 정리

달력 예시를 적용했다면 그 타이머도 정리 대상입니다. 예약을 먼저 중지한 뒤 실행 중인 작업이 끝났는지 확인하고 이번 파일만 제거합니다.

sudo systemctl disable --now lf-timer18.timer
sudo systemctl stop lf-timer18.service
sudo rm -- /etc/systemd/system/lf-timer18.timer /etc/systemd/system/lf-timer18.service /usr/local/libexec/lf-timer18.sh
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt /home/lfstudent/lf-timer18/.lock
rmdir -- /home/lfstudent/lf-timer18
systemctl show lf-timer18.timer -p LoadState
systemctl show lf-timer18.service -p LoadState

두 유닛이 not-found이고 폴더가 제거되었는지 확인합니다. 폴더에 원본의 임시 이름이나 다른 파일이 남았다면 내용을 확인한 후 처리하며 재귀 삭제로 덮지 않습니다. /usr/local/libexec 같은 공용 폴더와 다른 타이머, 기존 journal은 보존합니다.