Linux systemd路径触发任务如何配置?Path单元、服务依赖与重复触发怎么验证

发布人:A5数据发布时间:2026-10-23 09:49阅读量:78

systemd 的路径触发由 .path 单元负责监视文件或目录,再通过 Unit= 启动对应的 .service 单元。首次部署时,建议把“待处理目录非空”作为触发条件,把服务设置为一次性任务,并让处理程序在一次运行中扫描并处理目录内的全部文件,这样既能验证路径触发,也能观察服务依赖和重复触发行为。

正文开篇配图

下面以 Debian、Ubuntu、Rocky Linux、AlmaLinux 等使用 systemd 作为 PID 1 的 Linux 系统为例,创建一个文件到达后自动处理的示例。示例目录为 /opt/path-trigger,服务账户为 pathtrigger,处理逻辑是把待处理文件移动到 processed 目录,并记录每次服务执行结果。

对于需要持续接收文件并由后台服务自动处理的业务,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖常规建站、数据库、接口服务及多任务运行场景,并配备SSD或NVMe存储、不同内存规格和多样带宽线路,为基于Linux systemd的文件处理、日志记录与批量任务部署提供服务器基础。

准备条件与触发方式选择

检查运行环境

需要使用 root 或具备 sudo 权限的账号执行安装和配置命令。先确认系统确实由 systemd 管理:

ps -p 1 -o pid,comm,args
systemd --version
command -v systemctl

预期结果中,PID 1 的进程名称通常为 systemd,并且可以看到 systemd 版本。例如:

    PID COMMAND         COMMAND
      1 systemd         /sbin/init
systemd 252 (252.22-1~deb12u1)

如果 PID 1 不是 systemd,systemctl enable 和 .path 单元不会按本文方式工作。容器、精简镜像或采用其他初始化系统的环境,需要先确认是否启用了 systemd。

选择 Path 单元的触发条件

常见路径指令及适用场景如下:

指令触发含义适用场景
PathChanged=监视路径发生修改,文件或目录元数据变化时触发关注某个文件或目录本身的变化
PathModified=监视文件被写入需要关注文件内容写入,但要注意写入过程可能产生多次事件
DirectoryNotEmpty=目录中存在至少一个目录项时触发文件队列、上传目录、待处理目录
Unit=指定路径事件发生后启动的服务单元将 .path 与目标 .service 关联

本例选择 DirectoryNotEmpty=,原因是文件队列的目标通常是“目录中出现待处理文件”。生产者应先把文件写入临时目录,写完后使用同一文件系统内的 mv 移入 inbox 目录,避免服务读到尚未写完的文件。

不要同时为同一个队列配置多个相近的路径条件,也不要让处理服务把结果写回被监视的 inbox 目录,否则容易产生额外的触发事件。

创建运行目录和服务账户

创建专用账户

如果系统中尚未存在 pathtrigger 用户和用户组,可以执行:

getent group pathtrigger >/dev/null || groupadd --system pathtrigger
getent passwd pathtrigger >/dev/null || useradd \
  --system \
  --gid pathtrigger \
  --home-dir /nonexistent \
  --shell /usr/sbin/nologin \
  pathtrigger

如果同名账户已经存在,应先检查其 UID、主组和用途,不要直接修改已有业务账户的主组。也可以将下面配置中的 User= 和 Group= 换成已经准备好的专用账号。

检查账户:

id pathtrigger
getent passwd pathtrigger

创建目录并设置权限

本例使用以下目录:

  • staging:生产者写入临时文件的目录;
  • inbox:文件写完后移入,作为 Path 单元监视目录;
  • processed:服务处理完成后的文件目录;
  • run.log:记录服务每次执行的结果。

执行:

install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/staging
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/inbox
install -d -o pathtrigger -g pathtrigger -m 0750 /opt/path-trigger/processed

检查目录权限:

namei -l /opt/path-trigger/inbox
ls -ld /opt/path-trigger /opt/path-trigger/staging \
  /opt/path-trigger/inbox /opt/path-trigger/processed

预期结果是这些目录存在,并且服务账户至少对 inbox 和 processed 具有读取、写入和移动文件所需的权限。

