SST项目中多应用Monorepo配置的最佳实践

在基于SST框架构建的Monorepo项目中，开发者经常需要管理多个独立部署的应用。本文将通过一个典型场景，深入解析如何正确使用--config参数实现多应用配置管理。

场景需求分析

现代云架构项目中，前后端分离部署已成为主流模式。在SST框架下，一个Monorepo项目可能包含：

• 后端服务（如API服务）
• 前端静态站点（如React/Vue应用）

理想情况下，我们希望：

1. 为每个应用维护独立的配置文件
2. 能够分别部署各个组件
3. 保持项目结构的清晰性

配置方案演进

初始方案的问题

开发者尝试创建两个配置文件：

• backend-sst.config.ts 用于后端服务
• ui-sst.config.ts 用于前端应用

并计划通过以下命令分别部署：

npx sst --config backend-sst.config.ts deploy --stage test
npx sst --config ui-sst.config.ts deploy --stage test

但遇到核心问题：SST仍会默认查找sst.config.ts文件，导致部署失败。

问题根源

在SST v3.13.14及之前版本中，CLI存在一个逻辑缺陷：

1. 即使指定了--config参数
2. 系统仍会强制检查默认配置文件是否存在
3. 这种双重检查机制与开发者预期不符

解决方案

该问题已在SST v3.13.16版本中修复。现在可以：

1. 完全通过--config参数指定配置文件路径
2. 不再需要维护默认的sst.config.ts文件
3. 实现真正的多配置管理

最佳实践建议

1. 版本控制
   确保使用SST v3.13.16或更高版本

2. 项目结构设计
   推荐目录结构：

   /project-root
   ├── packages
   │   ├── backend
   │   │   ├── sst.config.ts
   │   │   └── ...
   │   └── ui
   │       ├── sst.config.ts
   │       └── ...
   └── package.json
   

3. 部署命令优化
   在package.json中配置scripts：

   {
     "scripts": {
       "deploy:backend": "sst --config packages/backend/sst.config.ts deploy",
       "deploy:ui": "sst --config packages/ui/sst.config.ts deploy"
     }
   }
   

4. 配置继承技巧
   对于共享配置项，可以：

   • 创建基础配置文件
   • 通过TypeScript的模块导入实现配置继承
   • 减少重复配置

高级应用场景

对于更复杂的Monorepo项目，建议结合以下方案：

1. 环境变量管理
   为不同stage（dev/test/prod）配置不同的环境变量

2. 部署流水线集成
   在CI/CD流程中：

   • 并行部署前后端
   • 设置部署依赖关系
   • 实现自动化验证

3. 本地开发优化
   使用sst start时同样支持--config参数，便于本地调试特定服务

总结

SST框架对Monorepo项目的支持正在不断完善。通过合理利用--config参数和多配置文件方案，开发者可以构建出灵活、可维护的云应用架构。建议团队在采用此方案时，建立统一的配置规范，确保项目长期可维护性。