Linux systemd如何用路径单元触发任务,文件变化条件怎样配置验证

发布人:A5数据发布时间:2026-10-27 11:54阅读量:105

在 Debian 12、Ubuntu 22.04/24.04 等以 systemd 为 PID 1 的 Linux 环境中,不需要额外安装独立的“路径监控程序”,即可使用 systemd.path 单元监听文件或目录事件。路径单元通常与同名的 .service 单元配合:.path 负责等待变化,.service 负责执行任务。

准备条件与触发条件选择配图

文件内容写入、文件替换、目录中新建或删除条目,适合使用的条件并不相同。首次部署时,建议先用 PathChanged= 完成单个配置文件的触发验证,再根据实际场景选择 PathModified=、PathExists= 或 DirectoryNotEmpty=,避免因为条件含义不匹配造成不触发或重复执行。

systemd 路径单元适合承接配置文件变化、目录投递等自动化任务;任务实际执行时,服务器的 CPU、内存与存储资源也会影响其运行环境。A5数据提供香港、美国、日本等地区的物理服务器,涵盖 Xeon Gold 与 AMD EPYC 平台,并有 SSD 或 NVMe 存储方案,可为业务后台、数据库及文件处理任务提供部署资源。不同地区和产品系列配有不同网络线路与硬件配置,支持按业务部署区域和任务资源需求组合选择。

准备条件与触发条件选择

确认系统环境

以下示例以 root shell 执行,适用于 Debian/Ubuntu 系列系统。先进入 root shell:

sudo -i

检查 PID 1、systemd 版本和系统信息:

cat /etc/os-release
ps -p 1 -o pid,comm,args
systemd --version | head -n 1
command -v systemctl

预期结果中,ps 的 COMMAND 或 COMM 应为 systemd,并且能够找到 /usr/bin/systemctl。如果 PID 1 是其他进程,通常说明当前位于没有完整 init 系统的容器或受限环境,后续 systemctl enable --now 不能按本示例工作。

systemd.path 已经是 systemd 的内置单元类型,不需要单独安装软件包。还需要准备以下条件:

  • 具有创建 /etc/systemd/system/ 单元文件的权限。
  • 被监听的路径位于本机可正常产生文件系统事件的文件系统上。
  • 触发任务使用绝对路径调用,不能依赖交互式 shell 的环境变量。
  • 触发脚本能够重复执行,或者具备明确的幂等处理逻辑。
  • 计划使用的 .path 和 .service 名称没有被现有业务占用。

检查示例单元是否已经存在:

systemctl cat path-demo-config.path 2>/dev/null || true
systemctl cat path-demo-config.service 2>/dev/null || true

如果命令返回了现有业务配置,不要直接覆盖。应先停止后续操作,并根据现有配置制作备份。下面的 path-demo-* 名称仅用于本次演示。

按文件变化类型选择条件

systemd.path 关注的是文件系统事件或路径状态,不会比较文件内容是否真的发生了业务层面的变化。常用条件如下:

配置项触发依据适用场景注意事项
PathChanged=路径发生变化配置文件写入、保存、替换;目录中新建或删除条目监听目录时不会递归监听所有子文件内容
PathModified=路径被写入或修改需要响应写操作的文件某些编辑器采用临时文件替换时,优先考虑 PathChanged=
PathExists=路径存在文件出现后执行一次处理文件一直存在时,路径单元启动可能立即触发服务
PathExistsGlob=通配路径匹配到文件监听 <em>.ready、</em>.done 等标记文件这是存在性条件,不是文件内容变化条件
DirectoryNotEmpty=目录中存在至少一个条目文件投递目录、待处理队列目录任务必须消费、移动或删除条目,否则可能反复触发

本示例监听单个配置文件:

[Path]
PathChanged=/etc/path-demo/app.conf
Unit=path-demo-config.service

如果任务必须响应文件的写操作,可以将其替换为:

[Path]
PathModified=/etc/path-demo/app.conf
Unit=path-demo-config.service

