WMS_MAIN/script/deploy-cert-sync.cjs
liufumingren 0918f2d572 feat(deploy): 证书同步改为单片段 include + ver 命名 + 声明式自愈与差集下线
- 站点内容外置为单一片段(upstreamInclude,运维维护):生成的 server 块 = 证书骨架 +
  一行 include <片段>,撤掉此前的 customDir 多片段方案;并强制 include 必须是绝对路径
  且文件已存在(nginx 解析相对 include 的基准是 nginx prefix,不是脚本 cwd,写相对路径
  会让 nginx -t 失败并回滚整轮变更),不满足直接 exit 1(dry-run 下仅告警)
- conf 命名加版本位 <domain>-<ver>.conf:轮转只改配置的 ver,旧命名自动清理并 reload
- 声明式对账自愈:证书 / 私钥 / server 块缺失或被改坏,按库内内容原子重建后统一
  nginx -t + reload(内容一致时零写入、零 reload);失败态(sync_status=2)同样参与
  收敛并在校验通过后回到 1;nginx -t / reload 属全局失败,只落 last_sync_error 下轮
  重试,不再把行写成 2 卡死
- 域名下线改为配置差集驱动:以「已配置 + 已验证 + 证书就绪」的期望集合为准(同一仓库
  只取 id 最小的一条),目录中属于本系统命名规则但配置里已无该域名的 conf / 证书直接
  删除并 reload;不再消费 retired_domain(该列仅作应用侧审计留痕)
- 证书未配置的行不写 conf 也不作为文件保留依据(遗留产物由差集回收,避免 conf 引用
  不存在的证书导致 nginx -t 全局失败),行状态回写 sync_status=0 待同步;证书非空但
  非法、域名形态非法才记行级失败(2)
- cert-sync 部署命令瘦身为 install / uninstall;新增 watchdog 部署命令(precheck /
  install / status / dry-run / run),安装路径统一到 script/;deploy-lib 保护生产运行时
  配置不被发布覆盖;README 补「发布与运维」章节(目录硬约定 / 定时任务 / 命令清单)
2026-09-28 01:02:23 +08:00

