zhengchen.tao
7df2d49c56
改 deploy.yml 或 sync-upstream.yml 都不影响镜像内容（前者是部署 脚本、后者是 main reset 脚本），原本会触发整套 ~10 min 的 build 是浪费。把它俩加进 paths-ignore 跳过。 build-image.yml 自己保留触发（不在 ignore 里），这样改 workflow 能 self-test 验证改动有效。
120 lines
5.3 KiB
YAML
120 lines
5.3 KiB
YAML
name: Build Docker Image
|
||
|
||
on:
|
||
# 自动触发：push 到 custom 分支时跑（force-push 后的 rebase 也会触发，可接受）
|
||
# paths-ignore：纯文档/配置改动跳过，避免浪费 ~10 分钟构建
|
||
# ⚠️ 已知 quirk（2026-05-02 验证）：empty commit（git commit --allow-empty）
|
||
# 不会触发 paths-ignore 过滤的 workflow，Gitea 把 zero-paths-changed 当作
|
||
# "vacuously matches ignore list" 跳过。要强制触发必须至少改一个非 ignore 路径
|
||
# 的真实文件（改这个 yml 自己最稳）。
|
||
push:
|
||
branches: [custom]
|
||
paths-ignore:
|
||
- '**.md'
|
||
- '.gitignore'
|
||
- 'LICENSE'
|
||
- 'screenshot/**'
|
||
# 这两个 workflow 改动不影响镜像内容，没必要 rebuild：
|
||
# - deploy.yml 改的是部署逻辑（compose pull/up），不动镜像
|
||
# - sync-upstream.yml 改的是 main reset 逻辑，跟 build 也无关
|
||
# build-image.yml 自己留着会触发，作为 workflow 改动的 self-test
|
||
- '.gitea/workflows/deploy.yml'
|
||
- '.gitea/workflows/sync-upstream.yml'
|
||
# 手动触发：保留作为应急通道（重新打包旧 commit / 用自定义 tag / 等）
|
||
workflow_dispatch:
|
||
inputs:
|
||
branch:
|
||
description: '要打包的分支（仅手动触发生效）'
|
||
required: true
|
||
default: 'custom'
|
||
tag:
|
||
description: '镜像 tag（留空则用 commit short hash）'
|
||
required: false
|
||
default: ''
|
||
|
||
# 并发控制：同一分支的连续 push 只跑最新的，旧 in-progress run 会被取消
|
||
# 例：连续 3 次 push，第 1 次 build 跑了 30s，第 2 次开始 → 取消第 1，第 2 跑；
|
||
# 期间第 3 次又来 → 取消第 2，第 3 跑。最后只构建出最新代码，省 CI 时间。
|
||
# group 包含 ref 是为了不同分支的 build 互不干扰（虽然当前只有 custom 用）
|
||
concurrency:
|
||
group: ${{ github.workflow }}-${{ github.ref }}
|
||
cancel-in-progress: true
|
||
|
||
jobs:
|
||
build:
|
||
runs-on: ubuntu-latest
|
||
steps:
|
||
- name: Checkout target branch
|
||
uses: actions/checkout@v4
|
||
with:
|
||
# 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
|
||
uses: docker/setup-buildx-action@v3
|
||
with:
|
||
# 钉到 v0.13.2（自带 runc 1.1.x），避免 runc 1.2+ 的 procfs 安全检查
|
||
# 在 DSM 老内核（4.4.x）上撞 openat2/fsmount 不存在导致 build 失败
|
||
driver-opts: |
|
||
image=moby/buildkit:v0.13.2
|
||
|
||
- name: Login to Gitea Container Registry
|
||
uses: docker/login-action@v3
|
||
with:
|
||
registry: git.zhengchentao.win
|
||
username: ${{ gitea.actor }}
|
||
password: ${{ secrets.PACKAGES_TOKEN }}
|
||
|
||
- name: Determine image tag and revision
|
||
id: meta
|
||
run: |
|
||
if [ -n "${{ inputs.tag }}" ]; then
|
||
IMAGE_TAG="${{ inputs.tag }}"
|
||
else
|
||
IMAGE_TAG="$(git rev-parse --short HEAD)"
|
||
fi
|
||
echo "image_tag=$IMAGE_TAG" >> $GITHUB_OUTPUT
|
||
echo "full_sha=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
|
||
echo "==> Image tag: $IMAGE_TAG"
|
||
|
||
- name: Build and push
|
||
uses: docker/build-push-action@v5
|
||
with:
|
||
context: .
|
||
push: true
|
||
# 上游 Dockerfile 用 BUILD_PIPELINE 作为 CI 跳过开关：
|
||
# 设为 "1" 时 pkg/exchangerates 跳过依赖第三方 API 的活测试
|
||
# （加拿大银行/乌兹别克央行 API 国内不稳，跑就超时）
|
||
# CHECK_3RD_API 留空 → 三方 API 测试不跑；想跑设 "1"
|
||
build-args: |
|
||
BUILD_PIPELINE=1
|
||
# OCI 标签：
|
||
# - source 让 Gitea 收包时自动把镜像关联到对应 repo（不再需要手动去
|
||
# "包设置 → 链接到仓库"）
|
||
# - revision 把构建时的 commit full SHA 烙进镜像 manifest，
|
||
# docker inspect 能反推回源码版本
|
||
labels: |
|
||
org.opencontainers.image.source=https://git.zhengchentao.win/dev/ezbookkeeping
|
||
org.opencontainers.image.revision=${{ steps.meta.outputs.full_sha }}
|
||
tags: |
|
||
git.zhengchentao.win/dev/ezbookkeeping:${{ steps.meta.outputs.image_tag }}
|
||
git.zhengchentao.win/dev/ezbookkeeping:latest
|
||
|
||
- name: Build summary
|
||
# 把构建出的镜像 tag 与源 commit 显式列在 Action run summary 区，
|
||
# 方便从 UI 一眼看到本次 build 产出。always() 保证 build 失败也输出。
|
||
if: always()
|
||
run: |
|
||
{
|
||
echo "## Build Summary"
|
||
echo ""
|
||
echo "| 项 | 值 |"
|
||
echo "|---|---|"
|
||
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\` |"
|
||
} >> "$GITHUB_STEP_SUMMARY" |