如果实际生产者不是 root 或 pathtrigger,不要直接将目录改为 0777。应根据生产者账户加入受控用户组,并单独验证该账户是否可以写入 staging、移动文件到 inbox。

创建一次性处理服务

编写处理脚本

先创建脚本目录:

install -d -o root -g root -m 0755 /usr/local/libexec

写入处理脚本:

cat >/usr/local/libexec/path-trigger-worker <<'EOF'
#!/usr/bin/env bash
set -Eeuo pipefail

inbox="/opt/path-trigger/inbox"
processed_dir="/opt/path-trigger/processed"
log_file="/opt/path-trigger/run.log"

processed_count=0

while IFS= read -r -d '' item; do
    filename="${item##*/}"

    mv -- "$item" "$processed_dir/$filename"

    processed_count=$((processed_count + 1))
done < <(find "$inbox" -maxdepth 1 -type f -print0)

message="$(date --iso-8601=seconds) processed=${processed_count} invocation=${INVOCATION_ID:-unknown}"
printf '%s\n' "$message" | tee -a "$log_file"
EOF

chown root:root /usr/local/libexec/path-trigger-worker
chmod 0755 /usr/local/libexec/path-trigger-worker

脚本使用 find -print0 处理带空格的文件名,并在一次服务执行中扫描 inbox 内的普通文件。mv 成功后,文件才会从待处理目录消失。

检查脚本语法:

bash -n /usr/local/libexec/path-trigger-worker

没有输出表示 Bash 语法检查通过。此时可以先用服务账户检查目录访问权限,但不要在正式测试前手动执行脚本,否则会提前移动待处理文件:

runuser -u pathtrigger -- test -r /opt/path-trigger/inbox
runuser -u pathtrigger -- test -w /opt/path-trigger/inbox
runuser -u pathtrigger -- test -w /opt/path-trigger/processed

创建 Service 单元

写入 /etc/systemd/system/path-trigger.service:

[Unit]
Description=Process files from the path trigger inbox
After=local-fs.target
RequiresMountsFor=/opt/path-trigger

[Service]
Type=oneshot
User=pathtrigger
Group=pathtrigger
WorkingDirectory=/opt/path-trigger
ExecStart=/usr/local/libexec/path-trigger-worker
UMask=0027
NoNewPrivileges=yes
PrivateTmp=yes

这里有几个关键点:

  • Type=oneshot 表示每次触发启动一个处理任务,任务完成后退出;
  • 不配置 RemainAfterExit=yes,否则服务完成后会保持 active (exited),后续路径事件可能无法再次启动已经处于 active 状态的服务;
  • User= 和 Group= 限制处理程序权限,避免因文件处理逻辑被修改而直接以 root 身份运行;
  • RequiresMountsFor= 会为 /opt/path-trigger 所在的挂载点建立必要依赖,适合该目录位于独立数据盘或其他挂载文件系统的场景;
  • 服务不设置 [Install],因为它不是开机常驻服务,而是由 .path 单元按事件触发。

创建 Path 单元

写入 /etc/systemd/system/path-trigger.path:

[Unit]
Description=Watch the path trigger inbox
After=local-fs.target
RequiresMountsFor=/opt/path-trigger/inbox

[Path]
DirectoryNotEmpty=/opt/path-trigger/inbox
Unit=path-trigger.service

[Install]
WantedBy=multi-user.target

Unit=path-trigger.service 是路径事件和服务执行之间的关联。它表示当 inbox 满足 DirectoryNotEmpty= 条件时,systemd 尝试启动 path-trigger.service。

这里的 Unit= 不等同于 Requires=。它负责指定“触发哪个单元”,而不是表示 .path 和 .service 始终绑定运行。路径单元本身应该保持 active 并持续等待,服务单元则在触发后运行,成功完成后回到 inactive 状态。

校验单元文件

在重新加载 systemd 前先检查配置:

systemd-analyze verify \
  /etc/systemd/system/path-trigger.service \
  /etc/systemd/system/path-trigger.path

没有输出通常表示没有发现语法和依赖引用错误。若出现 Executable path is not absolute、User not found 或文件不存在等提示,应先修正对应路径、账户或权限。

加载配置并启动路径监视

重新加载并设置开机启动

执行:

systemctl daemon-reload
systemctl enable --now path-trigger.path