同一个路径不建议为了“保险”同时配置 PathChanged= 和 PathModified=,否则一次保存可能对应多次事件。多个路径条件通常是任意一个条件发生变化就会触发服务,并不是自动形成“所有条件同时满足”的 AND 逻辑。

创建示例任务

创建运行用户和测试目录

本示例的触发任务只读取 /etc/path-demo/app.conf,并把执行结果写入 /var/lib/path-demo/last-run。使用独立系统用户可以避免让实际任务默认以 root 身份运行。

如果系统中没有 pathdemo 用户,则创建该用户:

if ! id -u pathdemo >/dev/null 2>&1; then
    useradd --system --user-group --no-create-home \
        --shell /usr/sbin/nologin pathdemo
fi

创建配置目录和状态目录:

install -d -m 0755 /etc/path-demo
install -d -o pathdemo -g pathdemo -m 0750 /var/lib/path-demo

下面命令会创建一个新的示例配置文件。为避免覆盖已有文件,如果文件已经存在,命令会退出:

if [ -e /etc/path-demo/app.conf ]; then
    echo "文件已存在,请先确认是否为本次示例文件:/etc/path-demo/app.conf"
    exit 1
fi

printf '%s\n' 'mode=demo' 'source=systemd.path' > /etc/path-demo/app.conf
chown root:pathdemo /etc/path-demo/app.conf
chmod 0640 /etc/path-demo/app.conf

验证文件权限和内容:

ls -l /etc/path-demo/app.conf
cat /etc/path-demo/app.conf

预期结果类似:

-rw-r----- 1 root pathdemo ... /etc/path-demo/app.conf
mode=demo
source=systemd.path

编写触发脚本

创建脚本目录和任务脚本:

install -d -m 0755 /usr/local/libexec

cat > /usr/local/libexec/path-demo-run.sh <<'EOF'
#!/bin/sh
set -eu

config='/etc/path-demo/app.conf'
state_dir='/var/lib/path-demo'
state_file="${state_dir}/last-run"

if [ ! -r "$config" ]; then
    echo "cannot read $config" >&2
    exit 1
fi

checksum=$(sha256sum "$config" | awk '{print $1}')
timestamp=$(date -u '+%Y-%m-%dT%H:%M:%SZ')
tmp_file=$(mktemp "${state_dir}/last-run.XXXXXX")

trap 'rm -f -- "$tmp_file"' EXIT HUP INT TERM

{
    printf 'run_at=%s\n' "$timestamp"
    printf 'sha256=%s\n' "$checksum"
} > "$tmp_file"

chmod 0640 "$tmp_file"
mv -f -- "$tmp_file" "$state_file"

trap - EXIT HUP INT TERM
printf 'processed %s\n' "$config"
EOF

chown root:root /usr/local/libexec/path-demo-run.sh
chmod 0755 /usr/local/libexec/path-demo-run.sh

脚本的实际业务动作可以替换为配置校验、缓存刷新、文件转换或其他本地任务。需要保留以下约束:

  • ExecStart= 调用的脚本路径必须是绝对路径。
  • 脚本成功时返回 0,失败时返回非零值。
  • 输出文件不要放在被监听的路径中,否则脚本自身可能再次制造触发事件。
  • 如果一次事件可能重复到达,任务应能安全重复执行。

先手动运行脚本,验证路径、权限和依赖命令:

runuser -u pathdemo -- /usr/local/libexec/path-demo-run.sh
cat /var/lib/path-demo/last-run

预期能看到类似内容:

processed /etc/path-demo/app.conf
run_at=2025-01-01T12:00:00Z
sha256=...

这里的时间和摘要仅是示例格式,实际值会随执行时间和文件内容变化。

创建 service 和 path 单元

创建一次性服务单元

path-demo-config.service 负责执行任务,不需要设置 WantedBy=,因为它不是随系统常驻启动,而是由路径单元按事件拉起。

