saas-reference-architecture-ecs 的安装和配置教程

1. 项目基础介绍

本项目是一个使用 Amazon Elastic Container Service (ECS) 实现的端到端的 SaaS（软件即服务）参考架构。该参考架构旨在帮助开发者和企业构建多租户的 SaaS 应用程序，实现成本优化、操作效率提升和整体敏捷性。项目主要使用 TypeScript、HTML、Python、Shell、SCSS 和 JavaScript 等编程语言。

2. 项目使用的关键技术和框架

• Amazon ECS：亚马逊弹性容器服务，用于管理容器化的应用程序。
• AWS SaaS Builder Toolkit (SBT)：AWS SaaS 工厂开发的工具包，用于扩展 SaaS 控制平面服务，如租户注册、注销、管理和计费等。
• AWS Cloud Development Kit (CDK)：用于定义 AWS 资源的编程框架。
• Docker：用于容器化应用程序。
• AWS CLI：亚马逊命令行界面，用于与 AWS 服务进行交互。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的环境中已安装以下工具和依赖：

• Python 3.8 或更高版本：用于运行脚本和构建应用。
• AWS CLI 2.14 或更高版本：用于与 AWS 服务交互。
• Docker Engine：用于容器化应用。
• AWS CDK CLI：用于部署 AWS 资源。
• Node 18 或更高版本：用于运行构建脚本。
• Git：用于克隆项目代码。
• Amazon Linux 2023 AMI：如果您使用 AWS Cloud9 环境。

安装步骤

1. 克隆项目代码到本地：

   git clone https://github.com/aws-samples/saas-reference-architecture-ecs.git
   

2. 切换到项目目录：

   cd saas-reference-architecture-ecs
   

3. 运行构建脚本，构建 Docker 镜像并将它们推送到 Amazon ECR：

   ./scripts/build-application.sh
   

4. 运行安装脚本，输入管理员邮箱地址以创建管理员用户和共享管理员凭据：

   ./scripts/install.sh admin_email
   

   请将 admin_email 替换为您实际使用的邮箱地址。

安装脚本将执行以下操作：

• 在您的 AWS 账户中创建一个 S3 桶，并将项目代码推送到该桶。
• 使用上传的源代码为高级层和每个 ECS 集群和微服务的预配。
• 部署 controlplane-stack CDK 栈，提供 SaaS Builder Toolkit 控制平面组件，用于租户的注册和注销。
• 部署 coreappplane-stack CDK 栈，提供 SaaS Builder Toolkit 核心应用平面，用于定义和运行任意作业。
• 部署 shared-infra-stack CDK 栈，提供共享应用基础架构，如 Amazon VPC、API 网关和负载均衡器。
• 部署 tenant-template-stack CDK 栈，提供 ECS 集群和微服务。

完成以上步骤后，您就成功安装了 saas-reference-architecture-ecs 项目，并可以开始构建和部署您的 SaaS 应用程序了。