156 lines
6.0 KiB
Bash
156 lines
6.0 KiB
Bash
#!/usr/bin/env bash
|
|
set -Eeuo pipefail
|
|
|
|
BUNDLE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
BACKUP_ROOT="$BUNDLE_DIR/data/updates/backups"
|
|
HISTORY_FILE="$BUNDLE_DIR/data/updates/history.log"
|
|
|
|
say() { printf '\n[%s] %s\n' "$(date '+%F %T')" "$*"; }
|
|
die() { printf '错误: %s\n' "$*" >&2; exit 1; }
|
|
|
|
usage() {
|
|
cat <<'EOF'
|
|
用法:
|
|
./UPDATE_INSTALL.sh --apply /path/to/deerflow-update-目录
|
|
./UPDATE_INSTALL.sh --apply /path/to/deerflow-update-目录 --no-start
|
|
./UPDATE_INSTALL.sh --rollback /本部署目录/data/updates/backups/备份目录名
|
|
|
|
更新包必须先解压。脚本不会覆盖 config/deploy.env、data/state、业务数据卷、
|
|
自定义智能体、custom 技能或本地知识文件。
|
|
EOF
|
|
}
|
|
|
|
current_release() {
|
|
sed -n 's/^[[:space:]]*"release":[[:space:]]*"\([^"]*\)".*/\1/p' \
|
|
"$BUNDLE_DIR/VERSION.json" | head -n 1
|
|
}
|
|
|
|
read_manifest() {
|
|
local manifest="$1" key value
|
|
FORMAT_VERSION=""
|
|
BASE_RELEASE=""
|
|
TARGET_RELEASE=""
|
|
TARGET_BACKEND_IMAGE=""
|
|
TARGET_FRONTEND_IMAGE=""
|
|
while IFS='=' read -r key value; do
|
|
[[ -z "$key" || "$key" == \#* ]] && continue
|
|
case "$key" in
|
|
FORMAT_VERSION|BASE_RELEASE|TARGET_RELEASE|TARGET_BACKEND_IMAGE|TARGET_FRONTEND_IMAGE) ;;
|
|
*) die "UPDATE_MANIFEST.env 含未知字段: $key" ;;
|
|
esac
|
|
[[ "$value" =~ ^[A-Za-z0-9._:/,-]+$ ]] || die "更新清单字段 $key 含非法字符"
|
|
printf -v "$key" '%s' "$value"
|
|
done < "$manifest"
|
|
[[ "$FORMAT_VERSION" == "1" ]] || die "不支持的增量包格式: $FORMAT_VERSION"
|
|
[[ -n "$BASE_RELEASE" && -n "$TARGET_RELEASE" ]] || die "更新清单缺少版本字段"
|
|
[[ -n "$TARGET_BACKEND_IMAGE" && -n "$TARGET_FRONTEND_IMAGE" ]] || die "更新清单缺少镜像字段"
|
|
}
|
|
|
|
validate_payload() {
|
|
local payload="$1" path relative
|
|
[[ -d "$payload" ]] || die "更新包缺少 payload 目录"
|
|
if find "$payload" -type l -print -quit | grep -q .; then
|
|
die "payload 不允许包含符号链接"
|
|
fi
|
|
while IFS= read -r -d '' path; do
|
|
relative="${path#"$payload"/}"
|
|
case "$relative" in
|
|
OFFLINE_INSTALL.sh|UPDATE_INSTALL.sh|README_OFFLINE.md|VERSION.json|\
|
|
compose/*|scripts/*|docs/*|config/deerflow/*|config/frontend/*|\
|
|
config/deploy.env.example|config/deploy.env.additions.example|\
|
|
images/deerflow-image-list.txt) ;;
|
|
*) die "更新包试图写入受保护路径: $relative" ;;
|
|
esac
|
|
done < <(find "$payload" -type f -print0)
|
|
}
|
|
|
|
backup_controls() {
|
|
local current="$1" target="$2" backup
|
|
backup="$BACKUP_ROOT/${current}_before_${target}_$(date +%Y%m%d-%H%M%S)"
|
|
mkdir -p "$backup"
|
|
tar -C "$BUNDLE_DIR" -czf "$backup/control-files.tar.gz" \
|
|
VERSION.json README_OFFLINE.md OFFLINE_INSTALL.sh UPDATE_INSTALL.sh \
|
|
compose scripts docs config/deploy.env.example config/deerflow config/frontend \
|
|
images/deerflow-image-list.txt
|
|
cp -a "$BUNDLE_DIR/config/deploy.env" "$backup/deploy.env.snapshot"
|
|
printf '%s\n' "$backup"
|
|
}
|
|
|
|
apply_update() {
|
|
local update_dir="$1" start_after="$2" current backup image_archive
|
|
update_dir="$(realpath "$update_dir")"
|
|
[[ -d "$update_dir" ]] || die "更新目录不存在: $update_dir"
|
|
[[ -f "$update_dir/UPDATE_MANIFEST.env" ]] || die "缺少 UPDATE_MANIFEST.env"
|
|
[[ -f "$update_dir/SHA256SUMS" ]] || die "缺少 SHA256SUMS"
|
|
read_manifest "$update_dir/UPDATE_MANIFEST.env"
|
|
current="$(current_release)"
|
|
[[ "$current" == "$BASE_RELEASE" ]] || die "当前版本 $current 与更新包基线 $BASE_RELEASE 不一致"
|
|
|
|
say "校验增量更新包"
|
|
(cd "$update_dir" && sha256sum -c SHA256SUMS)
|
|
validate_payload "$update_dir/payload"
|
|
backup="$(backup_controls "$current" "$TARGET_RELEASE")"
|
|
say "控制文件备份:$backup"
|
|
|
|
"$BUNDLE_DIR/OFFLINE_INSTALL.sh" --stop
|
|
image_archive="$update_dir/images/update-images-linux-amd64.tar.gz"
|
|
if [[ -f "$image_archive" ]]; then
|
|
say "加载本次变更镜像;保留原镜像用于回退"
|
|
gzip -dc "$image_archive" | docker load
|
|
fi
|
|
docker image inspect "$TARGET_BACKEND_IMAGE" "$TARGET_FRONTEND_IMAGE" >/dev/null \
|
|
|| die "目标镜像不完整"
|
|
|
|
say "应用白名单内的控制文件;保留 deploy.env 和业务数据"
|
|
cp -a "$update_dir/payload/." "$BUNDLE_DIR/"
|
|
chmod 0755 "$BUNDLE_DIR/OFFLINE_INSTALL.sh" "$BUNDLE_DIR/UPDATE_INSTALL.sh"
|
|
find "$BUNDLE_DIR/scripts" -maxdepth 1 -type f -name '*.py' -exec chmod 0755 {} +
|
|
grep -Fq "$TARGET_BACKEND_IMAGE" "$BUNDLE_DIR/VERSION.json" || die "VERSION.json 后端镜像不匹配"
|
|
grep -Fq "$TARGET_FRONTEND_IMAGE" "$BUNDLE_DIR/VERSION.json" || die "VERSION.json 前端镜像不匹配"
|
|
printf '%s APPLY %s -> %s backup=%s\n' "$(date --iso-8601=seconds)" "$current" "$TARGET_RELEASE" "$backup" \
|
|
>> "$HISTORY_FILE"
|
|
|
|
if [[ "$start_after" == "true" ]]; then
|
|
"$BUNDLE_DIR/OFFLINE_INSTALL.sh" --start
|
|
else
|
|
say "增量更新已应用但未启动;确认后执行 ./OFFLINE_INSTALL.sh --start"
|
|
fi
|
|
}
|
|
|
|
rollback_update() {
|
|
local backup="$1" resolved current previous
|
|
resolved="$(realpath "$backup")"
|
|
case "$resolved" in
|
|
"$BACKUP_ROOT"/*) ;;
|
|
*) die "只能回退本部署目录 data/updates/backups 下的备份" ;;
|
|
esac
|
|
[[ -f "$resolved/control-files.tar.gz" ]] || die "备份不完整: $resolved"
|
|
current="$(current_release)"
|
|
"$BUNDLE_DIR/OFFLINE_INSTALL.sh" --stop
|
|
tar -xzf "$resolved/control-files.tar.gz" -C "$BUNDLE_DIR"
|
|
previous="$(current_release)"
|
|
printf '%s ROLLBACK %s -> %s source=%s\n' "$(date --iso-8601=seconds)" "$current" "$previous" "$resolved" \
|
|
>> "$HISTORY_FILE"
|
|
say "控制文件和旧镜像引用已恢复;正在启动旧版本"
|
|
"$BUNDLE_DIR/OFFLINE_INSTALL.sh" --start
|
|
}
|
|
|
|
main() {
|
|
mkdir -p "$BACKUP_ROOT"
|
|
case "${1:-}" in
|
|
--apply)
|
|
[[ $# -ge 2 && $# -le 3 ]] || { usage; exit 2; }
|
|
[[ "${3:-}" == "" || "${3:-}" == "--no-start" ]] || die "未知参数: ${3:-}"
|
|
apply_update "$2" "$([[ "${3:-}" == "--no-start" ]] && echo false || echo true)"
|
|
;;
|
|
--rollback)
|
|
[[ $# -eq 2 ]] || { usage; exit 2; }
|
|
rollback_update "$2"
|
|
;;
|
|
--help|-h|"") usage ;;
|
|
*) usage; die "未知参数: $1" ;;
|
|
esac
|
|
}
|
|
|
|
main "$@"
|