Linux 与服务器运维 / 系统课时

把重复执行设计成幂等动作

把重复执行设计成幂等动作

自动化脚本一旦进入重试、定时执行或故障恢复流程,同一个动作就可能被执行多次。本课把“重复执行不会产生额外副作用”落实到 Shell:先比较目标状态,只在确有变化时修改,并用临时文件加原子替换避免留下半成品。

学习目标

  • 判断一个运维动作是否具备幂等性,并识别常见重复副作用
  • 使用状态比较实现“无变化则不修改”,让脚本可以安全重试
  • 使用同文件系统内的临时文件与重命名降低配置写坏风险

先定义脚本最终想要的状态

幂等并不是“命令执行两次不报错”,而是执行一次或执行多次后,系统最终状态相同。例如“确保目录存在”可以使用 mkdir -p;“确保配置内容等于指定值”则应先生成期望内容,再与现有文件比较,而不是每次都直接追加。

最典型的反例是无条件使用 >>。如果脚本每次运行都执行 echo 'server=10.0.0.8' >> app.conf,重试三次就会得到三行相同配置。类似问题还会出现在重复创建用户、重复插入防火墙规则、重复注册定时任务和重复发送通知等场景。

幂等自动化中的状态比较与安全替换流程

用状态比较避免无意义修改

下面的脚本维护一个配置文件。它先在目标文件所在目录创建临时文件,再通过 cmp -s 比较期望内容与当前内容;完全一致时立即退出,因此不会反复修改文件时间,也不会触发依赖文件变更的发布或重载逻辑。

bash
#!/usr/bin/env bash
set -euo pipefail

target="${1:-/tmp/anystack-idempotent/app.conf}"
target_dir="$(dirname "$target")"
mkdir -p "$target_dir"

tmp="$(mktemp "${target}.tmp.XXXXXX")"
trap 'rm -f "$tmp"' EXIT

# 先生成完整期望状态,不直接修改正式文件。
cat >"$tmp" <<'EOF'
mode=production
workers=4
EOF

if [[ -f "$target" ]] && cmp -s "$tmp" "$target"; then
  echo "UNCHANGED: $target"
  exit 0
fi

chmod 0644 "$tmp"
# 临时文件与目标文件位于同一目录,rename 可在常见本地文件系统中原子完成。
mv -f "$tmp" "$target"
trap - EXIT

echo "UPDATED: $target"

保存为 ensure-config.sh 后连续执行两次:

bash
chmod +x ./ensure-config.sh
./ensure-config.sh
./ensure-config.sh
cat /tmp/anystack-idempotent/app.conf

预期输出:

text
UPDATED: /tmp/anystack-idempotent/app.conf
UNCHANGED: /tmp/anystack-idempotent/app.conf
mode=production
workers=4

第一次运行创建目标状态,第二次运行发现状态已经满足要求,因此不再写入。这比“先删除旧文件再创建新文件”更适合自动化恢复,因为脚本在无变化时不会制造新的副作用。

原子替换解决写到一半的问题

直接执行 cat > "$target" 会先截断正式文件。如果进程在写入过程中被终止,目标文件可能只剩一部分内容。更稳妥的方式是先写临时文件,完成内容和权限准备后再用 mv 替换。

这里有一个重要边界:临时文件应放在目标文件所在文件系统。跨文件系统移动可能退化为复制加删除,不能再把它视为单次原子重命名。对于关键配置,还可以在 mv 前增加语法检查,例如 Nginx 配置先执行 nginx -t,JSON 文件先用解析器验证,再替换正式文件。

给不可逆副作用增加明确条件

文件、目录和配置通常容易通过当前状态判断是否需要修改,但发邮件、扣费、重启服务、调用外部发布接口这类动作一旦执行就产生外部副作用。此时应把“动作是否已经完成”持久化为可检查状态,或者使用目标系统提供的幂等能力。

例如脚本更新配置后,不要无条件执行 systemctl restart app;只有配置真正发生变化,并且校验成功时才重载服务。这样失败重试时,如果配置已经正确落盘,脚本就不会再次触发不必要的重启。

判断一个动作能否安全重试时,可以依次问三个问题:当前状态能否读取、期望状态能否明确比较、修改是否能在失败时避免留下半完成结果。把这三点做好,重试才会从“再赌一次”变成可靠的恢复机制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把重复执行设计成幂等动作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通