score-backend/.gitea/workflows

Gitea Actions 部署配置说明

前提条件

• Gitea Runner 已配置为 self-hosted 模式，直接在宿主机上运行
• 宿主机上已安装 bun 和 pm2
• Runner 用户有权限访问 /home/score-backend 目录

工作流说明

• 触发条件:

  • 推送到 dev 或 main 分支时自动触发
  • 也可以手动触发（workflow_dispatch）

• 部署步骤:

  1. 检出代码到 runner 工作目录
  2. 使用 rsync 同步文件到 /home/score-backend（排除不需要的文件）
  3. 在目标目录执行 bun install 安装依赖
  4. 使用 pm2 restart media-backend 重启应用（如果应用不存在则启动）

文件排除规则

以下文件/目录不会被同步到服务器：

• .git - Git 仓库文件
• node_modules - 依赖包（会在服务器上重新安装）
• .DS_Store - macOS 系统文件
• *.db - 数据库文件
• bun.lockb - Bun 锁文件
• .env / .env.local - 环境变量文件（保留服务器上的配置）
• .gitea - Gitea 工作流文件

PM2 配置

如果 PM2 中还没有 media-backend 应用，工作流会自动创建。你也可以手动配置：

cd /home/score-backend
pm2 start main.ts --name media-backend
pm2 save
pm2 startup  # 设置开机自启

注意事项

• 确保 Runner 用户有写入 /home/score-backend 的权限
• 确保环境变量在服务器上已正确配置（不会覆盖 .env 文件）
• 数据库文件不会被覆盖，确保数据安全