gongxiangp2/scripts/README.md

脚本说明

核心部署脚本

deploy-git-build.ps1 ⭐

主部署脚本 - Git 工作流部署（推荐使用）

• 本地提交代码到 Git
• 服务器从 Git 拉取代码
• 服务器端构建 Docker 镜像
• 自动部署新容器
• 支持清理旧镜像（保留最新4个）

重要提示：

• ⚠️ 文件位置：此脚本位于项目根目录（d:\gongxiangp2\deploy-git-build.ps1），不在 scripts 目录
• ⚠️ 部署流程：本地提交 → Git推送 → 服务器拉取 → 服务器构建 → 部署

使用方式：

# 在项目根目录执行（d:\gongxiangp2\）
# 部署到正式系统（端口 4320，自动提交并推送代码）
.\deploy-git-build.ps1 -Target production

# 部署到影子系统（端口 5320）
.\deploy-git-build.ps1 -Target shadow

# 指定提交信息
.\deploy-git-build.ps1 -Target production -CommitMessage "修复BUG"

# 仅提交不推送（用于本地测试）
.\deploy-git-build.ps1 -Target shadow -SkipPush

# 跳过提交，直接推送已有提交
.\deploy-git-build.ps1 -Target production -SkipCommit

# 构建镜像时禁用缓存
.\deploy-git-build.ps1 -Target production -NoCache

# 跳过构建产物清理
.\deploy-git-build.ps1 -Target production -SkipCleanup

# 显示帮助
.\deploy-git-build.ps1 -Help

参数说明：

• -Target: 部署目标，shadow（影子系统，端口5320）或 production（正式系统，端口4320）
• -CommitMessage: 提交信息（如果为空，将自动生成）
• -SkipCommit: 跳过Git提交（直接推送到远程）
• -SkipPush: 跳过Git推送（仅提交，不推送）
• -NoCache: 构建镜像时禁用缓存
• -SkipCleanup: 跳过构建产物清理

基础镜像管理

save-base-images.ps1

下载并保存基础镜像到本地缓存

.\save-base-images.ps1

load-base-images.ps1

从本地加载基础镜像（部署脚本会自动调用）

.\load-base-images.ps1

save-npm-packages.ps1（可选）

缓存 npm 包到本地（网络不稳定时使用）

.\save-npm-packages.ps1

数据库迁移脚本

execute-migration.ps1

在生产库上执行数据库迁移（Windows PowerShell）

.\execute-migration.ps1

execute-migration.sh

在生产库上执行数据库迁移（Linux/Mac）

chmod +x execute-migration.sh
./execute-migration.sh