Debian 13 教程 / 配置systemd定时任务并验证失败与互斥锁
在 Debian 13 中,systemd 定时器设置执行时间,而关联的服务执行实际工作。即使定时器处于活动状态,任务也可能失败,所以您不仅应该检查下一个调度时间,还要检查服务退出代码、日志和生成的结果。
检查文件复制实验的要求
本次练习将普通用户 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
确认定时器未找到,并且其余的练习路径不存在。文件未找到错误是在事先检查时的预期结果。若缺少工具,可用 apt-cache show util-linux coreutils diffutils 查询软件包信息,再通过 APT 安装所需软件包。运行状态与开机启动设置的区别,可参考systemd 服务与 drop-in 实训。
编写一个幂等的文件复制脚本
使用 lfstudent 登录以创建专用原始文件。若目录已存在,下面的 mkdir 会失败,后续 printf 也不会执行。此时请停止练习,先检查现有目录。
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'
这是一个需要保存到文件中的脚本,不能通过粘贴到终端替换当前整个 shell 来执行。保存后,检查执行权限和语法。
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 手册 中查看非阻塞锁和退出行为。
创建 oneshot 服务和间隔定时器
将工作单元保存为 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
由于这是一个短时运行且很快结束的任务,使用 Type=oneshot。因为它需要被重复调用,所以我们不通过 RemainAfterExit=yes 保持其处于活动状态。此服务将由定时器触发,因此无需在服务中添加用于自动启动的 [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
手动执行应报告 Result=success 并且退出状态为 0,同时 cmp 必须成功且无输出。然后,开启定时器。已完成的一次性服务的非活动状态可以是正常结果,因此应同时读取 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
启动请求失败,服务的 Result=exit-code、ExecMainStatus=1。定时器可能仍然处于激活状态,下一个计划也会保留。也就是说,计划仍然存在并不意味着文件复制成功。在练习中,可以确认失败后,之前有效的结果文件仍然完好无损。如果在定时器再次运行之前未恢复原文件,则可能会重复发生相同的失败。
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
恢复原始内容后,通过手动重新执行验证 Result=success、退出状态为 0 以及内容匹配。仅执行 reset-failed 并不能恢复原始文件。在操作中,必须保留日志并监控任务结果,或单独配置失败通知。
测试锁争用并在释放后重试
为了避免与自动调用和比较混淆,首先停止此练习定时器。禁用也会移除此定时器的启动链接。
sudo systemctl disable --now lf-timer18.timer
在终端 A 中,以 lfstudent 登录,临时持有锁。
flock /home/lfstudent/lf-timer18/.lock sleep 20
在终端 B 上以相同用户执行,需在 20 秒内完成。
/usr/local/libexec/lf-timer18.sh
echo $?
Another copy is running 和脚本定义的退出码 75 是预期的。这不是 flock 本身的默认冲突代码,而是脚本区分的一个值。如果在终端 A 上的命令完成后再次运行,它将成功。不要仅因为锁文件仍然存在就判定它被锁定。标准是运行的进程是否正在持有该文件,如果您删除文件以解决冲突,可能会创建一个单独的锁目标,从而允许重复执行。
选择日历定时器或 cron
如果您需要基于日历的时间,比如每天韩国标准时间(KST)凌晨 2 点,而不是用于练习的间隔定时器,可以考虑 OnCalendar。下例沿用原始验证环境的 Asia/Seoul 时区。若需北京时间,请同时将解析命令和后面 OnCalendar 中的 Asia/Seoul 替换为 Asia/Shanghai,再检查解析结果中的下次执行时间。
systemd-analyze calendar '*-*-* 02:00:00 Asia/Seoul'
以下是一个单独的示例,可用于替换现有的定时器文件。 替换间隔设置;不要在日历计划中同时保留 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
如果您选择日历变体,首先停止这个实验定时器,替换其整个文件并运行 sudo systemd-analyze verify /etc/systemd/system/lf-timer18.timer 。如果验证成功,运行 sudo systemctl daemon-reload ,然后 sudo systemctl enable --now lf-timer18.timer 并检查 systemctl list-timers lf-timer18.timer --no-pager 。要返回短时间间隔测试,停止定时器,恢复早先的完整文件,验证,重新加载并重新启动。日历解析在原始实验中已检查;原始实测未验证 Persistent 对错过执行的补跑行为。
Persistent=true 仅对 OnCalendar 生效。若定时器未激活期间错过一次或多次执行时间,重新激活时会触发服务进行补跑。它不会按顺序重新执行所有错过的次数,也不是具有与前一个间隔定时器相同效果的选项。基于日历的任务还需要检查与系统时间和时区的同步。表达规则可以在 systemd.time 文档 中找到。
| 要求 | 判断标准 |
|---|---|
| 对服务账户、依赖关系、退出代码和日志的综合管理 | 考虑 systemd 服务与定时器组合 |
| 维护现有的简单用户特定周期命令 | 检查现有的cron设置、环境变量和输出处理 |
| 在关闭期间补做日历任务 | 检查定时器的 Persistent 设置;不要假设普通cron提供等效的补做行为 |
| 防止同一脚本重复执行 | 对于任何调度工具,也检查其他入口点和锁设计 |
如同 Debian crontab 手册中所述 ,cron 需要分别考虑执行用户、环境以及邮件或输出处理条件。不要在 cron 和 timer 中重复注册相同的任务。比选择工具更重要的是配置一个可以观察实际执行结果和失败情况的环境。
仅删除实验室计划和文件
如果启用了持久化日历变体,在删除其单元文件之前,请停止定时器并运行 sudo systemctl clean --what=state lf-timer18.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
确保两个单元均为 LoadState=not-found,并且文件夹已被删除。如果原始临时名称或其他文件仍然存在于文件夹中,请在处理之前检查内容,不要使用递归删除来绕过该检查。保留共享目录,如 /usr/local/libexec、其他定时器和现有的日志文件。




