在自动化发布脚本中统一管理 nginx 的 root 指令，核心做法是放弃硬编码路径，改为使用变量或模板引擎动态生成配置文件。具体而言，应在 nginx 配置中使用 $document_root 变量结合 set 指令定义基础目录，或在 ci/cd 流水线中通过 sed、envsubst 或 jinja2 等工具替换模板中的占位符。这样做能确保每次部署时，nginx 自动指向当前版本的具体目录（如 /var/www/app/v1.2.3），无需人工修改配置即可实现无缝切换。
如何在 Nginx 配置中定义可变的根目录变量
要在 Nginx 层面支持动态路径，最直接的方法是在 server 块中定义一个变量来存储根目录路径，并在 location 块中引用该变量。这样，你只需要在发布脚本中更新这个变量的值，或者通过环境变量注入该值，Nginx 就会读取新的路径。这种方法避免了在每个 location 中重复编写绝对路径，也减少了配置文件的冗余。
server {
listen 80;
server_name example.com;
# 定义根目录变量，默认值为 /var/www/html
set $document_root /var/www/html;
location / {
root $document_root;
index index.html;
}
}
上述配置中，set $document_root 定义了基础路径。在实际操作中，你可以让发布脚本在重启 Nginx 前，通过 nginx -s reload 加载包含新变量值的配置。如果配合环境变量，可以在启动容器或进程时直接传入 DOCUMENT_ROOT，然后在 Nginx 配置中使用 map 或直接引用环境变量（需 Nginx Plus 或特定模块支持，通常推荐用脚本替换）。
如何利用 CI/CD 脚本动态替换 Nginx 配置模板
更稳健的做法是在 CI/CD 流程中，将 Nginx 配置作为模板文件处理。发布脚本在构建阶段读取模板，根据当前版本号或 Git Commit ID 生成最终的 nginx.conf 或站点配置文件。这种方式将路径管理完全集中在脚本层，Nginx 只负责加载最终生成的静态配置，降低了运行时配置的复杂性。
# 假设有一个模板文件 nginx.conf.template
# 内容如下：
# server {
# listen 80;
# server_name example.com;
# root {{ROOT_PATH}};
# location / {
# try_files $uri $uri/ =404;
# }
# }
# 发布脚本示例 (Bash)
VERSION="v$(date +%Y%m%d%H%M%S)"
ROOT_PATH="/var/www/app/${VERSION}"
# 创建目标目录
mkdir -p ${ROOT_PATH}
# 复制静态资源到目标目录
cp -r dist/* ${ROOT_PATH}/
# 使用 envsubst 替换模板中的变量
export ROOT_PATH
envsubst '${ROOT_PATH}' /etc/nginx/sites-available/default
# 测试配置并重载 Nginx
nginx -t && nginx -s reload
在这个流程中，envsubst 是一个轻量级工具，它能识别并替换环境变量。脚本首先确定新版本号，创建对应目录，部署文件，然后生成配置并重载 Nginx。这种方法确保了配置与部署状态的一致性，且易于回滚——只需指向旧版本的目录并重新生成配置即可。
当新版本部署失败时如何快速回滚到上一版本
在自动化发布中，回滚是关键环节。基于上述模板化方案，回滚的本质是将 ROOT_PATH 指向之前的有效目录，并重新加载配置。由于我们使用了版本号或时间戳作为目录名，可以通过查询文件系统或维护一个简单的版本索引文件来实现快速切换。例如，保留最近两个版本的目录，当新版本验证失败时，脚本立即将符号链接或配置中的路径指回旧目录。
# 回滚脚本示例
OLD_VERSION="v$(date -d '1 hour ago' +%Y%m%d%H%M%S)" # 实际场景中应从日志或索引获取
NEW_VERSION="v$(date +%Y%m%d%H%M%S)"
# 检查新版本是否健康（此处简化为手动触发或健康检查接口）
if ! curl -sf http://localhost/health; then
echo "Health check failed, rolling back..."
# 更新配置指向旧版本
export ROOT_PATH="/var/www/app/${OLD_VERSION}"
envsubst '${ROOT_PATH}' /etc/nginx/sites-available/default
# 重载 Nginx
nginx -t && nginx -s reload
echo "Rolled back to ${OLD_VERSION}"
else
echo "Deployment successful"
fi
这种机制依赖于目录结构的清晰命名和配置生成的原子性。只要旧目录存在且配置正确，回滚操作可以在秒级完成，无需重新构建或部署代码，极大提高了系统的可用性。
