xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 2 Actions Packages Projects Releases 7 Wiki Activity

feat(ci): M-3 三镜像matrix并行构建重构 - 代码量减21% #365

Closed
xiaoxia wants to merge 3 commits from ci/matrix-build-parallelism into develop
pull from: ci/matrix-build-parallelism
merge into: xiaoxia:develop
Conversation 1 Commits 3 Files Changed 1
+67 -317
xiaoxia commented 2026-07-15 13:32:27 +08:00
Owner
Copy Link
Copy Source

背景

6个独立构建job（3 staging + 3 production）结构高度相似，维护成本高，且用户误以为当前是串行构建。

改动

将6个独立构建job重构为2个matrix job：

  • build-staging：matrix 3服务（api/worker/web）
  • build-production：matrix 3服务（api/worker/web）

具体变更

  1. 代码量减少249行（21%）：1186行 → 937行
  2. 构建逻辑统一：三服务共用同一套构建步骤，避免维护不同步
  3. 服务差异通过matrix变量控制：
    • service_display：显示名（API/Worker/Web）
    • dockerfile：Dockerfile路径
    • image_name：镜像名
    • cache_name：缓存名
    • timeout：超时时间（worker 40min，其他30min）
  4. 条件步骤：
    • npm build：仅web服务执行（if: matrix.service == 'web'）
    • Cleanup old images：仅production web执行
  5. fail-fast: false：单个服务构建失败不影响其他服务
  6. deploy needs同步更新：从3个build job → 1个matrix job

性能说明

⚠️ 性能无变化：当前三个构建已经是并行启动的（由Gitea Actions调度器自动并行），matrix重构主要是代码精简和维护性提升，不会进一步提速。总耗时仍由最慢的API构建决定。

验证

  • Staging三门禁全绿
  • 三个Staging镜像构建成功
  • Deploy Staging成功
  • Production构建（tag触发）语法正确
## 背景 6个独立构建job（3 staging + 3 production）结构高度相似，维护成本高，且用户误以为当前是串行构建。 ## 改动 将6个独立构建job重构为2个matrix job： - `build-staging`：matrix 3服务（api/worker/web） - `build-production`：matrix 3服务（api/worker/web） ### 具体变更 1. **代码量减少249行（21%）**：1186行 → 937行 2. **构建逻辑统一**：三服务共用同一套构建步骤，避免维护不同步 3. **服务差异通过matrix变量控制**： - `service_display`：显示名（API/Worker/Web） - `dockerfile`：Dockerfile路径 - `image_name`：镜像名 - `cache_name`：缓存名 - `timeout`：超时时间（worker 40min，其他30min） 4. **条件步骤**： - npm build：仅web服务执行（`if: matrix.service == 'web'`） - Cleanup old images：仅production web执行 5. **fail-fast: false**：单个服务构建失败不影响其他服务 6. **deploy needs同步更新**：从3个build job → 1个matrix job ### 性能说明 ⚠️ **性能无变化**：当前三个构建已经是并行启动的（由Gitea Actions调度器自动并行），matrix重构主要是代码精简和维护性提升，不会进一步提速。总耗时仍由最慢的API构建决定。 ## 验证 - [ ] Staging三门禁全绿 - [ ] 三个Staging镜像构建成功 - [ ] Deploy Staging成功 - [ ] Production构建（tag触发）语法正确
xiaoxia added 1 commit 2026-07-15 13:32:28 +08:00
feat(ci): M-3 三镜像matrix并行构建重构\n\n将6个独立构建job（3 staging + 3 production）重构为2个matrix job\n- 代码量减少249行（21%），维护性大幅提升\n- API/Worker/Web三服务共用同一套构建逻辑\n- web服务npm build步骤通过matrix条件控制\n- worker构建40分钟超时通过matrix.timeout配置\n- deploy-staging/deploy-production needs同步更新为单个matrix job\n- fail-fast: false，单个服务构建失败不影响其他服务 d120785b16
xiaoxia added 1 commit 2026-07-15 13:51:51 +08:00
fix(ci): 修复matrix重构中重复的if条件导致YAML解析失败
CI/CD Pipeline / Frontend Lint (push) Successful in 54s
Details
CI/CD Pipeline / Build Production API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Production (push) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (push) Has been skipped
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 39s
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Failing after 2m2s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate Code Quality And Tests (push) Failing after 2m5s
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (push) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (push) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (push) Has been skipped
Details
CI/CD Pipeline / Unit Tests (push) Successful in 2m18s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 2m3s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m30s
Details
CI/CD Pipeline / Integration Tests (push) Successful in 1m25s
Details
d7b7c0b235
xiaoxia added 1 commit 2026-07-15 14:08:17 +08:00
Merge remote-tracking branch 'origin/develop' into ci/matrix-build-parallelism
CI/CD Pipeline / Frontend Lint (push) Successful in 35s
Details
CI/CD Pipeline / Build Production API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Production (push) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (push) Has been skipped
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 37s
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate Code Quality And Tests (push) Successful in 1m56s
Details
CI/CD Pipeline / Build Staging API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (push) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (push) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (push) Has been skipped
Details
CI/CD Pipeline / Unit Tests (push) Successful in 2m2s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 1m40s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 1m54s
Details
CI/CD Pipeline / Integration Tests (push) Successful in 1m26s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m21s
Details
ea32481e66
auto-approve-bot approved these changes 2026-07-15 14:23:27 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
xiaoxia closed this pull request 2026-07-15 22:59:38 +08:00
Some checks are pending
CI/CD Pipeline / Frontend Lint (push) Successful in 35s
Details
CI/CD Pipeline / Build Production API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Production (push) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (push) Has been skipped
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 37s
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate Code Quality And Tests (push) Successful in 1m56s
Details
CI/CD Pipeline / Build Staging API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (push) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (push) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (push) Has been skipped
Details
CI/CD Pipeline / Unit Tests (push) Successful in 2m2s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 1m40s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 1m54s
Details
CI/CD Pipeline / Integration Tests (push) Successful in 1m26s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m21s
Details

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No Reviewers
auto-approve-bot
Labels
Clear labels
P0
阻塞性，必须立即处理
 P1
高优先级
 P2
中优先级
 P3
低优先级/后考虑
 architecture
架构设计
 backend
后端相关
 blocked
阻塞中
 bug
Bug修复
 ci-bug
CI本身的bug
 ci-optimization
CI优化类任务
 ci-pipeline
CI流水线/workflow相关
 cleanup
代码清理
 devops
运维/部署/CI
 documentation
文档相关
 feature
新功能
 frontend
前端相关
 question
需要讨论确认
 ready
PR CI通过，可合并
 refactor
代码重构
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
auto-approve-bot xiaoxia
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#365
Delete Branch "ci/matrix-build-parallelism"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?