SHA256
forked from course-team/tjhlp-gitea
原 ansible/ 方案从未在任何环境验证过, 且与本机实际状态严重不符(硬编码
amd64 二进制、会覆盖生产 /etc/gitea/app.ini、会启动 firewalld 切断其它
服务、建的库名与现网不一致); 加上宿主机 Rocky 8 的系统 Python 无法升级,
新版 ansible 也跑不起来。改为 Docker Compose。
新增 deploy/:
- compose.yaml 版本锁定; Gitea 只发布 127.0.0.1:2080(Apache 反代无需
改动), PostgreSQL 不发布端口; 配置全部由
GITEA__section__KEY 环境变量注入; 数据用 bind mount
- db/Dockerfile 官方 postgres 只生成 en_US.UTF-8, 这里补 zh_CN.UTF-8,
与现有集群 collation 保持一致
- scripts/ backup.sh(pg_dump + 数据 tar + SHA256SUMS)、
restore.sh(默认 dry-run, 校验后还原, 拒收宿主布局备份)、
verify.sh(容器健康 + 回环 API + 经 Apache 反代)
文档 deploy/README.md 以 部署/备份/恢复/升级 四条流程为主线, 并记录本机
踩过的四个陷阱: PG18 挂载点、s6 chown 守卫、APP_NAME 只能走裸变量、
HTTP 代理导致的假 502。
一次性迁移脚本(install-docker / configure-docker-proxy / preflight /
migrate-from-binary)已清理, 相应步骤内联进文档。
实测: 源 116 表 → 目标 116 表, /api/healthz 200, 经 Apache /QA 200,
站点名与 OIDC 登录源注册正常。
89 lines
2.9 KiB
Bash
Executable File
89 lines
2.9 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# =============================================================================
|
|
# 备份正在运行的 Docker 栈 (PostgreSQL + Gitea 数据)
|
|
#
|
|
# ./backup.sh # 在线备份(不中断服务)
|
|
# ./backup.sh --quiesce # 先停 gitea 容器再备份, 得到一致快照
|
|
#
|
|
# 产物: deploy/backups/<时间戳>/
|
|
# postgres-<db>.dump pg_dump 自定义格式
|
|
# gitea-data.tar.gz GITEA_DATA_DIR 全量打包
|
|
# MANIFEST.txt 版本/大小/时间
|
|
# SHA256SUMS 校验和
|
|
# =============================================================================
|
|
set -euo pipefail
|
|
|
|
DEPLOY_DIR=$(cd "$(dirname "$0")/.." && pwd)
|
|
cd "$DEPLOY_DIR"
|
|
|
|
QUIESCE=0
|
|
case "${1:-}" in
|
|
--quiesce) QUIESCE=1 ;;
|
|
-h|--help) sed -n '2,14p' "$0"; exit 0 ;;
|
|
"") ;;
|
|
*) echo "未知参数: $1" >&2; exit 2 ;;
|
|
esac
|
|
|
|
[[ -f .env ]] || { echo "错误: 缺少 .env" >&2; exit 1; }
|
|
|
|
# 逐行读取 .env, 不做 shell 展开($$ 还原为 $)
|
|
while IFS= read -r line || [[ -n "$line" ]]; do
|
|
[[ "$line" =~ ^[[:space:]]*(#|$) ]] && continue
|
|
key=${line%%=*}; val=${line#*=}
|
|
key=${key//[[:space:]]/}
|
|
[[ "$val" == \"*\" || "$val" == \'*\' ]] && val=${val:1:-1}
|
|
val=${val//\$\$/\$}
|
|
export "${key}=${val}"
|
|
done < .env
|
|
|
|
: "${POSTGRES_DB:?}"; : "${POSTGRES_USER:?}"; : "${GITEA_DATA_DIR:?}"
|
|
|
|
if ! docker compose ps --status running --format '{{.Service}}' 2>/dev/null | grep -q '^db$'; then
|
|
echo "错误: db 容器未运行, 先 docker compose up -d" >&2
|
|
exit 1
|
|
fi
|
|
|
|
STAMP=$(date +%Y%m%d-%H%M%S)
|
|
OUT="${BACKUP_DIR:-$DEPLOY_DIR/backups}/$STAMP"
|
|
mkdir -p "$OUT"
|
|
|
|
echo "==> 备份目录: $OUT"
|
|
|
|
if [[ ${QUIESCE} -eq 1 ]]; then
|
|
echo "==> 暂停 gitea 容器以保证数据一致"
|
|
docker compose stop gitea
|
|
fi
|
|
|
|
echo "==> pg_dump ${POSTGRES_DB}"
|
|
docker compose exec -T db pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc \
|
|
> "$OUT/postgres-${POSTGRES_DB}.dump"
|
|
|
|
echo "==> 打包 Gitea 数据目录 ${GITEA_DATA_DIR}"
|
|
tar -C "$(dirname "$GITEA_DATA_DIR")" -czf "$OUT/gitea-data.tar.gz" "$(basename "$GITEA_DATA_DIR")"
|
|
|
|
if [[ ${QUIESCE} -eq 1 ]]; then
|
|
echo "==> 恢复 gitea 容器"
|
|
docker compose start gitea
|
|
fi
|
|
|
|
{
|
|
echo "created_at: $(date -Is)"
|
|
echo "hostname: $(hostname)"
|
|
echo "gitea_image: $(docker compose config --format json 2>/dev/null | grep -o '"image"[^,]*' | head -1 || true)"
|
|
echo "postgres_db: ${POSTGRES_DB}"
|
|
echo "gitea_data_dir: ${GITEA_DATA_DIR}"
|
|
echo "quiesced: ${QUIESCE}"
|
|
echo
|
|
du -h "$OUT"/* 2>/dev/null || true
|
|
} > "$OUT/MANIFEST.txt"
|
|
|
|
( cd "$OUT" && sha256sum ./* > SHA256SUMS )
|
|
|
|
echo "==> 完成"
|
|
cat "$OUT/MANIFEST.txt"
|
|
echo
|
|
echo "恢复数据库:"
|
|
echo " docker compose exec -T db pg_restore -U ${POSTGRES_USER} -d ${POSTGRES_DB} --clean --if-exists < $OUT/postgres-${POSTGRES_DB}.dump"
|
|
echo "恢复数据目录:"
|
|
echo " docker compose stop gitea && tar -C $(dirname "$GITEA_DATA_DIR") -xzf $OUT/gitea-data.tar.gz && docker compose start gitea"
|