568 lines
26 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/**
* cert-sync 部署工具(npm 命令仅 install / uninstall 两条)。
*
* - install:校验并上传主脚本 / DB 配置;prod 配置按「首次放置一次、永不覆盖」约定处理;
* 生成薄包装 <deployRoot>/script/warehouse-cert-sync.sh 并注册 root crontab(每分钟 flock)。
* - uninstall:先备份再删除工具自身(包装脚本 / 主脚本 / 双环境配置 / database/config.js /
* 历史位置与 .prev-* / .legacy-* 备份 / crontab 行);支持 --dry-run 只打印计划。
* 证书、nginx server 块、日志、watchdog 相关一律不删(原因见输出)。
*
* 运行期手动操作仍可直接调用服务器上的包装脚本(这是主脚本 CLI 的能力,不属于本工具 npm 命令):
* <deployRoot>/script/warehouse-cert-sync.sh --dry-run
* <deployRoot>/script/warehouse-cert-sync.sh --cleanup-only --dry-run
* <deployRoot>/script/warehouse-cert-sync.sh --cleanup-only
* <deployRoot>/script/warehouse-cert-sync.sh --env production
*/
'use strict';
const fs = require('node:fs');
const path = require('node:path');
const {
ROOT,
getNowStamp,
loadDeployConfig,
quoteForBash,
runScp,
runSsh,
} = require('./deploy-lib.cjs');
const COMMANDS = new Set([ 'install', 'uninstall' ]);
const LOCAL_SYNC_SCRIPT = path.join(ROOT, 'script', 'warehouse-cert-sync.cjs');
const LOCAL_DB_CONFIG = path.join(ROOT, 'database', 'config.js');
const LOCAL_PROD_CONFIG = path.join(ROOT, 'script', 'warehouse-cert-sync.config.prod.json');
/**
* 打印本工具用法(仅 install / uninstall 两条 npm 命令)。
*/
function printUsage() {
console.error([
'usage: node script/deploy-cert-sync.cjs [env] <command> [--dry-run]',
' env: production | development(默认 production)',
' command: install 上传脚本/配置、生成薄包装、注册 crontab',
' uninstall 备份并删除工具自身(脚本/配置/crontab),支持 --dry-run',
'运行期手动操作请直接调用服务器上的包装脚本(主脚本 CLI 能力,非本工具命令):',
' <deployRoot>/script/warehouse-cert-sync.sh --dry-run',
' <deployRoot>/script/warehouse-cert-sync.sh --cleanup-only --dry-run',
' <deployRoot>/script/warehouse-cert-sync.sh --cleanup-only',
' <deployRoot>/script/warehouse-cert-sync.sh --env production',
].join('\n'));
}
/**
* 解析命令行参数。
* @param {string[]} argv 原始参数数组(不含 node / 脚本名)。
* @return {{ envName: string, command: string, dryRun: boolean }} 解析结果。
*/
function parseArgs(argv) {
const options = { envName: 'production', command: '', dryRun: false };
const tokens = [ ...argv ];
options.dryRun = tokens.includes('--dry-run');
const positional = tokens.filter(token => token !== '--dry-run');
if (positional.length === 0) {
printUsage();
throw new Error('missing command: install | uninstall');
}
if (!COMMANDS.has(positional[0])) {
options.envName = positional[0];
positional.shift();
}
if (positional.length === 0 || !COMMANDS.has(positional[0])) {
printUsage();
throw new Error('missing command: install | uninstall');
}
options.command = positional[0];
return options;
}
/**
* Build the thin shell wrapper content for the server.
* 薄包装职责收敛为:
* 1. cd 部署根目录(脚本以部署根为 cwd 运行,certDir/confDir 按 prod 配置解析);
* 2. 运行时依赖引导:从活跃实例 node_modules 借用 sequelize(部署根无 node_modules);
* 3. 运行时 DB 引导:从活跃实例 egg 配置解析 DB_* 环境变量(不落盘、不打印凭据);
* 4. 执行 node script/warehouse-cert-sync.cjs --env production "$@"。
* nginx 二进制 / upstream include / reload 命令已全部收敛到
* script/warehouse-cert-sync.config.prod.json,本包装不再注入任何 nginx 相关参数。
*/
function buildWrapperContent() {
return `#!/usr/bin/env bash
# ==============================================================
# warehouse-cert-sync thin shell wrapper (installed by wms-deploy-agent)
# 1. cd into deploy root; cert/conf default to ../.ssl and ../nginx_config
# 2. nginx binary / upstream include / reload 命令全部来自 prod 配置文件
# 3. resolve prod DB connection at runtime from the ACTIVE instance egg
# config (exported as DB_* env vars only; not persisted, never printed)
# 4. dependency resolution: borrow sequelize from active instance node_modules
# 5. all output appended to /var/log/warehouse-cert-sync.log (tee to tty)
# ==============================================================
set -uo pipefail
DEPLOY_ROOT='/www/wwwroot/qimen'
LOG_FILE='/var/log/warehouse-cert-sync.log'
exec > >(tee -a "$LOG_FILE") 2>&1
echo "===== $(date '+%F %T') warehouse-cert-sync.sh args=[$*] ====="
cd "$DEPLOY_ROOT" || { echo "[CERT-WRAPPER] FATAL cannot enter $DEPLOY_ROOT"; exit 1; }
# ---------- nginx 参数来源 ----------
# nginx 二进制 / upstream include / reload 命令全部由
# script/warehouse-cert-sync.config.prod.json 提供(--env production 自动加载),
# 本包装不再注入 --nginx-bin / --upstream-include / --reload-cmd 参数。
# ---------- runtime dependency resolution ----------
# borrow sequelize etc. from the active instance node_modules via NODE_PATH
if [ ! -d "$DEPLOY_ROOT/node_modules" ]; then
ACTIVE_VERSION=''
if [ -f "$DEPLOY_ROOT/current.md" ]; then
ACTIVE_VERSION="$(tr -d '[:space:]' < "$DEPLOY_ROOT/current.md")"
fi
for CAND in "$ACTIVE_VERSION" v1 v2; do
if [ -n "$CAND" ] && [ -d "$DEPLOY_ROOT/$CAND/node_modules" ]; then
export NODE_PATH="$DEPLOY_ROOT/$CAND/node_modules\${NODE_PATH:+:$NODE_PATH}"
echo "[CERT-WRAPPER] NODE_PATH -> $DEPLOY_ROOT/$CAND/node_modules"
break
fi
done
fi
# ---------- prod DB connection resolution ----------
# deploy root has no config dir (release mechanism ships app code only), so the
# DB connection is resolved from the active instance egg config at runtime.
ACTIVE_APP_DIR=''
if [ -n "\${ACTIVE_VERSION:-}" ] && [ -d "$DEPLOY_ROOT/$ACTIVE_VERSION/config" ]; then
ACTIVE_APP_DIR="$DEPLOY_ROOT/$ACTIVE_VERSION"
fi
if [ -z "$ACTIVE_APP_DIR" ]; then
for CAND in v1 v2; do
if [ -d "$DEPLOY_ROOT/$CAND/config" ]; then ACTIVE_APP_DIR="$DEPLOY_ROOT/$CAND"; break; fi
done
fi
if [ -z "$ACTIVE_APP_DIR" ]; then
echo '[CERT-WRAPPER] FATAL no active instance dir found (current.md / v1 / v2)'
exit 1
fi
eval "$(node -e '
const path = require("node:path");
const appDir = process.argv[1];
function load(p) {
try {
const f = require(p);
const c = typeof f === "function" ? f({ name: "cert-sync-wrapper", baseDir: appDir }) : f;
return c && typeof c === "object" ? c : {};
} catch (e) { return {}; }
}
let src = "none"; let client = null;
const def = load(path.join(appDir, "config", "config.default.js"));
if (def.sequelize && def.sequelize.host) { src = "config.default.js#sequelize"; client = def.sequelize; }
else if (def.mysql && def.mysql.clients && def.mysql.clients.wms && def.mysql.clients.wms.host) { src = "config.default.js#mysql.clients.wms"; client = def.mysql.clients.wms; }
else if (def.mysql && def.mysql.host) { src = "config.default.js#mysql"; client = def.mysql; }
if (!client) {
const loc = load(path.join(appDir, "config", "config.local.js"));
if (loc.sequelize && loc.sequelize.host) { src = "config.local.js#sequelize"; client = loc.sequelize; }
else if (loc.mysql && loc.mysql.host) { src = "config.local.js#mysql"; client = loc.mysql; }
}
if (!client) { console.error("[CERT-WRAPPER] cannot resolve db config from: " + appDir); process.exit(1); }
console.log("export DB_HOST=" + JSON.stringify(String(client.host || "")));
console.log("export DB_PORT=" + JSON.stringify(String(client.port || 3306)));
console.log("export DB_USER=" + JSON.stringify(String(client.username || client.user || "")));
console.log("export DB_PASSWORD=" + JSON.stringify(String(client.password || "")));
console.log("export DB_NAME=" + JSON.stringify(String(client.database || "wms")));
console.error("[CERT-WRAPPER] db config source: " + src + " (database=" + String(client.database || "") + ")");
' "$ACTIVE_APP_DIR")" || { echo '[CERT-WRAPPER] FATAL db config resolution failed'; exit 1; }
# ---------- run main script ----------
# nginx 二进制 / upstream include / reload 命令全部由 prod 配置文件提供
node "$DEPLOY_ROOT/script/warehouse-cert-sync.cjs" --env production "$@"
STATUS=$?
echo "===== $(date '+%F %T') warehouse-cert-sync.sh exit=$STATUS ====="
exit $STATUS
`;
}
/**
* Install: upload files, create thin shell wrapper, register root crontab.
* @param {Object} config deploy 配置对象。
*/
function runInstall(config) {
const deployRoot = config.deployRoot;
for (const [ file, label ] of [
[ LOCAL_SYNC_SCRIPT, 'script/warehouse-cert-sync.cjs' ],
[ LOCAL_DB_CONFIG, 'database/config.js' ],
]) {
if (!fs.existsSync(file)) {
throw new Error(`local file missing: ${file} (${label})`);
}
}
const remoteDirScript = [
'set -euo pipefail',
`DEPLOY_ROOT=${quoteForBash(deployRoot)}`,
`STAMP=${quoteForBash(getNowStamp())}`,
'mkdir -p "$DEPLOY_ROOT/script" "$DEPLOY_ROOT/database"',
'for p in "$DEPLOY_ROOT/script/warehouse-cert-sync.sh" "$DEPLOY_ROOT/script/warehouse-cert-sync.cjs" "$DEPLOY_ROOT/database/config.js"; do',
' if [ -f "$p" ]; then cp -a "$p" "$p.prev-$STAMP" && echo "BACKED_UP $p -> $p.prev-$STAMP"; fi',
'done',
'# 历史位置(部署根)一次性迁移:旧 wrapper 挪进 script/ 留作回滚备份,避免根目录残留孤儿',
'LEGACY="$DEPLOY_ROOT/warehouse-cert-sync.sh"',
'if [ -f "$LEGACY" ]; then mv "$LEGACY" "$DEPLOY_ROOT/script/warehouse-cert-sync.sh.legacy-$STAMP" && echo "LEGACY_MOVED $LEGACY -> $DEPLOY_ROOT/script/warehouse-cert-sync.sh.legacy-$STAMP"; fi',
].join('\n');
console.log('[INSTALL] remote dir prep + backup of existing files (wrapper installs under script/)');
console.log(runSsh(config, remoteDirScript, { stdio: 'pipe' }).trim());
const remoteScriptPath = `${deployRoot}/script/warehouse-cert-sync.cjs`;
const remoteDbConfigPath = `${deployRoot}/database/config.js`;
runScp(config, LOCAL_SYNC_SCRIPT, remoteScriptPath);
console.log(`[INSTALL] uploaded -> ${remoteScriptPath}`);
runScp(config, LOCAL_DB_CONFIG, remoteDbConfigPath);
console.log(`[INSTALL] uploaded -> ${remoteDbConfigPath}`);
// prod 配置文件:服务器「首次放置一次、之后永不覆盖」的发布约定。
// dev 配置只属于开发机,永不上传生产服务器。
if (!fs.existsSync(LOCAL_PROD_CONFIG)) {
throw new Error(`local file missing: ${LOCAL_PROD_CONFIG}`);
}
JSON.parse(fs.readFileSync(LOCAL_PROD_CONFIG, 'utf8'));
const prodConfigRemotePath = `${deployRoot}/script/warehouse-cert-sync.config.prod.json`;
const prodConfigProbeScript = [
'set -euo pipefail',
`PROD_CONFIG=${quoteForBash(prodConfigRemotePath)}`,
'if [ -f "$PROD_CONFIG" ]; then',
' echo "PROD_CONFIG_EXISTS"',
' if node -e \'JSON.parse(require("node:fs").readFileSync(process.argv[1], "utf8"))\' "$PROD_CONFIG" >/dev/null 2>&1; then',
' echo "PROD_CONFIG_JSON_VALID"',
' else',
' echo "PROD_CONFIG_JSON_INVALID"',
' fi',
'else',
' echo "PROD_CONFIG_MISSING"',
'fi',
].join('\n');
const prodConfigProbe = String(runSsh(config, prodConfigProbeScript, { stdio: 'pipe' }) || '').trim();
console.log(prodConfigProbe);
if (prodConfigProbe.includes('PROD_CONFIG_EXISTS')) {
console.log('[INSTALL] prod config already on server -> skip placement (发布约定:永不覆盖)');
} else {
runScp(config, LOCAL_PROD_CONFIG, prodConfigRemotePath);
console.log(`[INSTALL] placed once -> ${prodConfigRemotePath}`);
const verifyScript = [
'set -euo pipefail',
`node -e ${quoteForBash('JSON.parse(require("node:fs").readFileSync(process.argv[1], "utf8")); console.log("PROD_CONFIG_JSON_VALID")')} ${quoteForBash(prodConfigRemotePath)}`,
].join('\n');
console.log(String(runSsh(config, verifyScript, { stdio: 'pipe' }) || '').trim());
}
console.log('[INSTALL] dev config NOT uploaded (development-only)');
const wrapperPath = `${deployRoot}/script/warehouse-cert-sync.sh`;
const installScript = [
'set -euo pipefail',
`DEPLOY_ROOT=${quoteForBash(deployRoot)}`,
`WRAPPER=${quoteForBash(wrapperPath)}`,
'LOG_FILE="/var/log/warehouse-cert-sync.log"',
'cat > "$WRAPPER" <<\'WMS_CERT_WRAPPER_EOF\'',
buildWrapperContent(),
'WMS_CERT_WRAPPER_EOF',
'chmod 755 "$WRAPPER"',
'bash -n "$WRAPPER" && echo "WRAPPER_SYNTAX_OK"',
'touch "$LOG_FILE" && chmod 644 "$LOG_FILE" && echo "LOG_FILE_OK"',
'FLOCK_BIN=$(command -v flock || true)',
'if [ -z "$FLOCK_BIN" ]; then echo "FATAL: flock not found, cannot register crontab"; exit 1; fi',
'echo "FLOCK_BIN=$FLOCK_BIN"',
'CRON_LINE="* * * * * $FLOCK_BIN -n /var/lock/warehouse-cert-sync.lock $WRAPPER >/dev/null 2>&1"',
'( crontab -l 2>/dev/null | grep -v "warehouse-cert-sync" || true; printf "%s\\n" "$CRON_LINE" ) | crontab -',
'echo "CRONTAB_INSTALLED:"',
'crontab -l | grep -n "warehouse-cert-sync" || true',
].join('\n');
console.log('[INSTALL] write thin shell wrapper + register crontab');
console.log(runSsh(config, installScript, { stdio: 'pipe' }).trim());
}
/**
* 把远端配置里的目录值(如 ./.ssl)按部署根解析成绝对路径。
* @param {string} deployRoot 部署根目录。
* @param {string} value 配置值(相对或绝对)。
* @param {string} fallback 解析失败时的默认值。
* @return {string} 远端绝对路径。
*/
function resolveRemotePath(deployRoot, value, fallback) {
const v = String(value || '').trim();
if (!v) return fallback;
if (v.startsWith('/')) return v;
return `${String(deployRoot).replace(/\/+$/, '')}/${v.replace(/^\.\//, '')}`;
}
/**
* 只读解析服务器 prod 配置中的 certDir / confDir(用于「未触碰」清单展示)。
* 配置缺失或解析失败时回退默认值(<deployRoot>/.ssl、<deployRoot>/nginx_config),不阻断卸载流程。
* @param {Object} config deploy 配置对象。
* @return {{ certDir: string, confDir: string }} 解析出的远端绝对目录。
*/
function resolveServerDirs(config) {
const deployRoot = config.deployRoot;
const defaultCertDir = `${deployRoot}/.ssl`;
const defaultConfDir = `${deployRoot}/nginx_config`;
const result = { certDir: defaultCertDir, confDir: defaultConfDir };
const cfgPath = `${deployRoot}/script/warehouse-cert-sync.config.prod.json`;
const probeScript = [
'set -uo pipefail',
`CFG=${quoteForBash(cfgPath)}`,
'if [ -f "$CFG" ]; then',
` node -e ${quoteForBash('const c=JSON.parse(require("node:fs").readFileSync(process.argv[1],"utf8")); console.log("CERT_DIR="+(c.certDir||"./.ssl")); console.log("CONF_DIR="+(c.confDir||"./nginx_config"));')} "$CFG"`,
'else',
' echo "CERT_DIR=./.ssl"',
' echo "CONF_DIR=./nginx_config"',
'fi',
].join('\n');
try {
const output = String(runSsh(config, probeScript, { stdio: 'pipe' }) || '');
for (const line of output.split('\n')) {
if (line.startsWith('CERT_DIR=')) {
result.certDir = resolveRemotePath(deployRoot, line.slice(9), defaultCertDir);
}
if (line.startsWith('CONF_DIR=')) {
result.confDir = resolveRemotePath(deployRoot, line.slice(9), defaultConfDir);
}
}
} catch (err) {
console.warn(`[UNINSTALL] 服务器目录探测失败,回退默认值:${err.message}`);
}
return result;
}
/**
* 生成卸载目标清单:精确路径 + 历史备份 glob(.prev-* / .legacy-*)。
* @param {string} deployRoot 部署根目录。
* @return {{ exactPaths: string[], globPatterns: string[] }} 目标清单。
*/
function buildUninstallTargets(deployRoot) {
const exactPaths = [
`${deployRoot}/script/warehouse-cert-sync.sh`,
`${deployRoot}/warehouse-cert-sync.sh`,
`${deployRoot}/script/warehouse-cert-sync.cjs`,
`${deployRoot}/script/warehouse-cert-sync.config.prod.json`,
`${deployRoot}/script/warehouse-cert-sync.config.dev.json`,
`${deployRoot}/database/config.js`,
];
const globPatterns = [];
for (const base of [
`${deployRoot}/script/warehouse-cert-sync.sh`,
`${deployRoot}/warehouse-cert-sync.sh`,
`${deployRoot}/script/warehouse-cert-sync.cjs`,
`${deployRoot}/script/warehouse-cert-sync.config.prod.json`,
`${deployRoot}/script/warehouse-cert-sync.config.dev.json`,
`${deployRoot}/database/config.js`,
]) {
globPatterns.push(`${base}.prev-*`, `${base}.legacy-*`);
}
return { exactPaths, globPatterns };
}
/**
* 生成 dry-run 计划脚本(只读:只打印将备份/将删除的目标与将清理的 crontab 行)。
* @param {Object} config deploy 配置对象。
* @param {string} backupDir 计划使用的备份目录(dry-run 不创建)。
* @return {string} 远端 bash 脚本。
*/
function buildUninstallDryRunScript(config, backupDir) {
const { exactPaths, globPatterns } = buildUninstallTargets(config.deployRoot);
return [
'set -uo pipefail',
`B_DIR=${quoteForBash(backupDir)}`,
'echo "PLAN_BACKUP_DIR=$B_DIR"',
`for T in ${exactPaths.map(quoteForBash).join(' ')}; do`,
' if [ -f "$T" ]; then echo "WOULD_BACKUP_AND_DELETE $T"; else echo "MISSING_SKIP $T"; fi',
'done',
`for G in ${globPatterns.map(quoteForBash).join(' ')}; do`,
' for F in $G; do',
' [ -f "$F" ] || continue',
' echo "WOULD_BACKUP_AND_DELETE $F"',
' done',
'done',
'CRON_BEFORE=$(crontab -l 2>/dev/null | wc -l)',
'CRON_CERT=$(crontab -l 2>/dev/null | grep -c "warehouse-cert-sync" || true)',
'if [ "$CRON_CERT" -gt 0 ]; then',
' crontab -l 2>/dev/null | grep "warehouse-cert-sync" | sed "s|^|WOULD_REMOVE_CRON_LINE |" || true',
' echo "CRONTAB_WOULD_GO before=$CRON_BEFORE after=$((CRON_BEFORE - CRON_CERT))"',
'else',
' echo "CRONTAB_UNTOUCHED_NO_MATCH"',
'fi',
].join('\n');
}
/**
* 生成真实卸载脚本:先备份(cp -a 保留权限/时间)再删除,清理 crontab 行。
* 单项失败不中断(HAD_ERRORS 标记),证书/server 块/日志/watchdog 一律不触碰。
* @param {Object} config deploy 配置对象。
* @param {string} backupDir 备份目录(/tmp/wms-cert-sync-uninstall-<时间戳>/)。
* @return {string} 远端 bash 脚本。
*/
function buildUninstallScript(config, backupDir) {
const { exactPaths, globPatterns } = buildUninstallTargets(config.deployRoot);
return [
'set -u',
`BACKUP_DIR=${quoteForBash(backupDir)}`,
'HAD_ERRORS=0',
'mkdir -p "$BACKUP_DIR" && echo "BACKUP_DIR=$BACKUP_DIR" || { echo "BACKUP_DIR_CREATE_FAILED $BACKUP_DIR"; HAD_ERRORS=1; }',
`for T in ${exactPaths.map(quoteForBash).join(' ')}; do`,
' if [ -f "$T" ]; then',
' BASE=$(basename "$T")',
' if cp -a "$T" "$BACKUP_DIR/$BASE"; then',
' echo "BACKED_UP $T -> $BACKUP_DIR/$BASE"',
' else',
' echo "BACKUP_FAILED $T (保留未删)"',
' HAD_ERRORS=1',
' continue',
' fi',
' if rm -f "$T"; then echo "DELETED $T"; else echo "DELETE_FAILED $T"; HAD_ERRORS=1; fi',
' fi',
'done',
`for G in ${globPatterns.map(quoteForBash).join(' ')}; do`,
' for F in $G; do',
' [ -f "$F" ] || continue',
' BASE=$(basename "$F")',
' if cp -a "$F" "$BACKUP_DIR/$BASE"; then',
' echo "BACKED_UP $F -> $BACKUP_DIR/$BASE"',
' else',
' echo "BACKUP_FAILED $F (保留未删)"',
' HAD_ERRORS=1',
' continue',
' fi',
' if rm -f "$F"; then echo "DELETED $F"; else echo "DELETE_FAILED $F"; HAD_ERRORS=1; fi',
' done',
'done',
'CRON_BEFORE=$(crontab -l 2>/dev/null | wc -l)',
'CRON_CERT=$(crontab -l 2>/dev/null | grep -c "warehouse-cert-sync" || true)',
'if [ "$CRON_CERT" -gt 0 ]; then',
' crontab -l 2>/dev/null | grep "warehouse-cert-sync" | sed "s|^|CRON_REMOVED_LINE |" || true',
' if ( crontab -l 2>/dev/null | grep -v "warehouse-cert-sync" || true ) | crontab -; then',
' echo "CRONTAB_REWRITTEN before=$CRON_BEFORE after=$(crontab -l 2>/dev/null | wc -l)"',
' else',
' echo "CRONTAB_REWRITE_FAILED"',
' HAD_ERRORS=1',
' fi',
'else',
' echo "CRONTAB_UNTOUCHED_NO_MATCH"',
'fi',
'echo "HAD_ERRORS=$HAD_ERRORS"',
].join('\n');
}
/**
* 按三段结构打印卸载输出:[UNINSTALL] 备份 / [UNINSTALL] 已删除 / [UNINSTALL] 未触碰(原因)。
* @param {string} output 远端脚本输出。
* @param {boolean} dryRun 是否 dry-run(只打印计划)。
* @param {string} backupDir 备份目录路径。
* @param {{ certDir: string, confDir: string }} dirs 证书/server 块目录解析结果。
* @param {string} deployRoot 部署根目录。
*/
function printUninstallReport(output, dryRun, backupDir, dirs, deployRoot) {
const lines = String(output || '').split(/\r?\n/);
const planNote = dryRun ? '(计划,未执行)' : '';
const backupLines = [];
const deletedLines = [];
for (const line of lines) {
if (line.startsWith('PLAN_BACKUP_DIR=')) {
backupLines.push(`BACKUP_DIR=${line.slice('PLAN_BACKUP_DIR='.length)}${dryRun ? '(计划,不创建)' : ''}`);
} else if (line.startsWith('WOULD_BACKUP_AND_DELETE ')) {
const src = line.slice('WOULD_BACKUP_AND_DELETE '.length);
backupLines.push(`BACKED_UP ${src} -> ${backupDir}${src.split('/').pop()}${planNote}`);
deletedLines.push(`DELETED ${src}${planNote}`);
} else if (line.startsWith('MISSING_SKIP ')) {
backupLines.push(`SKIP ${line.slice('MISSING_SKIP '.length)}(不存在)`);
} else if (line.startsWith('BACKUP_DIR=')) {
backupLines.push(line);
} else if (line.startsWith('BACKUP_DIR_CREATE_FAILED ')) {
backupLines.push(line);
} else if (line.startsWith('BACKED_UP ')) {
backupLines.push(line);
} else if (line.startsWith('BACKUP_FAILED ')) {
backupLines.push(line);
} else if (line.startsWith('DELETED ')) {
deletedLines.push(line);
} else if (line.startsWith('DELETE_FAILED ')) {
deletedLines.push(line);
} else if (line.startsWith('WOULD_REMOVE_CRON_LINE ')) {
deletedLines.push(`CRON_REMOVED_LINE ${line.slice('WOULD_REMOVE_CRON_LINE '.length)}${planNote}`);
} else if (line.startsWith('CRON_REMOVED_LINE ')) {
deletedLines.push(line);
} else if (line.startsWith('CRONTAB_REWRITTEN ')) {
deletedLines.push(line);
} else if (line.startsWith('CRONTAB_WOULD_GO ')) {
deletedLines.push(`${line}${dryRun ? '(计划,未执行)' : ''}`);
} else if (line.startsWith('CRONTAB_UNTOUCHED_NO_MATCH')) {
deletedLines.push('crontab 无 warehouse-cert-sync 行,未改写');
}
}
console.log(`[UNINSTALL] 备份${dryRun ? '(计划)' : ''}`);
for (const line of backupLines) console.log(` ${line}`);
console.log(`[UNINSTALL] 已删除${dryRun ? '(计划)' : ''}`);
for (const line of deletedLines) console.log(` ${line}`);
console.log('[UNINSTALL] 未触碰(原因)');
console.log(` CERT_DIR_KEPT ${dirs.certDir}(运行产物:证书/私钥,nginx 仍在 include,删除会立断 443;由运维自行决定,如先切走 include 再手工删)`);
console.log(` CONF_DIR_KEPT ${dirs.confDir}(运行产物:<domain>-<ver>.conf server 块,nginx 仍在 include,同上)`);
console.log(' LOG_KEPT /var/log/warehouse-cert-sync.log(默认保留作排查线索)');
console.log(` UPSTREAM_KEPT ${deployRoot}/nginx-upstream.conf(非本工具文件,不删)`);
console.log(` WATCHDOG_KEPT ${deployRoot}/script/qimen-watchdog.*、/etc/cron.d/qimen-watchdog(看门狗相关,不属于 cert-sync 工具)`);
if (dryRun) {
console.log(`[UNINSTALL] dry-run 结束(未做任何变更)。实际执行时备份目录:${backupDir}`);
console.log('如需回滚(实际执行后):把备份目录里的文件 cp -a 回原路径并重跑 install');
return;
}
console.log(`备份目录:${backupDir}`);
console.log('如需回滚:把备份目录里的文件 cp -a 回原路径并重跑 install');
if (lines.some(line => line === 'HAD_ERRORS=1')) {
console.error('[UNINSTALL] 存在失败项(见上),可从备份目录恢复');
process.exitCode = 1;
}
}
/**
* 卸载 cert-sync 工具自身:先备份再删除(包装脚本 / 主脚本 / 双环境配置 /
* database/config.js / 历史位置与 .prev-* / .legacy-* 备份 / crontab 行)。
* 证书、nginx server 块、日志、watchdog 相关一律不删(原因见输出)。
* --dry-run 时只打印计划,不备份、不删除、不改 crontab。
* @param {Object} config deploy 配置对象。
* @param {Object} options 命令选项(dryRun)。
*/
function runUninstall(config, options) {
const backupDir = `/tmp/wms-cert-sync-uninstall-${getNowStamp()}/`;
const dirs = resolveServerDirs(config);
const remoteScript = options.dryRun
? buildUninstallDryRunScript(config, backupDir)
: buildUninstallScript(config, backupDir);
if (options.dryRun) {
console.log('[UNINSTALL] dry-run(只读:只打印计划,不备份、不删除、不改 crontab)');
} else {
console.log('[UNINSTALL] 开始卸载(先备份再删除)');
}
const output = String(runSsh(config, remoteScript, { stdio: 'pipe' }) || '');
printUninstallReport(output, options.dryRun, backupDir, dirs, config.deployRoot);
}
/**
* 入口:解析命令行参数并执行 install / uninstall。
*/
function main() {
const options = parseArgs(process.argv.slice(2));
const config = loadDeployConfig(options.envName);
if (options.command === 'install') {
runInstall(config);
return;
}
if (options.command === 'uninstall') {
runUninstall(config, options);
return;
}
throw new Error(`unsupported command: ${options.command}`);
}
main();