Files
deerflow-code/deploy/linux-docker-offline-deerflow-only/release-template/UPDATE_INSTALL.sh
T

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 "$@"