架构与系统设计 / 系统课时
部署验收与演进
部署验收与演进
本课把多租户系统从“能够运行”推进到“可以上线”:先用容器编排完成最小部署,再按功能、隔离、安全和可观测性逐项验收,最后用容量数据判断何时扩容,以及何时把重点租户从共享库平滑迁移到独立库。
学习目标
- 完成应用、MySQL、Redis 的容器化部署并验证服务可用性
- 建立覆盖租户隔离、配置安全、监控告警的上线验收清单
- 根据容量指标制定扩容阈值和共享库到独立库的演进方案
组装最小生产拓扑
部署验收不能只看应用端口是否打开。一个可上线的最小拓扑至少包含入口、应用、数据库、缓存和持久化卷,并明确哪些组件可以横向扩展,哪些数据必须持久保存。

下面是项目级片段示例,依赖当前项目已经构建出应用镜像 example/saas-app:1.0.0;实际部署时应替换为真实镜像地址。生产环境还要把密码改为密钥管理或环境注入,不要直接提交到代码仓库。
services:
mysql:
image: mysql:8.4
environment:
MYSQL_ROOT_PASSWORD: root-change-me
MYSQL_DATABASE: saas_app
MYSQL_USER: saas
MYSQL_PASSWORD: saas-change-me
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
volumes:
- mysql-data:/var/lib/mysql
healthcheck:
test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -uroot -p$$MYSQL_ROOT_PASSWORD"]
interval: 10s
timeout: 5s
retries: 12
redis:
image: redis:7.4
command: ["redis-server", "--appendonly", "yes"]
volumes:
- redis-data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 10s
timeout: 3s
retries: 12
app:
image: example/saas-app:1.0.0
environment:
SPRING_PROFILES_ACTIVE: prod
SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/saas_app?useUnicode=true&characterEncoding=utf8
SPRING_DATASOURCE_USERNAME: saas
SPRING_DATASOURCE_PASSWORD: saas-change-me
SPRING_DATA_REDIS_HOST: redis
ports:
- "8080:8080"
depends_on:
mysql:
condition: service_healthy
redis:
condition: service_healthy
restart: unless-stopped
volumes:
mysql-data:
redis-data:配置生效后,在项目目录执行:
docker compose up -d
docker compose ps预期输出:
NAME IMAGE SERVICE STATUS
<NAME> example/saas-app:1.0.0 app Up
<NAME> mysql:8.4 mysql Up (healthy)
<NAME> redis:7.4 redis Up (healthy)容器名称和启动时间属于动态值,实际输出可能不同。只有数据库、缓存均健康且应用持续运行,才进入接口验收阶段。
执行上线验收
上线验收应按“基础可用、租户隔离、安全控制、可观测性”四层推进。先确认服务能响应,再验证错误租户、越权访问和异常依赖不会被静默放过。
可先使用脚本完成最小自动验收。示例约定系统提供 /actuator/health 和带租户请求头的 /api/profile,缺失租户标识时返回 400;实际地址、认证方式和错误码应替换成项目约定。
#!/usr/bin/env bash
set -euo pipefail
BASE_URL="${BASE_URL:-http://127.0.0.1:8080}"
health_code=$(curl -sS -o /tmp/health.json -w "%{http_code}" "${BASE_URL}/actuator/health")
test "${health_code}" = "200"
grep -q '"status":"UP"' /tmp/health.json
tenant_code=$(curl -sS -o /tmp/tenant.json -w "%{http_code}" -H "X-Tenant-Id: tenant-a" "${BASE_URL}/api/profile")
test "${tenant_code}" = "200"
missing_code=$(curl -sS -o /tmp/missing.json -w "%{http_code}" "${BASE_URL}/api/profile")
test "${missing_code}" = "400"
echo "deployment acceptance passed"预期输出:
deployment acceptance passed脚本通过只代表最小链路正常,还要人工或自动补充以下检查:租户 A 无法读取租户 B 数据;管理员接口经过鉴权;数据库账号不是 root;日志包含 traceId 和 tenantId;Redis、MySQL 不可直接暴露公网;备份可以恢复;告警能在错误率、延迟或连接池耗尽时触发。
验收失败时不要先重启所有容器。应依次查看 docker compose ps、应用日志、依赖健康状态和接口响应体,先确认失败发生在哪一层,再处理具体根因。
用数据评估容量
容量评估不应只看 CPU。多租户系统最容易先达到瓶颈的通常是数据库连接、慢查询、缓存热键、单租户突发流量或线程池排队。上线后至少持续观察峰值请求量、P95 延迟、错误率、连接池占用和数据库负载。
可用一个简化模型估算应用实例数量:
其中, 是峰值请求速率, 是单实例在目标延迟下的安全吞吐量, 是冗余实例数。若压测得到单实例安全吞吐量为 180 请求/秒,业务峰值为 420 请求/秒,并保留 1 个冗余实例,则需要 4 个实例,而不是按平均流量配置 2 个。
扩容阈值应组合判断,而不是单指标触发。例如连续 10 分钟 CPU 高于 70%、P95 延迟超过目标且线程池排队增长时,才横向增加应用实例;若应用 CPU 不高但数据库连接池长期超过 80%,应优先优化 SQL、连接释放和数据库容量。
规划独立库演进
共享库适合早期统一运维,但高价值租户、合规租户或流量大户可能需要独立数据库。演进的关键不是“再建一个库”,而是让路由、迁移、校验和回滚形成可重复流程。

应用层应通过租户数据源路由表决定访问位置,而不是在业务代码中写死某个数据库。一个最小路由表示例如下:
CREATE TABLE tenant_datasource_route (
tenant_id VARCHAR(64) NOT NULL,
storage_mode VARCHAR(16) NOT NULL,
datasource_key VARCHAR(64) NOT NULL,
route_version BIGINT NOT NULL DEFAULT 1,
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (tenant_id)
);
INSERT INTO tenant_datasource_route
(tenant_id, storage_mode, datasource_key)
VALUES
('tenant-a', 'DEDICATED', 'tenant-a-db');预期结果:
Query OK, 0 rows affected
Query OK, 1 row affected切换前必须核对租户级数据总量和关键业务汇总,例如订单条数、成功金额、用户数以及最大更新时间。切换后保留一段只读回滚窗口;一旦发现路由错误、增量未追平或校验不一致,应立即恢复共享库路由,而不是继续在两个库同时写入。
建立演进验收线
部署完成不等于项目结束。每次版本发布都应重复执行健康检查、租户隔离测试和关键接口回归;每次容量变化都应记录压测基线;每次数据架构演进都应保留迁移脚本、校验结果和回滚步骤。
最终验收可以用三条线判断:功能线要求核心业务闭环成功;隔离线要求任意租户都无法越权;运行线要求故障可发现、数据可恢复、容量有余量。三条线同时通过,系统才具备持续演进的基础。
本课总结
- 容器化上线必须同时验证应用、依赖、持久化和租户隔离,不能只看端口可访问
- 容量规划应以压测基线和多指标趋势为依据,并为故障和流量波动保留冗余
- 独立库演进要通过租户路由、全量与增量迁移、数据校验和回滚窗口完成闭环
下一课预告
下一课将把本章的部署与排障能力汇总为项目验收清单,帮助你对完整多租户系统进行最终复盘与交付。