Web 服务器与网关 / 系统课时

整理 Nginx 上线检查清单

整理 Nginx 上线检查清单

上线清单应帮助任何接手的人确认入口、行为和回退证据,而不只是列出执行过的命令。本篇把本章练习整理为发布前、发布后和持续观察三组检查,并提供一段范围明确的入口冒烟脚本,保留尚需人工或环境验证的项目。

学习目标

  • 为域名、路由、代理、TLS 与资源设置检查证据。
  • 自动执行无副作用的基础入口请求。
  • 将通过、未验证与回退条件写入发布记录。

发布前确认版本和恢复入口

记录发布编号、时间、实例清单、二进制版本、主配置及 include 的哈希,核对上一可用版本与恢复演练。用运行实例相同的参数检查候选配置,确认操作的是目标实例,而非另一套安装。

项目 应保存的证据
域名与入口 DNS、IPv4/IPv6、CDN 和实例地址清单
路径与错误边界 页面、assets、API、未知 Host 的矩阵
代理与来源 URI、Host、可信来源和协议对照
TLS 名称、信任链、有效期、更新计划
文件与凭据 Worker 所需权限,私钥受控可读
日志与限制 日志可写、请求标识、限流拒绝与恢复
回退 已验证版本、负责人和触发条件

自动执行基础入口冒烟

以下完整 Bash 脚本只适用于本章 HTTPS 课的 app.test 实验:8080 跳转、8443 TLS、静态目录和两个健康后端都已运行,证书文件仍在指定位置。它只做只读请求,不代表整张清单全部通过。

bash
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、临时磁盘与上游状态。超过约定阈值时按已演练流程回退,恢复后重新执行关键请求。

最终记录实际生效版本、全部实例结果、尚未验证项与后续负责人。清单应随架构、版本和业务变化维护;一次成功上线不能永久替代证书续期、容量和恢复验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理 Nginx 上线检查清单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通