MySQL / 系统课时

建立上线前自动检查

建立上线前自动检查

上线前自动检查的目标,是把容易遗漏的人肉确认变成可重复的发布门禁:DDL 执行前自动检查静态规则、生产状态和克隆环境兼容性,任一关键条件不满足就拒绝发布,并保留可定位的失败原因。

学习目标

  • 能把 DDL 风险项转换成机器可判断的门禁条件。
  • 能实现一段最小可用的发布前检查脚本,并理解它依赖的输入。
  • 能区分静态检查、生产状态检查和克隆环境兼容性验证。

把门禁拆成三类检查

第一类是静态检查,只读取变更单本身,例如目标库表是否明确、算法与锁要求是否显式声明、是否出现治理策略禁止的 ALGORITHM=COPY。这类检查速度快,应该最先执行。

第二类是生产状态检查,读取当前事实:是否存在超过阈值的长事务、目标表是否超过允许档位、磁盘余量是否足够、关键副本延迟是否在阈值内。状态数据必须临近发布重新采集,不能长期复用旧结果。

第三类是兼容性验证。DDL 算法是否真的被目标版本和精确表结构支持,最可靠的方法不是在生产库“试一下”,而是在与生产版本、参数和表结构尽量一致的临时克隆环境执行同一条 DDL。试执行成功只能说明该组合通过功能兼容性验证,仍不能替代生产资源门禁。

DDL 上线前自动门禁流程

这个顺序有两个好处:先用便宜的静态规则挡住明显错误,再访问数据库和监控系统,最后才做耗时更高的克隆验证。门禁结果应保留检查名、当前值、阈值和判定,方便审计和故障定位。

实现一个最小可用门禁脚本

下面示例假设发布系统已经把监控数据注入环境变量,并提供两个 MySQL 连接:PROD_HOST 只用于读取生产状态,CHECK_HOST 指向可丢弃的临时克隆实例。示例面向单目标表,阈值可按业务等级配置。静态规则先统一大小写并移除空白,因此 ALGORITHM = INPLACE 与 ALGORITHM=INPLACE 会被视为同一种写法;同时明确区分算法与锁级别:ALGORITHM=INSTANT 要求 LOCK=DEFAULT,ALGORITHM=INPLACE 要求 LOCK=NONE。

bash
#!/usr/bin/env bash
set -euo pipefail

: "${MYSQL_USER:?}"
: "${MYSQL_PWD:?}"
: "${PROD_HOST:?}"
: "${CHECK_HOST:?}"
: "${DDL:?}"
: "${DISK_FREE_GB:?}"
: "${REPLICA_LAG_S:?}"

DB_NAME="app"
TABLE_NAME="orders"
MAX_TRX_S=60
MAX_TABLE_GB=200
MIN_DISK_FREE_GB=500
MAX_REPLICA_LAG_S=30

mysql_prod() {
  mysql -N -B -h "$PROD_HOST" -u "$MYSQL_USER" "$@"
}

mysql_check() {
  mysql -N -B -h "$CHECK_HOST" -u "$MYSQL_USER" "$@"
}

# 统一大小写与空白,避免等价 SQL 写法被静态规则误判。
normalized_ddl="$(printf '%s' "$DDL" | tr '[:lower:]' '[:upper:]' | tr -d '[:space:]')"

if [[ "$normalized_ddl" == *"ALGORITHM=COPY"* ]]; then
  echo "REJECT: ALGORITHM=COPY is forbidden by policy"
  exit 20
fi

if [[ "$normalized_ddl" != *"ALGORITHM=INSTANT"* && "$normalized_ddl" != *"ALGORITHM=INPLACE"* ]]; then
  echo "REJECT: explicit online ALGORITHM is required"
  exit 20
fi

if [[ "$normalized_ddl" == *"ALGORITHM=INSTANT"* ]]; then
  if [[ "$normalized_ddl" != *"LOCK=DEFAULT"* ]]; then
    echo "REJECT: ALGORITHM=INSTANT requires LOCK=DEFAULT"
    exit 20
  fi
