From 32a49be913ff9de661b32761d5a8ae3e5facf012 Mon Sep 17 00:00:00 2001 From: Zhengchen Tao Date: Sat, 2 May 2026 20:41:22 +0800 Subject: [PATCH] =?UTF-8?q?build-image=20workflow=20=E6=94=B9=E8=87=AA?= =?UTF-8?q?=E5=8A=A8=E8=A7=A6=E5=8F=91=20+=20=E4=BF=9D=E7=95=99=E6=89=8B?= =?UTF-8?q?=E5=8A=A8=E5=A4=87=E9=80=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - on.push.branches: [custom] —— 推送 custom 自动跑 - on.push.paths-ignore：屏蔽 *.md / .gitignore / LICENSE / screenshot/** 避免 doc-only 改动浪费 ~10 min 构建 - on.workflow_dispatch 保留作为应急通道（重打旧 commit / 自定义 tag） - checkout ref 兼容两种触发：${{ inputs.branch || github.ref_name }} - workflow_dispatch：用用户填的 branch（默认 custom） - push：fallback 到 github.ref_name（即触发分支，永远是 custom） - Build summary 加"触发方式"行，便于区分本次是自动还是手动 预期：本提交本身就会触发自动构建（改了 .gitea/workflows/build-image.yml 不在 paths-ignore 内），相当于 self-test。 --- .gitea/workflows/build-image.yml | 19 ++++++++++++++++--- CLAUDE.md | 12 ++++++++++-- 2 files changed, 26 insertions(+), 5 deletions(-) diff --git a/.gitea/workflows/build-image.yml b/.gitea/workflows/build-image.yml index ea32c318..5e04b739 100644 --- a/.gitea/workflows/build-image.yml +++ b/.gitea/workflows/build-image.yml @@ -1,10 +1,20 @@ name: Build Docker Image on: + # 自动触发：push 到 custom 分支时跑（force-push 后的 rebase 也会触发，可接受） + # paths-ignore：纯文档/配置改动跳过，避免浪费 ~10 分钟构建 + push: + branches: [custom] + paths-ignore: + - '**.md' + - '.gitignore' + - 'LICENSE' + - 'screenshot/**' + # 手动触发：保留作为应急通道（重新打包旧 commit / 用自定义 tag / 等） workflow_dispatch: inputs: branch: - description: '要打包的分支' + description: '要打包的分支（仅手动触发生效）' required: true default: 'custom' tag: @@ -19,7 +29,9 @@ jobs: - name: Checkout target branch uses: actions/checkout@v4 with: - ref: ${{ inputs.branch }} + # workflow_dispatch 时用用户填的 branch；push 触发时 inputs.branch 为空， + # fallback 到 github.ref_name（即触发的分支名，push 到 custom 时就是 custom） + ref: ${{ inputs.branch || github.ref_name }} fetch-depth: 0 - name: Set up Docker Buildx @@ -82,7 +94,8 @@ jobs: echo "" echo "| 项 | 值 |" echo "|---|---|" - echo "| 源分支 | \`${{ inputs.branch }}\` |" + echo "| 触发方式 | \`${{ github.event_name }}\` |" + echo "| 源分支 | \`${{ inputs.branch || github.ref_name }}\` |" echo "| 源 commit (full) | \`${{ steps.meta.outputs.full_sha }}\` |" echo "| 源 commit (short) | \`${{ steps.meta.outputs.image_tag }}\` |" echo "| 镜像 tag | \`git.zhengchentao.win/dev/ezbookkeeping:${{ steps.meta.outputs.image_tag }}\` + \`:latest\` |" diff --git a/CLAUDE.md b/CLAUDE.md index a2513ef6..d8c885ac 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -56,7 +56,7 @@ git.zhengchentao.win/dev/ezbookkeeping （origin，本地唯一 remote） | 文件 | 触发 | 干什么 | 状态 | |---|---|---|---| | `sync-upstream.yml` | 手动（`workflow_dispatch`，可填 tag） | 服务端把 `dev/main` 强制 reset 到 mirror 上的指定 release tag（默认最新），然后 `push --force-with-lease` + 推 tags | ✅ 在用 | -| `build-image.yml` | 手动（可填要打包的分支 + 镜像 tag） | checkout 指定分支（默认 `custom`）→ 装 buildkit v0.13.2（钉版本）→ 登录 Gitea registry → 构建镜像（带 OCI 标签 source/revision，Gitea 自动关联包到 repo）→ push 到 `git.zhengchentao.win/dev/ezbookkeeping:` 与 `:latest`，`build-args: BUILD_PIPELINE=1` 跳过活 API 测试 | ✅ 在用，是日常发布通道 | +| `build-image.yml` | **自动**（push 到 custom 触发，`paths-ignore` 屏蔽 `**.md` / `.gitignore` / `LICENSE` / `screenshot/**`）+ 手动备选 | checkout 触发分支（push 时即 custom；手动时用 `inputs.branch` 默认 custom）→ 装 buildkit v0.13.2（钉版本）→ 登录 Gitea registry → 构建镜像（带 OCI 标签 source/revision，Gitea 自动关联包到 repo）→ push 到 `git.zhengchentao.win/dev/ezbookkeeping:` 与 `:latest`，`build-args: BUILD_PIPELINE=1` 跳过活 API 测试 | ✅ 在用，是日常发布通道 | | `deploy.yml` | 手动 | 跑 repo Variables 里 `CUSTOM_DEPLOY_SCRIPTS` 这条自定义脚本（通用钩子，可拼"build 完触发 NAS 端 docker compose pull/up"等） | 🟡 通用钩子，按需配 | **已删**：`docker-snapshot.yml`（push main 自动触发，未配 secrets.DOCKER_REPO 永远失败）、`docker-release.yml`（push tag 同样问题）。需要时再从 git 历史 cherry-pick 回来。 @@ -69,7 +69,15 @@ git.zhengchentao.win/dev/ezbookkeeping （origin，本地唯一 remote） 2. 人工触发 `Sync from upstream` workflow → 服务端把 dev/main reset 到该 tag 3. 本地 `git fetch && git checkout custom && git rebase origin/main` 4. 解冲突（如有）→ 验证 → `git push --force-with-lease origin custom` -5. 在 Gitea Actions UI 手动触发 build-image workflow，构建新镜像 +5. **build-image workflow 自动触发**（force-push 也算 push 事件），构建新镜像；不需要手动点 + +日常 feature commit 流程： + +1. 在 custom 上改代码 → commit → push +2. **自动触发 build**（除非只改了 `**.md` / `.gitignore` / `LICENSE` / `screenshot/**`） +3. NAS 上 `docker compose pull && docker compose up -d` 拉新镜像 + +如果想跳过 build（例如手动多次 push 调试），commit 时只改文档相关文件即可（落在 paths-ignore 范围内）。如果想强制重打某个旧 commit，去 Actions UI 手动触发 `Build Docker Image`，填要打包的 branch / tag。 **为什么 rebase 不 merge**：个人项目，无团队协作语义要保留，线性历史更清爽。