unis_hrms/scripts/deploy.sh

231 lines
8.7 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#!/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