enable 会创建开机启动关系,--now 会立即启动路径单元。检查状态:

systemctl is-enabled path-trigger.path
systemctl is-active path-trigger.path
systemctl status path-trigger.path --no-pager

预期结果类似:

enabled
active

状态中的 active (waiting) 是正常结果,表示 Path 单元正在等待目录事件,并不是服务已经执行完成。

同时检查 systemd 解析到的关联关系:

systemctl show path-trigger.path \
  -p FragmentPath \
  -p Unit \
  -p ActiveState \
  -p SubState

systemctl cat path-trigger.path
systemctl cat path-trigger.service

预期可以看到:

Unit=path-trigger.service
ActiveState=active
SubState=waiting

如果启用前 inbox 中已经有文件,Path 单元启动后可能立即触发服务。首次部署前应确认该目录没有尚未决定是否处理的历史文件,否则历史文件可能被当成首次测试数据移动到 processed。

首次触发测试

使用临时目录和原子移动

不要直接把内容长时间写入 inbox 中的最终文件名。先写入 staging,完成后再移动到 inbox:

首次触发测试 / 使用临时目录和原子移动配图

tag=$(date +%s)
tmp="/opt/path-trigger/staging/.single-${tag}.part"
target="/opt/path-trigger/inbox/single-${tag}.data"

printf 'first path trigger test: %s\n' "$tag" > "$tmp"
chmod 0644 "$tmp"
mv -- "$tmp" "$target"

staging 和 inbox 都位于 /opt/path-trigger 下,通常属于同一文件系统,因此 mv 可以在同一文件系统内完成原子重命名。执行移动时,inbox 从空变为非空,Path 单元应启动服务。

等待一两秒后检查服务:

systemctl status path-trigger.service --no-pager
journalctl -u path-trigger.service -n 20 --no-pager

成功的 oneshot 服务通常会显示 inactive (dead),这不是失败,而是任务已完成并退出。日志中应能看到类似内容:

2025-01-01T10:20:30+08:00 processed=1 invocation=...

检查文件是否已经移动:

find /opt/path-trigger/inbox -maxdepth 1 -type f -printf '%f\n'
find /opt/path-trigger/processed -maxdepth 1 -type f -printf '%f\n'
tail -n 5 /opt/path-trigger/run.log

预期结果:

  • inbox 中不再有刚才的测试文件;
  • processed 中出现 single-<时间戳>.data;
  • run.log 新增一行 processed=1;
  • systemctl status path-trigger.path 仍为 active、waiting;
  • path-trigger.service 的结果为成功,而不是 failed。

也可以直接检查服务的最终结果:

systemctl show path-trigger.service \
  -p Type \
  -p User \
  -p ActiveState \
  -p SubState \
  -p Result

预期关键字段为:

Type=oneshot
User=pathtrigger
ActiveState=inactive
SubState=dead
Result=success

验证服务依赖和重复触发

验证多个文件是否都能处理

批量创建三个文件,观察一次或多次触发是否都能处理完整:

tag=$(date +%s)

for i in 1 2 3; do
    tmp="/opt/path-trigger/staging/.batch-${tag}-${i}.part"
    target="/opt/path-trigger/inbox/batch-${tag}-${i}.data"

    printf 'batch file %s-%s\n' "$tag" "$i" > "$tmp"
    chmod 0644 "$tmp"
    mv -- "$tmp" "$target"
done

等待任务结束:

for i in $(seq 1 20); do
    if ! find /opt/path-trigger/inbox -maxdepth 1 -type f | grep -q .; then
        break
    fi
    sleep 1
done

grep "batch-${tag}-" /opt/path-trigger/run.log || true
find /opt/path-trigger/processed -maxdepth 1 -type f \
  -name "batch-${tag}-*" -printf '%f\n' | sort

预期在 processed 中看到三个文件,每个文件只出现一次。服务启动次数不一定固定为三次:如果三个文件在同一时间进入目录,systemd 可能合并触发请求,由一次服务执行处理三个文件;如果文件分批到达,则可能启动多次服务。验收重点应是“每个输入文件只被处理一次”,而不是强行要求每个文件对应一次服务进程。

验证服务依赖和重复触发 / 验证多个文件是否都能处理配图

