231 lines
8.7 KiB
Bash
Executable File
231 lines
8.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# =============================================================================
|
||
# UNIS HRMS · docker-compose 部署脚本(封装 docker compose,带前置检查与健康等待)
|
||
#
|
||
# ./scripts/deploy.sh up 首次部署:准备 .env → 构建镜像 → 后台启动 → 等健康
|
||
# ./scripts/deploy.sh update 改完代码重建镜像并替换容器(数据留在 ./data)
|
||
# ./scripts/deploy.sh logs 跟踪应用日志(Ctrl-C 退出)
|
||
# ./scripts/deploy.sh status 容器状态 + 健康探针 + 当前端口/数据库
|
||
# ./scripts/deploy.sh restart 重启容器(不重建)
|
||
# ./scripts/deploy.sh stop 停止容器(保留容器与数据)
|
||
# ./scripts/deploy.sh down 删除容器(数据仍在 ./data)
|
||
# ./scripts/deploy.sh migrate 在容器内执行 alembic upgrade head
|
||
# ./scripts/deploy.sh seed [args] 在容器内播种/补齐数据,如 seed --force
|
||
# ./scripts/deploy.sh seed --rbac 升级发版后只同步权限点/菜单(不动业务数据)
|
||
# ./scripts/deploy.sh shell 进入容器 shell
|
||
# ./scripts/deploy.sh backup SQLite 热备份到 data/backups/(不依赖 Docker)
|
||
# ./scripts/deploy.sh mysql-up 启动内置 MySQL(profile mysql)并等就绪
|
||
# ./scripts/deploy.sh mysql-stop 停止内置 MySQL
|
||
#
|
||
# HOST_PORT=8081 ./scripts/deploy.sh up 换对外端口
|
||
# SKIP_BUILD=1 ./scripts/deploy.sh up 用现有镜像直接起(不重新构建)
|
||
# 镜像源/基础镜像等构建参数见 docker-compose.yml,值统一来自 .env。
|
||
# =============================================================================
|
||
set -euo pipefail
|
||
|
||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||
ROOT="$(dirname "$SCRIPT_DIR")"
|
||
cd "$ROOT"
|
||
|
||
SERVICE=hrms
|
||
COMPOSE_FILE="${COMPOSE_FILE:-docker-compose.yml}"
|
||
COMPOSE=() # docker compose / docker-compose 命令前缀
|
||
WITH_MYSQL="" # DATABASE_URL 指向内置服务时置为 "--profile mysql"
|
||
|
||
usage() {
|
||
# 打印文件头部的注释块(跳过 shebang 与分隔线)
|
||
awk 'NR==1{next} /^#/{sub(/^#[[:space:]]?/,""); if ($0 !~ /^=+$/) print; next} {exit}' \
|
||
"${BASH_SOURCE[0]}"
|
||
}
|
||
|
||
env_get() { # env_get KEY DEFAULT —— 从 .env 取值(不 source,避免空格/中文值出问题)
|
||
local key="$1" default="$2" line val=""
|
||
if [ -f .env ]; then
|
||
line="$(grep -E "^[[:space:]]*${key}=" .env | tail -n 1 || true)"
|
||
[ -n "$line" ] && val="${line#*=}"
|
||
val="${val%%#*}"
|
||
val="$(printf '%s' "$val" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//' \
|
||
-e 's/^"\(.*\)"$/\1/' -e "s/^'\(.*\)'$/\1/")"
|
||
fi
|
||
[ -n "$val" ] && printf '%s' "$val" || printf '%s' "$default"
|
||
}
|
||
|
||
# ---------- 前置检查 ----------
|
||
require_docker() {
|
||
command -v docker >/dev/null 2>&1 || {
|
||
echo "!! 没找到 docker 命令。请先安装 Docker Desktop / docker-ce。" >&2; exit 1; }
|
||
if ! docker info >/dev/null 2>&1; then
|
||
echo "!! Docker 守护进程没起来(docker info 失败)。请先启动 Docker 再试。" >&2; exit 1;
|
||
fi
|
||
if docker compose version >/dev/null 2>&1; then COMPOSE=(docker compose)
|
||
elif command -v docker-compose >/dev/null 2>&1; then COMPOSE=(docker-compose)
|
||
else echo "!! 没找到 docker compose(v2)或 docker-compose。" >&2; exit 1; fi
|
||
}
|
||
|
||
# 统一入口:自动带上 compose 文件与(可选的)mysql profile
|
||
cc() { "${COMPOSE[@]}" -f "$COMPOSE_FILE" $WITH_MYSQL "$@"; }
|
||
|
||
# ---------- .env / 数据目录 ----------
|
||
prepare_env() {
|
||
if [ ! -f .env ]; then
|
||
cp .env.example .env
|
||
local secret=""
|
||
if command -v openssl >/dev/null 2>&1; then secret="$(openssl rand -hex 32)"
|
||
elif command -v python3 >/dev/null 2>&1; then
|
||
secret="$(python3 -c 'import secrets;print(secrets.token_hex(32))')"
|
||
fi
|
||
if [ -n "$secret" ]; then
|
||
awk -v s="$secret" 'BEGIN{FS=OFS="="} $1=="SECRET_KEY"{$0="SECRET_KEY=" s} {print}' \
|
||
.env > .env.tmp && mv .env.tmp .env
|
||
fi
|
||
echo "==> 已生成 .env(随机 SECRET_KEY)。要连 MySQL 请改 DATABASE_URL。"
|
||
fi
|
||
HOST_PORT="$(env_get HOST_PORT 8000)"
|
||
DB_URL="$(env_get DATABASE_URL 'sqlite+aiosqlite:///./data/hrms.db')"
|
||
mkdir -p data/uploads
|
||
# DATABASE_URL 指向服务名 mysql → 打开 compose 的 mysql profile
|
||
local host="${DB_URL##*@}"; host="${host%%/*}"; host="${host%%:*}"
|
||
case "$host" in
|
||
mysql|unis-hrms-mysql) WITH_MYSQL="--profile mysql" ;;
|
||
*) WITH_MYSQL="" ;;
|
||
esac
|
||
}
|
||
|
||
# ---------- 工具 ----------
|
||
health_url() { printf 'http://127.0.0.1:%s/health' "$HOST_PORT"; }
|
||
|
||
wait_healthy() {
|
||
local url; url="$(health_url)"
|
||
printf '==> 等待健康检查 %s ' "$url"
|
||
for _ in $(seq 1 90); do
|
||
if curl -sf -o /dev/null --max-time 3 "$url" 2>/dev/null; then echo " ✔"; return 0; fi
|
||
printf '.'; sleep 2
|
||
done
|
||
echo " ✗"
|
||
echo "!! 180 秒内没等到 /health。最近日志:" >&2
|
||
cc logs --tail 60 "$SERVICE" >&2 || true
|
||
return 1
|
||
}
|
||
|
||
wait_mysql() {
|
||
local cid status
|
||
cid="$(cc --profile mysql ps -q mysql 2>/dev/null || true)"
|
||
[ -n "$cid" ] || { echo "!! 内置 MySQL 容器没起来" >&2; return 1; }
|
||
printf '==> 等待 MySQL 就绪 '
|
||
for _ in $(seq 1 60); do
|
||
status="$(docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$cid" 2>/dev/null || echo unknown)"
|
||
[ "$status" = healthy ] && { echo " ✔"; return 0; }
|
||
[ "$status" = exited ] && { echo " ✗"; echo "!! MySQL 容器异常退出" >&2; return 1; }
|
||
printf '.'; sleep 2
|
||
done
|
||
echo " ✗(超时)"; return 1
|
||
}
|
||
|
||
show_access() {
|
||
cat <<INFO
|
||
|
||
── 部署完成 ───────────────────────────────────────────
|
||
管理端 http://127.0.0.1:${HOST_PORT} admin / admin123
|
||
员工自助 http://127.0.0.1:${HOST_PORT}/m emp / emp123456
|
||
接口文档 http://127.0.0.1:${HOST_PORT}/docs
|
||
数据目录 ${ROOT}/data(SQLite 库 + 上传附件)
|
||
数据库 ${DB_URL}
|
||
常用命令 ./scripts/deploy.sh logs | status | update | backup | down
|
||
──────────────────────────────────────────────────────
|
||
INFO
|
||
}
|
||
|
||
# ---------- SQLite 热备份(不依赖 Docker:直接读宿主机的 ./data)----------
|
||
do_backup() {
|
||
local src dst
|
||
src=data/hrms.db
|
||
[ -f "$src" ] || { echo "!! 没有找到 ${src}(当前用的可能不是 SQLite,或库不在 ./data)" >&2; return 1; }
|
||
mkdir -p data/backups
|
||
dst="data/backups/hrms-$(date +%Y%m%d-%H%M%S).db"
|
||
if command -v python3 >/dev/null 2>&1; then
|
||
# 用 sqlite3 backup API:容器/服务正在写库也能拿到一致性快照
|
||
python3 - "$src" "$dst" <<'PY'
|
||
import sqlite3, sys
|
||
src, dst = sys.argv[1], sys.argv[2]
|
||
with sqlite3.connect(src) as s, sqlite3.connect(dst) as d:
|
||
with d:
|
||
s.backup(d)
|
||
print(f"已备份 {src} → {dst}")
|
||
PY
|
||
else
|
||
cp "$src" "$dst" && echo "已复制 $src → ${dst}(建议装 python3 以做一致性热备份)"
|
||
fi
|
||
ls -lh data/backups | tail -5
|
||
}
|
||
|
||
cmd="${1:-up}"; shift || true
|
||
case "$cmd" in -h|--help|help) usage; exit 0 ;; esac
|
||
|
||
# 备份只碰宿主机上的 ./data,本机 run.sh 跑的和容器跑的都能用,不需要 Docker
|
||
if [ "$cmd" = "backup" ]; then do_backup; exit $?; fi
|
||
|
||
require_docker
|
||
prepare_env
|
||
|
||
case "$cmd" in
|
||
up|update)
|
||
if [ "${SKIP_BUILD:-0}" = "1" ]; then cc up -d || exit 1; else cc up -d --build || exit 1; fi
|
||
wait_healthy || exit 1
|
||
show_access
|
||
;;
|
||
start)
|
||
cc start
|
||
wait_healthy || exit 1
|
||
;;
|
||
build)
|
||
cc build
|
||
;;
|
||
restart)
|
||
cc restart "$SERVICE"
|
||
wait_healthy || exit 1
|
||
;;
|
||
stop)
|
||
cc stop "$SERVICE"
|
||
;;
|
||
down)
|
||
cc --profile mysql down
|
||
echo "==> 容器已删除;数据仍保留在 ./data(内置 MySQL 的数据在卷 hrms-mysql 里)"
|
||
;;
|
||
logs)
|
||
exec cc logs -f --tail 200 "$SERVICE"
|
||
;;
|
||
status|ps)
|
||
cc --profile mysql ps
|
||
echo
|
||
if curl -sf -o /dev/null --max-time 3 "$(health_url)"; then
|
||
echo "✔ 健康探针通过:$(health_url) → $(curl -s --max-time 3 "$(health_url)")"
|
||
else
|
||
echo "· 健康探针未通过(服务未启动或端口不是 ${HOST_PORT})"
|
||
fi
|
||
;;
|
||
migrate)
|
||
cc exec "$SERVICE" alembic upgrade head
|
||
;;
|
||
seed)
|
||
cc exec "$SERVICE" python -m app.seed "$@"
|
||
;;
|
||
shell)
|
||
exec cc exec "$SERVICE" sh
|
||
;;
|
||
backup)
|
||
do_backup
|
||
;;
|
||
mysql-up)
|
||
cc --profile mysql up -d mysql
|
||
wait_mysql
|
||
echo "==> 内置 MySQL 已就绪。请把 .env 的 DATABASE_URL 指向它,并把 PIP_EXTRAS 设为 [mysql]:"
|
||
echo " DATABASE_URL=mysql+aiomysql://hrms:hrms@mysql:3306/hrms?charset=utf8mb4"
|
||
;;
|
||
mysql-stop)
|
||
cc --profile mysql stop mysql
|
||
;;
|
||
*)
|
||
echo "!! 未知命令:$cmd" >&2; echo; usage; exit 1
|
||
;;
|
||
esac
|