jif2.zhang
5e6ea552d1
分支规则 (写入 readme): - master 主分支, 唯一部署出口, push 即发布生产 - dev-* 开发集成分支, 只跑 CI 校验, 不部署; 上线先合到 master - tmp-* 临时分支, 针对单个问题, 合到 dev-* 后删除 - android-* 仅触发 APK 外壳构建, 构建前须与 master 同步 CI 变更: - .gitea/workflows/docker-build.yml 触发分支收窄为 master 此前 dev-* 与 master 共用同一套生产环境, 推送开发分支即直接发布, 容易把半成品带上线, 现取消该触发 - 同步修正工作流内相关注释 (迁移时机, 版本校验范围) 文档变更: - readme 新增「分支规则」章节: 职责表/流程图/CI 触发范围/变更说明 - readme 原「分支与 CI/CD」章节与新规则冲突, 已按新策略重写 (dev-* 不再触发部署; 数据库迁移只在 master 发布时应用) - 明确团队约定的 main 主分支在本仓库落地为 master
115 lines
5.2 KiB
YAML
115 lines
5.2 KiB
YAML
name: Docker Build and Push
|
||
|
||
# 仅主分支 (master) push 触发部署; 其他分支一律不触发 (见 readme「分支规则」)
|
||
# 每次提交: 构建前端 + 生成 OTA 升级包 (签名) → 打进 Docker 镜像 → 自动升级数据库 → 部署
|
||
# OTA 随镜像发布: 容器内 OTA_PACKAGE_DIR=/app/ota-package 指向打包的 ota-package/
|
||
#
|
||
# 分支策略 (2026-10 调整):
|
||
# - master = 主分支, 唯一部署出口, push 即发布生产 (容器 iboard, 宿主 3001)
|
||
# - dev-* = 开发集成分支, 只做 CI 校验 (构建/版本一致性), **不再自动部署**;
|
||
# 要上线必须先合并到 master 再推 master
|
||
# - tmp-* = 单个问题的临时分支, 合到 dev-* 后删除
|
||
# - android-*= 只用于触发 APK 外壳构建, 不部署; 改动前须与 master 同步
|
||
#
|
||
# 历史: 之前 dev-* 与 master 共用同一套生产环境 (推送即发布), 容易把半成品带上线,
|
||
# 现已取消 dev-* 的 push 触发。
|
||
on:
|
||
push:
|
||
branches:
|
||
- master
|
||
|
||
jobs:
|
||
build-image:
|
||
runs-on: ubuntu-latest
|
||
env:
|
||
# 关键: 显式固定 Android/OTA 后端地址, 覆盖 runner 环境里可能存在的
|
||
# 其他 VITE_API_BASE 值。否则 OTA 包里的前端可能连错后端, 导致
|
||
# "OTA 更新后登录失败/进不去内部"。与 android-build.yml 保持一致。
|
||
VITE_API_BASE: http://bh.vps.honor3.com:3001
|
||
# OTA bundle 要求的最低原生二进制版本。
|
||
# 与 package.json 的应用版本是**两个概念**: 前端 OTA 不碰原生层,
|
||
# 现有 APK 仍是 0.1.0, 所以这里固定 0.1.0 (否则旧 APK 会被判定为不兼容而收不到更新)。
|
||
# 重打 APK 并确认原生层无破坏后, 再提升此值。
|
||
OTA_MIN_BINARY: '0.1.0'
|
||
steps:
|
||
- uses: https://gitea.com/actions/checkout@v4
|
||
|
||
- name: Setup Node
|
||
uses: https://gitea.com/actions/setup-node@v4
|
||
with:
|
||
node-version: 22
|
||
|
||
- name: Check version consistency & branch
|
||
# 1) package.json / tauri.conf.json / Cargo.toml / Cargo.lock 四处版本必须完全相等且不带 -ota
|
||
# （tauri.conf.json 的 version 就是 APK 的 versionName）
|
||
# 2) 防止 OTA 版本号与分支错位: OTA 包的 version 直接取自 package.json,
|
||
# dev-0.2 分支上必须是 0.2.x, 否则线上 OTA 会报成上一个版本的号
|
||
# (master 分支跳过分支前缀校验, 但四处一致性照样强制)
|
||
env:
|
||
GITHUB_REF_NAME: ${{ github.ref_name }}
|
||
run: node scripts/ci/check-version.mjs
|
||
|
||
- name: Install deps
|
||
run: npm ci --no-audit --no-fund
|
||
|
||
- name: Build frontend
|
||
# dist/ 供 OTA 打包用 (Dockerfile 内也会构建一份)
|
||
run: npm run build
|
||
|
||
- name: Install minisign
|
||
run: sudo apt-get update && sudo apt-get install -y minisign
|
||
|
||
- name: Build & sign OTA package
|
||
# 每次主分支提交生成 OTA 升级包, sequence 默认时间戳 (单调递增)
|
||
# 产物 ota-package/ (tar.gz + latest.json + .minisig) 进入 docker build context, 由 Dockerfile COPY 进镜像
|
||
env:
|
||
MINISIGN_PRIVATE_KEY: ${{ secrets.MINISIGN_PRIVATE_KEY }}
|
||
OTA_NOTES: ${{ github.sha }}
|
||
run: |
|
||
set -euo pipefail
|
||
node scripts/build-ota.mjs --out ota-package --notes ${OTA_NOTES} --min-binary ${OTA_MIN_BINARY}
|
||
echo "===== latest.json ====="
|
||
cat ota-package/latest.json
|
||
echo "===== bundle sha256 ====="
|
||
sha256sum ota-package/iboard-ota.tar.gz
|
||
|
||
- name: Build Docker image
|
||
# DATABASE_URL 仅在 prisma generate 阶段需要, 可用任何合法占位串
|
||
run: docker build -t iboard:latest --build-arg DATABASE_URL=mysql://build:build@127.0.0.1:3306/build .
|
||
|
||
- name: List images
|
||
run: docker images
|
||
|
||
- name: Apply DB migrations
|
||
# 数据库自动升级: 按 prisma/migrations/ 下的迁移顺序应用 (生产库由 master 部署时统一升级)
|
||
# migrate deploy 幂等, 无新迁移时为 no-op
|
||
# 位置关键: 在 "Remove old container" 之前 —— 建表/改表成功后才切换流量,
|
||
# 迁移失败则整个 workflow 中断, 不会用新镜像顶掉仍在运行的旧容器
|
||
env:
|
||
DATABASE_URL: ${{ secrets.DATABASE_URL }}
|
||
run: |
|
||
set -euo pipefail
|
||
npx prisma migrate status || true
|
||
npx prisma migrate deploy
|
||
|
||
- name: Remove old container
|
||
run: docker rm -vf iboard || true
|
||
|
||
- name: Recycle container
|
||
run: docker system prune --volumes -f
|
||
|
||
- name: Run container
|
||
# DATABASE_URL 通过 gitea Actions secret 注入, 不进镜像层
|
||
# OTA_PACKAGE_DIR 已在 Dockerfile 设为 /app/ota-package
|
||
# 米家凭证 (auth.txt) 不进 git: 运维放宿主机 /app/iboard/cache, bind-mount 进容器 (MIHOME_CACHE_DIR=/app/cache)
|
||
run: |
|
||
docker run -d --name iboard -p 3001:3001 \
|
||
-e DATABASE_URL="${{ secrets.DATABASE_URL }}" \
|
||
-e JWT_SECRET="${{ secrets.JWT_SECRET }}" \
|
||
-e MIHOME_CACHE_DIR=/app/cache \
|
||
-v /app/iboard/cache:/app/cache \
|
||
iboard:latest
|
||
env:
|
||
DATABASE_URL: ${{ secrets.DATABASE_URL }}
|
||
JWT_SECRET: ${{ secrets.JWT_SECRET }}
|