AWS SaaS 参考架构 ECS 项目的启动和配置教程

2025-05-21 12:41:57作者：殷蕙予

1. 项目的目录结构及介绍

本项目是基于 Amazon Elastic Container Service (ECS) 的 SaaS（软件即服务）参考架构。项目目录结构如下：

aws-samples/saas-reference-architecture-ecs/
├── client/                        # 客户端相关代码
├── images/                        # Docker 镜像相关文件
├── scripts/                       # 脚本文件，包括构建、部署和清理脚本
├── server/                        # 服务端代码
├── .gitignore                     # Git 忽略文件
├── CODE_OF_CONDUCT.md             # 行为准则
├── CONTRIBUTING.md                # 贡献指南
├── DEVELOPER_GUIDE.md             # 开发者指南
├── LICENSE                        # 许可证文件
├── README.kr.md                   # 韩文 README 文件
├── README.md                      # README 文件
├── package.json                   # Node.js 项目配置文件

各目录及文件简要说明：

client/: 客户端代码，可能包括前端应用程序。
images/: 存储构建 Docker 镜像所需的 Dockerfile 文件。
scripts/: 包含构建、部署和清理项目的脚本。
server/: 服务端代码，可能包括 API 服务器和微服务。
.gitignore: 指定 Git 忽略的文件和目录。
CODE_OF_CONDUCT.md: 项目的行为准则。
CONTRIBUTING.md: 指导如何为项目贡献代码和文档。
DEVELOPER_GUIDE.md: 提供项目开发和部署的详细指南。
LICENSE: 项目的许可证信息。
README.kr.md: 韩文版本的 README 文件。
README.md: 项目的英文 README 文件，包含项目描述和使用说明。
package.json: Node.js 项目的配置文件，定义了项目的依赖和脚本。

2. 项目的启动文件介绍

项目的启动主要涉及以下几个脚本文件：

build-application.sh: 用于构建 Docker 镜像的脚本。它会编译项目中的微服务，并推送至 Amazon Elastic Container Registry (ECR)。
install.sh: 用于部署项目的脚本。它执行以下操作：
- 在 AWS 账户中创建一个 S3 桶，并将项目代码推送到该桶。
- 使用 CDK (Cloud Development Kit) 部署以下堆栈：
  - controlplane-stack: 部署 SaaS Builder Toolkit (SBT) 控制平面组件，用于管理租户的配置。
  - coreappplane-stack: 部署 SBT 核心应用平面，用于定义和运行接收到控制平面消息时的作业。
  - shared-infra-stack: 部署共享应用基础设施，如 Amazon VPC、API Gateway 和负载均衡器。
  - tenant-template-stack: 部署 ECS 集群和微服务。

3. 项目的配置文件介绍

项目的配置文件主要是 package.json，它包含了项目的依赖和可执行的脚本。以下是 package.json 中的一个示例片段：

{
  "name": "saas-reference-architecture-ecs",
  "version": "1.0.0",
  "scripts": {
    "build": "npm run build-application.sh",
    "install": "npm run install.sh"
  },
  "dependencies": {
    // 项目依赖列表
  }
}