From bb908560be06a1ade02c40dc129a13ec5a93dac5 Mon Sep 17 00:00:00 2001 From: ximenchuifeng Date: Thu, 27 Aug 2026 14:37:51 +0800 Subject: [PATCH] docs(runbooks): add first-install guidance to db-change runbook --- docs/runbooks/db-change.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/runbooks/db-change.md b/docs/runbooks/db-change.md index aadc7f0..347c45a 100644 --- a/docs/runbooks/db-change.md +++ b/docs/runbooks/db-change.md @@ -25,6 +25,8 @@ 更新中心里某个版本标记了「含数据库变更」,或发版通知中注明该服务带迁移脚本。未标记的版本不涉及本手册。 +**新客户首装**:生产环境关闭了启动自动迁移,首次部署时数据库是空的——必须先按本手册对每个带库服务(sso/ultra/agent)执行一次初始脚本(幂等脚本支持空库,会创建全部表结构),再启动应用,否则应用会因缺表无法启动。首装时按「流程一→三→四→五」执行(流程二备份对空库可跳过),全部服务执行完再通知验收。 + ## 2. 准备 1. 获取迁移脚本(随版本交付,幂等,可重复执行):