cat > /etc/systemd/system/path-demo-config.service <<'EOF'
[Unit]
Description=Process the configuration after it changes
After=local-fs.target

[Service]
Type=oneshot
User=pathdemo
Group=pathdemo
ExecStart=/usr/local/libexec/path-demo-run.sh
EOF

这里使用 Type=oneshot,并且没有配置 RemainAfterExit=yes。任务成功退出后,服务会回到 inactive 状态,下一次路径事件才能再次启动它。

如果设置了 RemainAfterExit=yes,服务完成后会保持 active,后续路径变化可能无法再次执行同一个服务。除非任务本身是长期运行进程,否则不应随意添加该配置。

创建路径单元

cat > /etc/systemd/system/path-demo-config.path <<'EOF'
[Unit]
Description=Watch the demo configuration file

[Path]
PathChanged=/etc/path-demo/app.conf
Unit=path-demo-config.service

[Install]
WantedBy=multi-user.target
EOF

Unit= 明确指定路径变化后启动的服务。由于两个单元名称相同,去掉 Unit= 时 systemd 通常也会根据 path-demo-config.path 推导出 path-demo-config.service,但显式写出可以减少重命名或拆分配置时的误解。

路径单元本身不执行命令,因此不能把 ExecStart= 放到 .path 文件中。执行动作必须放在 .service 单元。

检查单元语法

在加载到 systemd 前,先检查单元文件和脚本路径:

systemd-analyze verify \
    /etc/systemd/system/path-demo-config.path \
    /etc/systemd/system/path-demo-config.service

没有输出通常表示基础语法检查通过。若出现 Failed to resolve user、Executable path is not absolute 或文件不存在等提示,应先修复,再执行重新加载。

重新加载单元配置:

systemctl daemon-reload

查看 systemd 当前读取到的内容:

systemctl cat path-demo-config.path
systemctl cat path-demo-config.service

预期应分别看到 PathChanged=/etc/path-demo/app.conf、Unit=path-demo-config.service 和正确的 ExecStart= 路径。

启动路径监听并验证触发

启用开机监听

执行以下命令,使路径单元立即启动并在系统启动时自动启动:

systemctl enable --now path-demo-config.path

检查状态:

systemctl is-enabled path-demo-config.path
systemctl is-active path-demo-config.path
systemctl status path-demo-config.path --no-pager

预期结果:

enabled
active

状态详情中通常会出现类似 active (waiting) 的信息,表示路径单元正在等待事件。此时 path-demo-config.service 不一定处于 active,这是正常的,因为服务只在路径变化后执行。

可以进一步查看服务结果:

systemctl show path-demo-config.service \
    -p ActiveState -p SubState -p Result -p ExecMainStatus

如果刚才已经手动运行过脚本,服务的历史结果可能显示为 Result=success 和 ExecMainStatus=0。Type=oneshot 服务执行完成后显示 inactive,并不代表失败。

修改文件验证 PathChanged

用一次写入并关闭文件的操作制造变化:

printf '\n# trigger-%s\n' "$(date -u '+%Y-%m-%dT%H:%M:%SZ')" \
    >> /etc/path-demo/app.conf

等待一秒左右,再查看两个单元的日志:

sleep 1
journalctl -u path-demo-config.path \
           -u path-demo-config.service \
           -n 30 --no-pager

不同 systemd 版本的日志文字会有差异,重点检查是否同时出现以下过程:

  1. path-demo-config.path 检测到路径事件。
  2. path-demo-config.service 被启动。
  3. 脚本输出 processed /etc/path-demo/app.conf。
  4. 服务以状态码 0 完成。

验证任务写出的状态文件:

cat /var/lib/path-demo/last-run
stat /var/lib/path-demo/last-run

如果 run_at 和 sha256 已更新,说明路径监听、服务调度和脚本执行链路均已打通。

验证原子替换场景

很多编辑器不会直接写入原文件,而是先写临时文件,再通过 rename 替换原文件。可以使用下面的方式模拟该行为。执行前先备份测试文件,避免误替换重要内容:

