Files
admin 79256c5be0 feat: 新增 Docker Compose 部署方案, 移除未验证的 ansible 草案
原 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 登录源注册正常。
2026-09-11 16:00:15 +08:00

121 lines
4.8 KiB
Bash
Executable File

#!/usr/bin/env bash
# =============================================================================
# 部署后验证 —— 只读
#
# ./verify.sh # 容器检查需要 docker 权限
# sudo ./verify.sh # 没加 docker 组时用这个
#
# 检查容器健康、Gitea API、以及经 Apache 反代的对外地址。
# =============================================================================
set -uo pipefail
DEPLOY_DIR=$(cd "$(dirname "$0")/.." && pwd)
cd "$DEPLOY_DIR"
ok() { printf ' [ ok ] %s\n' "$1"; }
bad() { printf ' [FAIL] %s\n' "$1"; }
info() { printf ' [info] %s\n' "$1"; }
warn() { printf ' [warn] %s\n' "$1"; }
# -----------------------------------------------------------------------------
# 本脚本检查的是【本机】端点, 必须绕过 HTTP 代理。
# 若 shell 设了 http_proxy 而 no_proxy 未覆盖 127.0.0.1, 回环请求会被代理接管:
# 本机 mihomo 对 127.0.0.1 直接返回 "502 Bad Gateway", 健康的站点会被误报成故障。
# (实测: 走代理 -> 502; --noproxy '*' -> 200)
# -----------------------------------------------------------------------------
unset http_proxy https_proxy ftp_proxy all_proxy HTTP_PROXY HTTPS_PROXY FTP_PROXY ALL_PROXY
export no_proxy='*' NO_PROXY='*'
CURL=(curl -sS --noproxy '*' --max-time 10)
[[ -f .env ]] || { echo "错误: 缺少 .env" >&2; exit 1; }
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
HTTP_PORT=${GITEA_HTTP_PORT:-2080}
ROOT_URL=${GITEA_ROOT_URL:-http://127.0.0.1/}
FAIL=0
echo "=============================================="
echo " 部署验证"
echo "=============================================="
echo
echo "-- 容器状态 --"
DOCKER_OK=0
if docker info >/dev/null 2>&1; then
DOCKER_OK=1
docker compose ps
else
warn "无法访问 docker daemon —— 容器状态与健康检查跳过"
info " 用 sudo 运行可完整检查: sudo $0"
info " (或把用户加入 docker 组; 那等于免密 root, 取舍见 deploy/README.md 第 3 节)"
fi
if [[ ${DOCKER_OK} -eq 1 ]]; then
echo
echo "-- 健康检查 --"
# 刚 --force-recreate / restart 过的容器, 在 start_period(60s)内状态是 "starting",
# 这是正常过渡态而不是故障 —— 最多等 60s, 避免把启动过程误报成 [FAIL]。
# (与下面回环检查是同一类竞态: verify.sh 常常紧接着一次重建被执行。)
for c in gitea-db gitea; do
st=""
for i in $(seq 1 12); do
st=$(docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$c" 2>/dev/null || echo missing)
if [[ "$st" != "starting" && "$st" != "created" ]]; then break; fi
if [[ $i -eq 1 ]]; then echo " (${c} 正在启动, 最多等 60s ...)"; fi
sleep 5
done
if [[ "$st" == "healthy" || "$st" == "running" ]]; then ok "$c: $st"; else bad "$c: $st"; FAIL=1; fi
done
fi
echo
echo "-- 本机回环 API (127.0.0.1:${HTTP_PORT}) --"
# 刚 restart 过的容器有一小段窗口: docker-proxy 已接管端口, 但 gitea 还没开始 listen,
# 此时 docker-proxy 会返回 502。给最多 30s 的重试, 避免把启动竞态误报成故障。
# 注意: 这里不用 curl -f —— 我们要的是状态码本身(502 也是有效信息),
# 加了 -f 会退出非 0, 再配合 "|| echo 000" 就会把 502 和 000 拼成 "502000"。
code=""
for i in $(seq 1 7); do
code=$("${CURL[@]}" -o /dev/null -w '%{http_code}' \
"http://127.0.0.1:${HTTP_PORT}/api/healthz" 2>/dev/null) || code=000
if [[ "$code" == "200" ]]; then break; fi
if [[ $i -eq 1 ]]; then echo " (本机 API 尚未就绪, 最多等 30s ...)"; fi
sleep 5
done
if [[ "$code" == "200" ]]; then ok "/api/healthz -> 200"; else bad "/api/healthz -> $code"; FAIL=1; fi
ver=$("${CURL[@]}" "http://127.0.0.1:${HTTP_PORT}/api/v1/version" 2>/dev/null || true)
if [[ -n "$ver" ]]; then ok "/api/v1/version -> $ver"; else bad "/api/v1/version 无响应"; FAIL=1; fi
echo
echo "-- 经 Apache 反代 (${ROOT_URL}) --"
root=${ROOT_URL%/}
code=$("${CURL[@]}" -o /dev/null -w '%{http_code}' "${root}/api/v1/version" 2>/dev/null) || code=000
if [[ "$code" == "200" ]]; then ok "${root}/api/v1/version -> 200"; else bad "${root}/api/v1/version -> $code (检查 httpd 反代)"; FAIL=1; fi
if [[ ${DOCKER_OK} -eq 1 ]]; then
echo
echo "-- 日志尾部(容器) --"
docker compose logs --tail=15 gitea 2>/dev/null | sed 's/^/ /'
fi
echo
if [[ ${FAIL} -eq 0 ]]; then
if [[ ${DOCKER_OK} -eq 1 ]]; then
echo "==> 全部通过"
else
echo "==> HTTP 检查全部通过 (容器状态未检查: 需要 docker 权限)"
fi
else
echo "==> 存在失败项, 请检查上方 [FAIL]"
exit 1
fi