验证单个文件是否产生重复服务执行

使用唯一文件名进行单次测试:

tag=$(date +%s)
start_time=$(date --iso-8601=seconds)

tmp="/opt/path-trigger/staging/.duplicate-${tag}.part"
target="/opt/path-trigger/inbox/duplicate-${tag}.data"

printf 'duplicate check: %s\n' "$tag" > "$tmp"
chmod 0644 "$tmp"
mv -- "$tmp" "$target"

sleep 2

journalctl -u path-trigger.service \
  --since "$start_time" \
  --no-pager \
  -o cat

grep "duplicate-${tag}.data" /opt/path-trigger/run.log | wc -l

正常情况下,最后的计数为:

1

日志中可能出现一行:

processed=1 invocation=...

如果同一次测试中出现第二次服务启动,但第二次显示 processed=0,说明出现了额外的服务激活请求,不过文件本身没有被重复处理。这种情况需要进一步检查是否同时配置了 PathChanged=、PathModified= 或服务内部又修改了被监视目录。

如果同一个文件名在 run.log 中出现两次,应检查处理脚本是否把文件复制后又重新放回了 inbox,以及 processed 目录是否被其他程序清空或移动文件。

检查 .path 与 .service 的关系

执行:

systemctl show path-trigger.path \
  -p Unit \
  -p ActiveState \
  -p SubState

systemctl show path-trigger.service \
  -p Type \
  -p User \
  -p ActiveState \
  -p SubState \
  -p Result

systemd-analyze critical-chain path-trigger.path

判断方式如下:

  • .path 为 active、waiting:表示路径监视仍在工作;
  • .service 为 inactive、dead 且 Result=success:表示一次性任务已成功完成;
  • .service 为 failed:表示脚本、权限、目录或文件处理过程出现错误;
  • .path 为 failed:表示路径表达式、被监视目录、挂载关系或单元配置存在问题。

不要因为服务在处理结束后显示 inactive 就重新执行 systemctl start path-trigger.service。对于事件驱动任务,这是正常生命周期。真正需要保持 active 的是 .path 单元。

常见异常处理

Path 单元 active,但服务没有运行

先确认 Unit= 是否指向正确的服务:

systemctl show path-trigger.path -p Unit
systemctl cat path-trigger.path

再检查目录是否真的出现了普通文件:

find /opt/path-trigger/inbox -maxdepth 1 -printf '%y %p\n'

如果生产者只写入了目录、软链接或隐藏的临时文件,需要确认这些文件是否符合处理脚本的 find -type f 条件。建议使用“临时目录写入,完成后移动到 inbox”的方式。

还可以手动重新生成一个唯一测试文件,并查看路径单元日志:

journalctl -u path-trigger.path -b --no-pager

服务启动后失败

查看服务状态和本次启动日志:

systemctl status path-trigger.service --no-pager
journalctl -u path-trigger.service -b -n 100 --no-pager

重点检查:

  • /usr/local/libexec/path-trigger-worker 是否存在且可执行;
  • pathtrigger 是否可以读取 inbox 中的文件;
  • pathtrigger 是否可以写入 processed 和 run.log;
  • processed 中是否已经存在同名文件;
  • 生产者是否创建了权限过严的文件,例如只有 root 可读的 0600 文件。

可以使用以下命令检查路径上的每一级权限:

namei -l /opt/path-trigger/inbox
namei -l /opt/path-trigger/processed
ls -l /opt/path-trigger/inbox /opt/path-trigger/processed

如需手动复现,应使用专门的测试文件,并注意手动执行脚本也会移动文件:

runuser -u pathtrigger -- /usr/local/libexec/path-trigger-worker

重复触发过多

优先检查以下配置和行为:

  1. 是否同时使用了 DirectoryNotEmpty=、PathChanged= 和 PathModified=;
  2. 是否将文件直接写入 inbox,导致文件每次写入都产生事件;
  3. 处理服务是否会向被监视目录写入日志、临时文件或处理结果;
  4. Service 单元是否错误配置了 RemainAfterExit=yes;
  5. 是否有其他程序重复复制或移动相同文件。

文件队列通常只保留:

