Web 服务器与网关 / 系统课时
整理 Nginx 上线检查清单
整理 Nginx 上线检查清单
上线清单应帮助任何接手的人确认入口、行为和回退证据,而不只是列出执行过的命令。本篇把本章练习整理为发布前、发布后和持续观察三组检查,并提供一段范围明确的入口冒烟脚本,保留尚需人工或环境验证的项目。
学习目标
- 为域名、路由、代理、TLS 与资源设置检查证据。
- 自动执行无副作用的基础入口请求。
- 将通过、未验证与回退条件写入发布记录。
发布前确认版本和恢复入口
记录发布编号、时间、实例清单、二进制版本、主配置及 include 的哈希,核对上一可用版本与恢复演练。用运行实例相同的参数检查候选配置,确认操作的是目标实例,而非另一套安装。
| 项目 | 应保存的证据 |
|---|---|
| 域名与入口 | DNS、IPv4/IPv6、CDN 和实例地址清单 |
| 路径与错误边界 | 页面、assets、API、未知 Host 的矩阵 |
| 代理与来源 | URI、Host、可信来源和协议对照 |
| TLS | 名称、信任链、有效期、更新计划 |
| 文件与凭据 | Worker 所需权限,私钥受控可读 |
| 日志与限制 | 日志可写、请求标识、限流拒绝与恢复 |
| 回退 | 已验证版本、负责人和触发条件 |
自动执行基础入口冒烟
以下完整 Bash 脚本只适用于本章 HTTPS 课的 app.test 实验:8080 跳转、8443 TLS、静态目录和两个健康后端都已运行,证书文件仍在指定位置。它只做只读请求,不代表整张清单全部通过。
set -euo pipefail
tls=(--noproxy '*' --cacert /tmp/nginx-entry-tls/cert.pem --resolve app.test:8443:127.0.0.1 -sS)
status=$(curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w '%{http_code}' http://app.test:8080/account)
test "$status" = 308
curl "${tls[@]}" -f -o /dev/null https://app.test:8443/account
asset=$(cat /tmp/nginx-web-entry/asset-name.txt)
curl "${tls[@]}" -f -o /dev/null "https://app.test:8443/assets/$asset"
curl "${tls[@]}" -f https://app.test:8443/api/health | grep -Eq '^(A|B) /api/health$'
status=$(curl "${tls[@]}" -o /dev/null -w '%{http_code}' https://app.test:8443/assets/missing.js)
test "$status" = 404
printf 'entry-smoke=passed\n'预期输出 entry-smoke=passed,任一 TLS、状态或健康正文检查失败都会使脚本非零退出。证书信任验证保留,没有使用 -k;资源类型、缓存、来源头与限流仍需各自对应的检查程序。
发布后沿真实用户链路验证
检查重载日志与 Worker 交接,再从实际入口访问关键页面、脚本、只读 API、错误路径和受保护路径。多台实例逐一核对版本,确认查询参数、编码路径和必要方法保持约定行为。
测试 CDN 与浏览器缓存,检查旧 HTML 引用的资源仍能加载。公开环境还需真实受信任证书及域名解析验证,本机 --resolve 和实验自签凭据不能替代这些项目。
记录限制与停止条件
每项标为通过、失败或未验证,并附请求、日志、时间窗口及执行环境。没有环境或权限的项目应明确保留未验证,不能把预期现象写成已经实测。
日志检查包括写入、查询、轮转、保留和隐私;限流包含正常流量、突发、持续超额与恢复;权限和认证包含应拒绝的请求。生产容量与故障切换还需要独立的受控测试,不能仅凭本机冒烟判断。
持续观察并保留回退证据
发布后比较错误率、延迟分位数、活动连接、CPU、内存、FD、临时磁盘与上游状态。超过约定阈值时按已演练流程回退,恢复后重新执行关键请求。
最终记录实际生效版本、全部实例结果、尚未验证项与后续负责人。清单应随架构、版本和业务变化维护;一次成功上线不能永久替代证书续期、容量和恢复验证。