elif [[ "$normalized_ddl" == *"ALGORITHM=INPLACE"* ]]; then
  if [[ "$normalized_ddl" != *"LOCK=NONE"* ]]; then
    echo "REJECT: ALGORITHM=INPLACE requires LOCK=NONE"
    exit 20
  fi
fi

table_gb="$(mysql_prod -e "
  SELECT ROUND((data_length + index_length) / 1024 / 1024 / 1024, 2)
  FROM information_schema.tables
  WHERE table_schema='${DB_NAME}' AND table_name='${TABLE_NAME}';
")"

max_trx_s="$(mysql_prod -e "
  SELECT COALESCE(MAX(TIMESTAMPDIFF(SECOND, trx_started, NOW())), 0)
  FROM information_schema.innodb_trx;
")"

if [[ -z "$table_gb" ]]; then
  echo "REJECT: target table not found"
  exit 21
fi

awk "BEGIN { exit !($table_gb <= $MAX_TABLE_GB) }" || {
  echo "REJECT: table size ${table_gb}GB exceeds ${MAX_TABLE_GB}GB"
  exit 22
}

(( max_trx_s <= MAX_TRX_S )) || {
  echo "REJECT: long transaction ${max_trx_s}s exceeds ${MAX_TRX_S}s"
  exit 23
}

awk "BEGIN { exit !($DISK_FREE_GB >= $MIN_DISK_FREE_GB) }" || {
  echo "REJECT: disk free ${DISK_FREE_GB}GB below ${MIN_DISK_FREE_GB}GB"
  exit 24
}

(( REPLICA_LAG_S <= MAX_REPLICA_LAG_S )) || {
  echo "REJECT: replica lag ${REPLICA_LAG_S}s exceeds ${MAX_REPLICA_LAG_S}s"
  exit 25
}

# 精确 DDL 只在临时克隆实例执行,用实际成功或错误验证兼容性。
mysql_check "$DB_NAME" -e "$DDL"

echo "PASS: all DDL preflight checks succeeded"

预期输出:

text
PASS: all DDL preflight checks succeeded

例如目标环境存在长事务时,脚本会以非零退出码终止:

text
REJECT: long transaction <VALUE>s exceeds 60s

实际表大小、事务时长、磁盘余量和复制延迟会随时间变化,因此 <VALUE> 等结果应来自执行当时的生产数据库和监控系统。DISK_FREE_GB 与 REPLICA_LAG_S 在示例中由外部监控注入,是为了避免把监控平台 API、SSH 和复制拓扑细节硬编码进同一脚本。

算法兼容性不要只靠字符串匹配

检查 SQL 中是否写了 ALGORITHM=INPLACE、ALGORITHM=INSTANT 以及相应的 LOCK 要求,只能证明“申请人提出了要求”,不能证明 MySQL 一定支持。精确支持情况还受到 DDL 动作、表定义、存储引擎和服务器版本影响,因此门禁应保留两层验证。

静态层负责治理规则,例如禁止 COPY、要求显式在线算法,并校验算法与锁级别组合。动态层在临时克隆实例执行精确 DDL,并检查命令返回码。若 MySQL 因不支持请求的算法或锁级别而报错,门禁直接拒绝,申请人需要调整方案,而不是在生产上自动降级。

让失败结果能指导下一步

自动门禁不能只返回一个 false。每个失败项都应有稳定的检查名、当前值、阈值和建议动作,例如 long_transaction 提示先处理长事务,disk_free 提示扩容或调整方案,replica_lag 提示等待复制恢复,algorithm_compatibility 则要求重新选择 DDL 方案。

生产系统还应把门禁结果和变更单绑定保存,并在真正执行前设置较短的有效期。长事务和复制延迟是瞬时状态,如果检查通过后等待很久才执行,原来的“PASS”已经失去意义。

自动检查的边界也要清楚:它能阻止已知、可量化的风险,却不能替代执行窗口内的实时监控和中止策略。稳妥的闭环是“变更单定义阈值 → 门禁自动验证 → 执行期持续观测 → 越阈值立即停止后续动作”,而不是把一次上线前检查当成永久安全证明。

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

目录与阅读设置

记录一个想法

建立上线前自动检查

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

登录哪都通