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

fix(ci): 修复registry不稳定导致镜像构建失败 - 解耦缓存推送 #357

Merged
xiaoxia merged 1 commits from ci/registry-cache-stability-fix into develop 2026-07-15 12:55:13 +08:00
Conversation 1 Commits 1 Files Changed 2
+149 -56
xiaoxia commented 2026-07-15 11:47:18 +08:00
Owner
Copy Link
Copy Source

问题

Worker镜像构建失败，错误为 use of closed network connection，发生在 buildx 推送缓存到 registry 阶段。

根因：Gitea 内置 registry 在传输大缓存层时连接不稳定，长连接被断开。虽然镜像本身已构建完成，但缓存推送失败导致整个构建步骤失败。

修复方案

1. 构建与缓存解耦（核心修复）

创建 scripts/ci/docker_build_push.sh 通用构建脚本：

  • Step 1: 构建+推送镜像（只读缓存模式），保证主构建100%成功
  • Step 2: 单独尝试推送缓存，自动重试3次，失败不影响主构建结果

2. 缓存优化

  • 缓存使用 mode=min + compression=zstd + oci-mediatypes=true 减小传输体积
  • 缓存引用改为按分支名区分，支持多分支独立缓存

3. 覆盖范围

全部6个镜像构建job（Staging/Production x API/Worker/Web）

验证

  • CI三门禁通过
  • Staging构建成功（核心验证目标）
  • 缓存推送在重试后成功或优雅降级
## 问题 Worker镜像构建失败，错误为 `use of closed network connection`，发生在 buildx 推送缓存到 registry 阶段。 根因：Gitea 内置 registry 在传输大缓存层时连接不稳定，长连接被断开。虽然镜像本身已构建完成，但缓存推送失败导致整个构建步骤失败。 ## 修复方案 ### 1. 构建与缓存解耦（核心修复） 创建 `scripts/ci/docker_build_push.sh` 通用构建脚本： - **Step 1**: 构建+推送镜像（只读缓存模式），保证主构建100%成功 - **Step 2**: 单独尝试推送缓存，自动重试3次，失败不影响主构建结果 ### 2. 缓存优化 - 缓存使用 `mode=min` + `compression=zstd` + `oci-mediatypes=true` 减小传输体积 - 缓存引用改为按分支名区分，支持多分支独立缓存 ### 3. 覆盖范围 全部6个镜像构建job（Staging/Production x API/Worker/Web） ## 验证 - [ ] CI三门禁通过 - [ ] Staging构建成功（核心验证目标） - [ ] 缓存推送在重试后成功或优雅降级
xiaoxia force-pushed ci/registry-cache-stability-fix from f55d574291 to c94ce7c1e1 2026-07-15 12:14:31 +08:00 Compare
xiaoxia force-pushed ci/registry-cache-stability-fix from c94ce7c1e1 to 446e3500f6 2026-07-15 12:17:56 +08:00 Compare
xiaoxia added 1 commit 2026-07-15 12:33:05 +08:00
fix(ci): 修复registry不稳定导致构建失败 - 构建与缓存推送解耦
CI/CD Pipeline / Frontend Lint (push) Successful in 1m32s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m31s
Details
CI/CD Pipeline / Validate Code Quality And Tests (pull_request) Successful in 2m44s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 2m49s
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate Code Quality And Tests (push) Successful in 2m52s
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 / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (push) Successful in 2m54s
Details
CI/CD Pipeline / Build Staging API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production API Image (push) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (push) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (push) Has been skipped
Details
CI/CD Pipeline / Deploy Production (push) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (push) Has been skipped
Details
CI/CD Pipeline / Staging E2E Tests (push) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (push) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m29s
Details
CI/CD Pipeline / Integration Tests (push) Successful in 1m25s
Details
99fa146a5c 
- 新增docker_build_push.sh通用脚本
- 构建镜像（只读缓存）与推送缓存分离
- 缓存推送失败重试3次，不影响主构建结果
- 使用zstd压缩缓存层
xiaoxia force-pushed ci/registry-cache-stability-fix from 1058801264 to 99fa146a5c 2026-07-15 12:33:05 +08:00 Compare
auto-approve-bot approved these changes 2026-07-15 12:50:02 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
xiaoxia merged commit d3ed0bb4ba into develop 2026-07-15 12:55:13 +08:00
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#357
Delete Branch "ci/registry-cache-stability-fix"

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?