refactor: 统一运行/编译脚本为 scripts/ 下纯 Python（自动 venv，傻瓜式）

新增 _env.py 共享工具与 dev/run/tauri_dev/build_server/build_tauri/build_docker/clean 脚本，删除旧 build.{sh,ps1,bat}、根 run.bat/debug.bat/start.sh/dev.py、supervisord.conf、packaging/Dockerfile， Docker 改以根 Dockerfile 为准并重写 compose（/data 卷）。
2026-06-26 11:03:19 +08:00
parent 54b40ca46b
commit 98f03b3e0e
19 changed files with 1076 additions and 1133 deletions
@@ -0,0 +1,88 @@
+"""Docker 镜像编译 / 更新脚本（基于根目录 Dockerfile + docker/entrypoint.sh）。
+
+用法：
+    python scripts/build_docker.py            # 编译镜像并生成可部署离线包（dist/docker/）
+    python scripts/build_docker.py update      # 重新编译镜像并就地更新本机运行的容器
+    python scripts/build_docker.py --no-save   # 编译但不导出 tar（本机调试更快）
+
+镜像 tag：capacity-report-app:latest。镜像内运行态数据落在 /data 数据卷，
+首次启动由 docker/entrypoint.sh 播种默认 Configure.json / ReportScript.sql。
+"""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import _env  # noqa: E402
+
+IMAGE_TAG = "capacity-report-app:latest"
+DOCKERFILE = _env.ROOT / "Dockerfile"
+COMPOSE_FILE = _env.PACKAGING_DIR / "docker-compose.yml"
+BUNDLE_FILES = ["Configure.json", "ReportScript.sql", "CellData.sql"]
+
+
+def build_image() -> None:
+    _env.ensure_docker()
+    _env.build_frontend()
+    _env.step("构建 Docker 镜像")
+    _env.run(
+        ["docker", "build", "--progress=plain", "-f", str(DOCKERFILE), "-t", IMAGE_TAG, "."],
+        cwd=_env.ROOT,
+    )
+
+
+def make_bundle(save_tar: bool) -> Path:
+    out_dir = _env.DIST_DIR / "docker"
+    _env.remove_path(out_dir)
+    out_dir.mkdir(parents=True, exist_ok=True)
+    (out_dir / "cache").mkdir(exist_ok=True)
+    (out_dir / "logs").mkdir(exist_ok=True)
+
+    shutil.copy2(COMPOSE_FILE, out_dir / "docker-compose.yml")
+    shutil.copytree(_env.PACKAGING_DIR / "mysql", out_dir / "mysql", dirs_exist_ok=True)
+    for name in BUNDLE_FILES:
+        src = _env.ROOT / name
+        if src.exists():
+            shutil.copy2(src, out_dir / name)
+
+    if save_tar:
+        _env.step("导出镜像 tar")
+        _env.run(["docker", "save", "-o", str(out_dir / "capacity-report-app-latest.tar"), IMAGE_TAG])
+
+    _env.step(f"Docker 离线包：{out_dir}")
+    return out_dir
+
+
+def update_running() -> None:
+    _env.step("更新本机运行的容器（docker compose up -d）")
+    _env.run(
+        ["docker", "compose", "-f", str(COMPOSE_FILE), "up", "-d", "--force-recreate", "capacity-app"],
+        cwd=_env.PACKAGING_DIR,
+    )
+
+
+def main() -> int:
+    _env.setup_console()
+    parser = argparse.ArgumentParser(description="编译 / 更新 Docker 镜像")
+    parser.add_argument("action", nargs="?", choices=["build", "update"], default="build", help="build=编译并打包；update=编译并就地更新容器")
+    parser.add_argument("--no-save", action="store_true", help="编译镜像但不导出 tar")
+    args = parser.parse_args()
+
+    build_image()
+
+    if args.action == "update":
+        update_running()
+    else:
+        make_bundle(save_tar=not args.no_save)
+
+    _env.step("清理前端中间产物")
+    _env.remove_path(_env.FRONTEND_DIR / "dist")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())