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