[Path]
DirectoryNotEmpty=/opt/path-trigger/inbox
Unit=path-trigger.service

如果业务必须监视单个文件的写入,可以单独使用 PathChanged= 或 PathModified=,同时让生产者采用临时文件加原子重命名,避免把“文件尚未写完”误判成“文件已经可以处理”。

修改单元后没有生效

修改 /etc/systemd/system/path-trigger.path 或 .service 后,必须重新加载配置:

systemctl daemon-reload
systemctl restart path-trigger.path

如果只修改了处理脚本,不需要 daemon-reload,但新进程启动时才会读取脚本内容。修改服务运行账户、ExecStart 或路径条件后,建议同时执行:

systemd-analyze verify \
  /etc/systemd/system/path-trigger.service \
  /etc/systemd/system/path-trigger.path

systemctl restart path-trigger.path

部署结果检查

首次运行完成后,可以按以下项目验收:

  • systemd --version 可正常返回,且 PID 1 为 systemd;
  • path-trigger.path 已通过 systemctl enable 设置为开机启动;
  • systemctl is-active path-trigger.path 返回 active;
  • Path 单元状态为 waiting,正在持续监视目录;
  • .path 单元中的 Unit= 明确指向 path-trigger.service;
  • path-trigger.service 使用专用账户运行,而不是 root;
  • 测试文件从 staging 写完后移动到 inbox,能够触发服务;
  • 处理后 inbox 不再保留该文件,processed 出现对应文件;
  • run.log 中每个测试文件只记录一次;
  • 服务成功完成后显示 inactive (dead) 且 Result=success;
  • 快速提交多个文件时,所有文件都能被处理,不要求每个文件必须启动一个独立服务进程;
  • 未配置 RemainAfterExit=yes,也未把处理结果写回被监视目录;
  • 重启系统后,path-trigger.path 仍能自动进入 active 状态。

如果需要验证开机持久化,可以在业务允许的维护窗口执行重启。重启前应确认 inbox 中没有不允许自动处理的文件,并保存当前配置:

mkdir -p /root/path-trigger-config-backup
cp -a /etc/systemd/system/path-trigger.path \
  /etc/systemd/system/path-trigger.service \
  /root/path-trigger-config-backup/

回滚与停用

回滚前先明确影响范围:停止 Path 单元后,不会再接收新的路径触发;如果同时停止正在运行的 Service,当前文件处理可能被中断。inbox、processed 和 run.log 属于业务数据,回滚时不要直接删除。

先备份当前单元和处理脚本:

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

cp -a /etc/systemd/system/path-trigger.path "$backup_dir/"
cp -a /etc/systemd/system/path-trigger.service "$backup_dir/"
cp -a /usr/local/libexec/path-trigger-worker "$backup_dir/"

停止路径监视:

systemctl disable --now path-trigger.path

如果确认需要立即中断正在执行的任务,再执行:

systemctl stop path-trigger.service

将新增配置移出 systemd 搜索路径,而不是直接删除:

mv /etc/systemd/system/path-trigger.path \
  "$backup_dir/path-trigger.path.disabled"

mv /etc/systemd/system/path-trigger.service \
  "$backup_dir/path-trigger.service.disabled"

mv /usr/local/libexec/path-trigger-worker \
  "$backup_dir/path-trigger-worker.disabled"

systemctl daemon-reload
systemctl reset-failed path-trigger.path path-trigger.service

完成后检查:

systemctl is-enabled path-trigger.path
systemctl is-active path-trigger.path

如果需要恢复,使用回滚目录中的原文件复制回对应路径,再重新加载并启动:

cp -a "$backup_dir/path-trigger.path.disabled" \
  /etc/systemd/system/path-trigger.path

cp -a "$backup_dir/path-trigger.service.disabled" \
  /etc/systemd/system/path-trigger.service

cp -a "$backup_dir/path-trigger-worker.disabled" \
  /usr/local/libexec/path-trigger-worker

chmod 0755 /usr/local/libexec/path-trigger-worker

systemctl daemon-reload
systemctl enable --now path-trigger.path

恢复后,应重新执行一次唯一文件测试,并同时检查 Path 单元状态、Service 执行结果、处理目录和日志记录,确认回滚没有改变文件权限或触发关系。

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

相关推荐