容量管理: zones.rs 直读 nginx file_cache 共享内存记账(双轴: 磁盘 + keys_zone 索引内存), ?scan=1 扫盘上限 20 万文件; POST /api/admin/cache/purge 整区清理(只删文件不删目录, 根治 [crit] mkdir failed); POST /api/admin/cache/invalidate 按制品精准失效(预览->确认两步式, glob/子串, 删除上限 5000/扫描上限 20 万); GET /api/admin/cache 新增 capacity 块; 前端容量面板 + 按制品失效工具条; 测试 test-cache-capacity.sh 48/48(容量 27 + 精准失效 21, 含 EXPECT_MIN 护栏与前端静态契约); docs 容量管理章节
83 lines
4.4 KiB
Bash
Executable File
83 lines
4.4 KiB
Bash
Executable File
#!/bin/bash
|
||
# ============================================================================
|
||
# 生产配置语法校验:把 conf/ 下的生产配置渲染到沙箱,跑 `nginx -t`。
|
||
#
|
||
# 验证点(不做真实回源):
|
||
# * load_module 能加载 ipass 模块(含 plugin-cache)
|
||
# * ipass_state / ipass_data_dir / ipass_audit_dir / ipass_cache / ipass_api 指令被接受
|
||
# * 变量式 `proxy_pass $cache_target` 被接受,且 `resolver` 已声明
|
||
# (变量上游没 resolver 会在运行期 500,配置期看不出,所以这里也断言 resolver 在)
|
||
# * **SSL 在本构建里真的可用**:conf/server.cache.conf / cache-routes.conf /
|
||
# cache-common.conf 都用了 `proxy_ssl_server_name`(上游 https 必需),
|
||
# 若拿无 SSL 的 nginx 来校验会报 unknown directive —— 这正是要拦的情况
|
||
# * 六生态 proxy_cache_path 目录可创建
|
||
# * include conf/server.cache.conf / cache-routes.conf / cache-common.conf
|
||
# 与 tls/*.conf 空匹配都解析正确
|
||
#
|
||
# ⚠️ 与旧版(静态上游版)的区别:上游地址与凭据**已不在 conf 里**,全在
|
||
# plugin-cache 的上游表(data/cache-upstreams.json → 写穿共享内存)。
|
||
# 所以这里**不再需要**把 https:// 降级成 http:// —— 配置里根本没有字面量上游。
|
||
# 同理也不再剔除 proxy_ssl_*:那会让「SSL 构建可用」这个验证点凭空消失。
|
||
# ============================================================================
|
||
set -uo pipefail
|
||
|
||
HERE=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
|
||
REPO=$(cd "$HERE/../.." && pwd)
|
||
RUN="$HERE/.run-prod"
|
||
NGINX_BIN=${NGINX_BIN:-$REPO/build/nginx-1.30.4/objs/nginx}
|
||
MODULE=${MODULE:-$REPO/rust/target/debug/libipass_gateway.dylib}
|
||
|
||
[ -x "$NGINX_BIN" ] || { echo "错误:nginx 不存在 $NGINX_BIN" >&2; exit 1; }
|
||
[ -f "$MODULE" ] || { echo "错误:模块不存在 ${MODULE}(先 cargo build)" >&2; exit 1; }
|
||
|
||
# 前置闸门:本校验依赖 SSL 模块在编(conf 里有 proxy_ssl_server_name)。
|
||
# 先自检,避免用错二进制时得到一串难懂的 unknown directive。
|
||
if ! "$NGINX_BIN" -V 2>&1 | grep -q -- '--with-http_ssl_module'; then
|
||
echo "❌ 该 nginx 未编译 http_ssl_module,无法校验生产配置:" >&2
|
||
echo " $NGINX_BIN" >&2
|
||
echo " 生产 conf 用了 proxy_ssl_server_name(上游 https 必需)。" >&2
|
||
echo " 请先:bash build/build-nginx-ssl.sh(产物 build/nginx-1.30.4/objs/nginx)" >&2
|
||
exit 1
|
||
fi
|
||
|
||
# 清掉上一次的 conf 副本(其余子树不必清:渲染会覆盖同名文件)。
|
||
# ⚠️ 不要写 `rm -rf "$RUN"`:本机批量删除护栏超过阈值会**拒绝整个删除且不报错**,
|
||
# 于是上一轮残留的 conf 会被当成"本次校验通过"(静默假绿)。实测见 .run-prod。
|
||
mkdir -p "$RUN/conf/tls" "$RUN/logs" "$RUN/data" "$RUN/audit" \
|
||
"$RUN/cache/go" "$RUN/cache/cargo" "$RUN/cache/pypi" \
|
||
"$RUN/cache/npm" "$RUN/cache/maven" "$RUN/cache/docker"
|
||
find "$RUN/conf" -maxdepth 1 -type f -delete >/dev/null 2>&1
|
||
|
||
# 渲染:**借 e2e/Tier2 同一套** lib-render.sh,别在这里自己再写一份 sed 替换。
|
||
# 自己写的那份会漏掉 renderer 后续新增的项(端口、worker、tls include…),
|
||
# 结果就是"校验的 conf" 与 "实跑的 conf" 悄悄分叉 —— 正是 Tier2 挂掉的那类根因。
|
||
# 端口用 18086(`-t` 不绑定端口,取个不与 run.sh 其它实例重的值只为可读)。
|
||
CACHE_PY="${PY:-python3}"; export CACHE_PY
|
||
# shellcheck source=tests/cache/lib-render.sh
|
||
source "$HERE/lib-render.sh"
|
||
cache_render_prod_conf "$RUN" 18086 "$MODULE"
|
||
echo " (沙箱校验:借 lib-render.sh 渲染,未做任何指令降级——SSL 在编,如实校验)"
|
||
|
||
export ADMIN_INIT_PASSWORD="validate_only_pw"
|
||
|
||
echo "── nginx -t(生产配置:conf/nginx.cache.conf)──"
|
||
if "$NGINX_BIN" -p "$RUN" -c conf/nginx.cache.conf -t 2>"$RUN/logs/error.log"; then
|
||
# 反向断言:变量式 proxy_pass 必须配 resolver,否则运行期一律 500
|
||
if grep -qE '^[[:space:]]*resolver[[:space:]]' "$RUN/conf/nginx.cache.conf"; then
|
||
echo "✅ resolver 已声明(变量上游运行期解析的必需项)"
|
||
else
|
||
echo "❌ 缺 resolver:变量式 proxy_pass 会在运行期报 no resolver defined" >&2
|
||
exit 1
|
||
fi
|
||
echo "✅ 生产配置语法与模块加载校验通过"
|
||
rc=0
|
||
else
|
||
echo "❌ 生产配置校验失败:" >&2
|
||
cat "$RUN/logs/error.log" >&2
|
||
rc=1
|
||
fi
|
||
|
||
echo
|
||
echo " 渲染后的配置:$RUN/conf/nginx.cache.conf"
|
||
exit $rc
|