eShopOnAbp 项目教程

1. 项目介绍

eShopOnAbp 是一个基于 ABP 框架的微服务参考项目，旨在帮助开发者构建微服务解决方案。该项目展示了如何使用 ABP 框架和 .NET 技术栈来构建一个完整的微服务应用，包括 API 网关、Angular 和 ASP.NET Core MVC 应用，以及 PostgreSQL 和 MongoDB 数据库。该项目还展示了如何在 Kubernetes 上使用 Helm 配置来部署和管理微服务。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• .NET 6.0 Runtime（用于 Tye）
• .NET 8.0 SDK
• Docker
• Yarn v1.20+（不支持 v2）或 npm v6+（通常随 Node.js 一起安装）

2.2 克隆项目

首先，克隆 eShopOnAbp 项目到本地：

git clone https://github.com/abpframework/eShopOnAbp.git
cd eShopOnAbp

2.3 安装 Tye

Tye 是一个开发者工具，用于简化微服务和分布式应用的开发、测试和部署。安装 Tye 的步骤如下：

dotnet tool update --global Microsoft.Tye --prerelease

2.4 配置环境变量

将项目根目录下的 .env.example 文件重命名为 .env，并提供 PayPal 的 ClientID 和 Secret。

cp .env.example .env

2.5 启动项目

执行以下命令启动项目：

./run-tye.ps1

等待所有应用程序启动。您可以通过 Tye 仪表板（localhost:8000）查看运行中的应用程序。

2.6 启动 Angular 应用

当所有后端服务启动后，启动 Angular 应用：

cd apps/angular
yarn start

3. 应用案例和最佳实践

3.1 微服务架构

eShopOnAbp 展示了如何使用 ABP 框架构建微服务架构。每个微服务都是一个独立的模块，可以独立部署和扩展。API 网关用于路由请求和管理微服务之间的通信。

3.2 Kubernetes 部署

该项目展示了如何在 Kubernetes 上使用 Helm 配置来部署微服务。Helm 是一个 Kubernetes 包管理器，简化了 Kubernetes 应用的部署和管理。

3.3 数据库集成

eShopOnAbp 使用了 PostgreSQL 和 MongoDB 两种数据库。PostgreSQL 用于关系型数据存储，而 MongoDB 用于非关系型数据存储。这种混合数据库的使用展示了如何在微服务架构中灵活选择数据库。

4. 典型生态项目

4.1 ABP Framework

eShopOnAbp 基于 ABP 框架构建。ABP 框架是一个开源的应用程序框架，旨在简化 ASP.NET Core 应用程序的开发。它提供了模块化架构、领域驱动设计（DDD）支持、多租户、身份验证和授权等功能。

4.2 Kubernetes

Kubernetes 是一个开源的容器编排平台，用于自动化部署、扩展和管理容器化应用。eShopOnAbp 展示了如何在 Kubernetes 上部署和管理微服务。

4.3 Helm

Helm 是一个 Kubernetes 包管理器，用于简化 Kubernetes 应用的部署和管理。eShopOnAbp 使用了 Helm 来配置和管理 Kubernetes 上的微服务部署。

4.4 Angular

Angular 是一个流行的前端框架，用于构建单页应用（SPA）。eShopOnAbp 的前端部分使用了 Angular 来构建用户界面。

通过以上模块的介绍和快速启动指南，您可以快速上手并深入了解 eShopOnAbp 项目。