cp -a /etc/path-demo/app.conf \
    "/root/path-demo-app.conf.before-atomic-test"

tmp_file=$(mktemp /etc/path-demo/app.conf.XXXXXX)
cat /etc/path-demo/app.conf > "$tmp_file"
printf '%s\n' '# atomic-replace-test' >> "$tmp_file"
chown root:pathdemo "$tmp_file"
chmod 0640 "$tmp_file"
mv -f "$tmp_file" /etc/path-demo/app.conf

再次查看日志:

sleep 1
journalctl -u path-demo-config.service -n 15 --no-pager

PathChanged=通常适合这种“临时文件写入后替换原文件”的保存方式。如果改成 PathModified=后发现普通追加能够触发,但编辑器保存替换不能稳定触发,应回到 PathChanged=,或者根据具体编辑器行为增加对实际被写入路径的监听。

其他文件变化条件的配置方式

监听目录中新建或删除文件

如果任务关心的是目录中新建或删除条目,可以把路径条件改为目录:

[Path]
PathChanged=/srv/path-demo/inbox
Unit=path-demo-config.service

此时监听的是目录条目变化,不是目录下每个文件的内容变化。向 /srv/path-demo/inbox/a.txt 写入内容,并不等同于目录本身发生了新建或删除事件。

如果需要处理新到达文件,任务应当把文件移动到已处理目录、重命名为其他后缀,或删除处理完成的文件。否则使用 DirectoryNotEmpty= 时,目录一直处于非空状态,服务退出后可能再次被立即拉起。

监听标记文件是否出现

例如只有出现 .ready 文件时才执行任务:

