架构与系统设计 / 系统课时

部署验收与演进

部署验收与演进

本课把多租户系统从“能够运行”推进到“可以上线”:先用容器编排完成最小部署,再按功能、隔离、安全和可观测性逐项验收,最后用容量数据判断何时扩容,以及何时把重点租户从共享库平滑迁移到独立库。

学习目标

  • 完成应用、MySQL、Redis 的容器化部署并验证服务可用性
  • 建立覆盖租户隔离、配置安全、监控告警的上线验收清单
  • 根据容量指标制定扩容阈值和共享库到独立库的演进方案

组装最小生产拓扑

部署验收不能只看应用端口是否打开。一个可上线的最小拓扑至少包含入口、应用、数据库、缓存和持久化卷,并明确哪些组件可以横向扩展,哪些数据必须持久保存。

多租户系统容器化部署拓扑

下面是项目级片段示例,依赖当前项目已经构建出应用镜像 example/saas-app:1.0.0;实际部署时应替换为真实镜像地址。生产环境还要把密码改为密钥管理或环境注入,不要直接提交到代码仓库。

yaml
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:

配置生效后,在项目目录执行:

bash
docker compose up -d
docker compose ps

预期输出:

text
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;实际地址、认证方式和错误码应替换成项目约定。

bash
#!/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"

预期输出:

text
deployment acceptance passed

脚本通过只代表最小链路正常,还要人工或自动补充以下检查:租户 A 无法读取租户 B 数据;管理员接口经过鉴权;数据库账号不是 root;日志包含 traceId 和 tenantId;Redis、MySQL 不可直接暴露公网;备份可以恢复;告警能在错误率、延迟或连接池耗尽时触发。

验收失败时不要先重启所有容器。应依次查看 docker compose ps、应用日志、依赖健康状态和接口响应体,先确认失败发生在哪一层,再处理具体根因。

用数据评估容量

容量评估不应只看 CPU。多租户系统最容易先达到瓶颈的通常是数据库连接、慢查询、缓存热键、单租户突发流量或线程池排队。上线后至少持续观察峰值请求量、P95 延迟、错误率、连接池占用和数据库负载。

可用一个简化模型估算应用实例数量:

N=⌈QpeakQsafe⌉+RN = \left\lceil \frac{Q_{peak}}{Q_{safe}} \right\rceil + R

其中,QpeakQ_{peak} 是峰值请求速率,QsafeQ_{safe} 是单实例在目标延迟下的安全吞吐量,RR 是冗余实例数。若压测得到单实例安全吞吐量为 180 请求/秒,业务峰值为 420 请求/秒,并保留 1 个冗余实例,则需要 4 个实例,而不是按平均流量配置 2 个。

扩容阈值应组合判断,而不是单指标触发。例如连续 10 分钟 CPU 高于 70%、P95 延迟超过目标且线程池排队增长时,才横向增加应用实例;若应用 CPU 不高但数据库连接池长期超过 80%,应优先优化 SQL、连接释放和数据库容量。

规划独立库演进

共享库适合早期统一运维,但高价值租户、合规租户或流量大户可能需要独立数据库。演进的关键不是“再建一个库”,而是让路由、迁移、校验和回滚形成可重复流程。

共享库到独立库迁移流程

应用层应通过租户数据源路由表决定访问位置,而不是在业务代码中写死某个数据库。一个最小路由表示例如下:

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');

预期结果:

text
Query OK, 0 rows affected
Query OK, 1 row affected

切换前必须核对租户级数据总量和关键业务汇总,例如订单条数、成功金额、用户数以及最大更新时间。切换后保留一段只读回滚窗口;一旦发现路由错误、增量未追平或校验不一致,应立即恢复共享库路由,而不是继续在两个库同时写入。

建立演进验收线

部署完成不等于项目结束。每次版本发布都应重复执行健康检查、租户隔离测试和关键接口回归;每次容量变化都应记录压测基线;每次数据架构演进都应保留迁移脚本、校验结果和回滚步骤。

最终验收可以用三条线判断:功能线要求核心业务闭环成功;隔离线要求任意租户都无法越权;运行线要求故障可发现、数据可恢复、容量有余量。三条线同时通过,系统才具备持续演进的基础。

本课总结

  • 容器化上线必须同时验证应用、依赖、持久化和租户隔离,不能只看端口可访问
  • 容量规划应以压测基线和多指标趋势为依据,并为故障和流量波动保留冗余
  • 独立库演进要通过租户路由、全量与增量迁移、数据校验和回滚窗口完成闭环

下一课预告

下一课将把本章的部署与排障能力汇总为项目验收清单,帮助你对完整多租户系统进行最终复盘与交付。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署验收与演进

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

登录哪都通