From 4ece137786e7c31ada242b8d5123815ef6dcf2d3 Mon Sep 17 00:00:00 2001
From: saas-frontend-agent <agent@coze>
Date: Fri, 11 Sep 2026 11:02:42 +0800
Subject: [PATCH] =?UTF-8?q?fix(web,=20P0):=20nginx=20entrypoint=20?=
 =?UTF-8?q?=E5=9C=A8=20CI=20bind=20mount=20=E5=9C=BA=E6=99=AF=E4=B8=8D?=
 =?UTF-8?q?=E5=BA=94=20rm=20default.conf?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

部署脚本（ci_staging_deploy.sh / ci_production_deploy.sh）通过
-v 宿主机nginx配置:/etc/nginx/conf.d/default.conf:ro 把配置 bind mount
进容器。#1853 引入 entrypoint 按 APP_ENV 切换 symlink 的逻辑，但没考虑
CI 部署路径：
- #1853 用 ln -sf，busybox 在 target 为普通文件时会把子链接建到 target 目录里，
  nginx 读不到配置，web 容器循环重启。
- #1855 改为先 rm -f 再 ln -s，但对 bind mount readonly 的文件 rm 会报
  'Resource busy' (EBUSY)，set -e 下脚本直接退出，nginx 没起，
  30s 健康检查失败 → 自动回滚 → 回滚到老镜像（29ca51da）也有同样问题
  → staging 永久 502。

修复：entrypoint 分三种场景处理：
1. default.conf 已经是指向目标 conf 的 symlink：什么都不做直接 exec nginx；
2. 镜像原生场景（无外部挂载）：rm -f + ln -s 切换 symlink；
   rm 失败（bind mount readonly, EBUSY/EROFS）说明外部已注入配置，
   用 || true 吞错，跳过 ln；
3. 兜底：只要 conf.d 下有 .conf 文件就启动，缺失才报错退出。

本地模拟两种路径均验证通过：
- bind mount readonly 场景：rm 失败不阻塞，使用外部配置启动；
- 无挂载本地/开发场景：成功 rm 旧文件并建立正确 symlink。
---
 infra/docker/nginx-entrypoint.sh | 44 +++++++++++++++++++++++++-------
 1 file changed, 35 insertions(+), 9 deletions(-)

diff --git a/infra/docker/nginx-entrypoint.sh b/infra/docker/nginx-entrypoint.sh
index a0ca7653b..1006d4202 100755
--- a/infra/docker/nginx-entrypoint.sh
+++ b/infra/docker/nginx-entrypoint.sh
@@ -1,23 +1,49 @@
 #!/bin/sh
 # Select nginx config based on APP_ENV (staging/production).
-# Both configs are baked into the image at well-known paths.
-# nginx reads config only at startup, so symlink before exec.
-# 注意：基础镜像 /etc/nginx/conf.d/default.conf 是普通文件（非 symlink/目录），
-# alpine busybox ln -sf 在 target 已存在且为普通文件时行为不稳定（会尝试在
-# target 目录下建子链接），必须先 rm 再 ln 才能正确替换。
+#
+# 两种运行模式：
+# 1. CI/CD 部署（staging/production）：部署脚本通过 `-v 宿主机文件:/etc/nginx/conf.d/default.conf:ro`
+#    把宿主机生成的带 resolver/docker upstream 的配置 bind mount 进来，entrypoint 不应改动。
+#    bind mount 的文件是 readonly 的，rm 会报 EBUSY ("Resource busy")，直接 exec nginx 即可。
+# 2. 本地 docker-compose / 直接 `docker run`（无外部挂载）：镜像烤入了 nginx-staging.conf 与
+#    nginx-production.conf 到 /etc/nginx/，entrypoint 根据 APP_ENV 把 default.conf 换成正确的 symlink。
+#
+# 策略：
+# - 如果 /etc/nginx/conf.d/default.conf 已经是指向目标 conf 的 symlink，什么都不做；
+# - 否则尝试 rm -f 再 ln -s；rm 失败说明是外部 bind mount（已有正确配置），不阻塞启动；
+# - 兜底：只要 conf.d 目录里有 .conf 文件（含 bind mount 来的），就直接启动 nginx。
 set -e
 
 NGINX_CONF_DIR="/etc/nginx/conf.d"
+TARGET_CONF=""
 
 case "${APP_ENV:-production}" in
   staging)
-    rm -f "$NGINX_CONF_DIR/default.conf"
-    ln -s /etc/nginx/nginx-staging.conf "$NGINX_CONF_DIR/default.conf"
+    TARGET_CONF="/etc/nginx/nginx-staging.conf"
     ;;
   *)
-    rm -f "$NGINX_CONF_DIR/default.conf"
-    ln -s /etc/nginx/nginx-production.conf "$NGINX_CONF_DIR/default.conf"
+    TARGET_CONF="/etc/nginx/nginx-production.conf"
     ;;
 esac
 
+DEFAULT_CONF="$NGINX_CONF_DIR/default.conf"
+
+# 1. 已经是正确的 symlink：直接启动
+if [ -L "$DEFAULT_CONF" ] && [ "$(readlink "$DEFAULT_CONF" 2>/dev/null)" = "$TARGET_CONF" ]; then
+  exec nginx -g "daemon off;"
+fi
+
+# 2. 尝试替换为目标 symlink（无 bind mount 的场景）
+#    若 rm 失败（bind mount readonly，EBUSY/EPERM），则认为外部已注入配置，不阻塞。
+rm -f "$DEFAULT_CONF" 2>/dev/null || true
+if [ -f "$TARGET_CONF" ] && [ ! -e "$DEFAULT_CONF" ]; then
+  ln -s "$TARGET_CONF" "$DEFAULT_CONF" 2>/dev/null || true
+fi
+
+# 3. 兜底：至少要有一个 .conf 文件，否则 nginx 起不来
+if ! ls "$NGINX_CONF_DIR"/*.conf >/dev/null 2>&1; then
+  echo "ERROR: no nginx config found in $NGINX_CONF_DIR (tried $TARGET_CONF and external bind mount)" >&2
+  exit 1
+fi
+
 exec nginx -g "daemon off;"