[Path]
PathExistsGlob=/srv/path-demo/inbox/*.ready
Unit=path-demo-config.service

这种配置判断的是“是否存在匹配文件”,不是“匹配文件内容是否变化”。如果 .ready 文件处理后仍然保留,路径单元再次启动或重新加载时仍可能认为条件已经满足。实际任务通常会在成功处理后将其移动到归档目录。

监听目录非空状态

[Path]
DirectoryNotEmpty=/srv/path-demo/inbox
Unit=path-demo-config.service

该条件适合简单的文件投递队列,但服务必须负责消费队列。例如,任务应遍历目录,将已处理文件移动到 /srv/path-demo/done/,而不是只读取后原地保留。

对于文件量较大、要求每个文件都不能漏处理的场景,单纯的 .path 单元不是完整队列系统。路径事件可能在服务运行期间合并,不能把“一次事件”理解为“一个文件对应一次可靠任务记录”。这类场景应在服务中扫描并记录处理状态,或者使用具备持久队列能力的业务组件。

常见失败处理

路径单元 active,但修改文件后没有服务日志

先确认实际修改的路径与单元中的路径完全一致:

systemctl cat path-demo-config.path
readlink -f /etc/path-demo/app.conf
ls -l /etc/path-demo/app.conf

然后确认路径单元仍处于等待状态:

systemctl status path-demo-config.path --no-pager

如果状态不是 active (waiting),重新加载并重启路径单元:

systemctl daemon-reload
systemctl restart path-demo-config.path

常见原因包括:

  • 修改的是临时文件,而不是单元实际监听的文件。
  • 修改单元文件后只执行了 daemon-reload,但没有重启已经运行的路径单元。
  • 监听的是目录,却期待目录下任意文件内容变化都触发。
  • 文件位于某些远程、特殊或容器映射文件系统,文件事件没有按预期传递。
  • 使用 PathExists= 或 PathExistsGlob=,但实际需要的是内容变化,应改用 PathChanged=。

路径事件出现,但 service 启动失败

查看服务状态和日志:

systemctl status path-demo-config.service --no-pager
journalctl -u path-demo-config.service -b -n 50 --no-pager

以服务用户身份检查读取权限:

runuser -u pathdemo -- test -r /etc/path-demo/app.conf
echo $?

返回 0 表示可读。还要检查脚本是否存在且可执行:

ls -l /usr/local/libexec/path-demo-run.sh
runuser -u pathdemo -- /usr/local/libexec/path-demo-run.sh

如果服务失败后需要重新观察下一次执行,可以清除失败状态:

systemctl reset-failed path-demo-config.service

这不会自动修复脚本错误,只是清除 failed 标记,便于后续验证。

修改一次却执行多次

路径事件可能由编辑器的多步保存动作产生,也可能是脚本自身写回了被监听文件。检查脚本是否修改了 /etc/path-demo/app.conf 或其所在目录:

grep -nE '/etc/path-demo/app\.conf|/etc/path-demo' \
    /usr/local/libexec/path-demo-run.sh

处理方式通常是:

  • 将任务输出放到被监听路径之外。
  • 对编辑器原子替换场景使用 PathChanged=。
  • 让脚本通过临时文件写入结果,并保证结果文件不在监听目录。
  • 对高频变化增加业务层去重或延迟处理逻辑。
  • 不要同时启用多个含义相近的路径条件。

如果服务仍在运行时又发生事件,systemd 不会为每次事件无限创建并发实例。事件可能被合并,因此任务本身不应假设每一次写操作都会对应一次独立进程。

验收与回滚检查项

验收清单

部署完成后,按以下项目检查:

  • ps -p 1 -o comm= 返回 systemd。
  • systemd-analyze verify 检查 .path 和 .service 没有语法错误。
  • systemctl is-enabled path-demo-config.path 返回 enabled。
  • systemctl is-active path-demo-config.path 返回 active。
  • systemctl status path-demo-config.path 显示等待路径事件。
  • 修改 /etc/path-demo/app.conf 后,journalctl -u path-demo-config.service 能看到一次新的执行记录。
  • /var/lib/path-demo/last-run 的执行时间和摘要发生更新。
  • 服务失败时,能够从 journal 中看到具体的权限、路径或脚本错误。
  • 实际业务任务没有把输出写回被监听路径,且重复执行不会破坏已有数据。

回滚前的影响范围

停止路径单元会立即停止自动触发,但不会中止已经由 service 启动的外部业务进程,除非该业务本身由该 service 管理。删除示例目录还可能删除任务状态或测试配置,因此回滚前应先备份需要保留的文件。

如果这些单元和目录确实是本次新建内容,可以执行:

backup_dir="/root/path-demo-rollback-$(date -u '+%Y%m%d-%H%M%S')"
install -d -m 0700 "$backup_dir"

cp -a /etc/systemd/system/path-demo-config.path "$backup_dir/"
cp -a /etc/systemd/system/path-demo-config.service "$backup_dir/"
cp -a /usr/local/libexec/path-demo-run.sh "$backup_dir/"
cp -a /etc/path-demo "$backup_dir/"
cp -a /var/lib/path-demo "$backup_dir/"

停止并禁用路径监听:

systemctl disable --now path-demo-config.path
systemctl reset-failed path-demo-config.service || true

确认监听已停止:

systemctl is-active path-demo-config.path || true
systemctl is-enabled path-demo-config.path || true

仅在确认这些文件没有被其他业务使用时,删除本次创建的单元和脚本:

rm -f /etc/systemd/system/path-demo-config.path
rm -f /etc/systemd/system/path-demo-config.service
rm -f /usr/local/libexec/path-demo-run.sh
systemctl daemon-reload

/etc/path-demo 和 /var/lib/path-demo 不建议在首次回滚时直接删除。它们可能包含测试记录或需要恢复的配置,应先根据备份确认内容,再选择保留、归档或删除。如果原先已经存在同名单元,回滚时不能执行上述删除操作,应从回滚前备份中恢复原文件,然后执行:

systemctl daemon-reload
systemctl enable --now 原有的路径单元名称.path

这样可以在停止自动触发的同时,避免误删原有服务配置或业务数据。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6025.html

相关推荐