xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 16 Pull Requests 8 Actions 34.2k Packages Projects Releases 7 Wiki Activity

fix(web, P0): nginx entrypoint 兼容外部 bind-mount，修复 staging 部署 web 无法启动 #1857

Closed
xiaoxia wants to merge 1 commits from fix/nginx-entrypoint-mount-conflict into develop
pull from: fix/nginx-entrypoint-mount-conflict
merge into: xiaoxia:develop
Conversation 3 Commits 1 Files Changed 1
+28 -13

1 Commits

Author SHA1 Message Date
xiaoxia 72aa5009be fix(web, P0): nginx entrypoint 兼容外部 bind-mount 部署，修复 staging 部署后 web 无法启动
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 2s
Details
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 3s
Details
CI/CD Pipeline / PR Build API Image (pull_request) Successful in 14s
Details
CI/CD Pipeline / PR Build Worker Image (pull_request) Successful in 15s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m34s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 1m52s
Details
CI/CD Pipeline / Validate - Style (pull_request) Successful in 2m5s
Details
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 2m10s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 2m59s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m25s
Details
CI/CD Pipeline / Validate - Security (pull_request) Successful in 8m26s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 9m48s
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 1s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 9m55s
Details
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 5s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 22s
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Failing after 123h54m50s
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Failing after 124h3m11s
Details
CI/CD Pipeline / Retag skipped Staging Worker Image (pull_request) Failing after 124h3m28s
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Failing after 124h4m44s
Details
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Failing after 124h3m14s
Details
CI/CD Pipeline / Retag skipped Staging API Image (pull_request) Failing after 124h3m15s
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Failing after 124h3m30s
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Failing after 124h4m29s
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Failing after 124h4m30s
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Failing after 123h54m35s
Details
CI/CD Pipeline / Build Production API Image (pull_request) Failing after 123h54m35s
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Failing after 123h54m31s
Details
CI/CD Pipeline / Deploy Production (pull_request) Failing after 123h54m31s
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Failing after 124h2m56s
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Failing after 124h2m56s
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Failing after 124h3m1s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Failing after 124h3m46s
Details
CI/CD Pipeline / Check push changed paths (pull_request) Failing after 124h4m33s
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Failing after 124h38m53s
Details 
根因：PR #1853 引入 nginx-entrypoint.sh 用于按 APP_ENV 切换配置，
但 staging/production CI 部署脚本通过
  -v /path/nginx-staging.conf:/etc/nginx/conf.d/default.conf:ro
把环境配置以只读 bind mount 提供，default.conf 已经是正确配置。
entrypoint 里的 rm -f 在只读挂载点失败，set -e 导致脚本直接退出，
nginx 从未启动，30s 健康检查失败触发自动回滚。
回滚到旧镜像（29ca51d，PR #1853 本身）后问题依然存在——
说明 PR #1853 引入的 entrypoint 本身就与现有部署方式不兼容，
第一次部署就已失败，#1855 的 rm+ln 修复只是解决了 alpine ln -sf 在
普通文件上的行为问题，未解决 bind-mount 冲突。

修复：entrypoint 检测 default.conf 是否可被 rm 替换：
- 可删（镜像自包含普通文件）：按 APP_ENV 建立正确 symlink
- rm 失败（外部只读 bind mount）：跳过替换，直接启动 nginx
 2026-09-11 11:16:27 +08:00