Dot Net Core 微服务示例教程 - MicroserviceDemo

本教程旨在指导您了解并运行MicroserviceDemo，一个基于.NET Core构建的微服务示例项目。该项目展示如何运用Ocelot作为服务网关，IdentityServer4处理身份验证，并通过CAP确保分布式数据的最终一致性。以下内容将详细介绍项目结构、启动文件以及配置文件的使用。

1. 项目目录结构及介绍

MicroserviceDemo的目录结构精心组织，以体现微服务架构的原则：

• BasicServices: 包含基础服务相关组件。
• BusinessServices: 涉及业务逻辑的服务模块。
• Framework: 提供项目框架支持的代码。
• Logs: 日志处理相关的文件或配置。
• Test/TestConsole: 单元测试或控制台应用用于测试服务。
• images: 存放项目相关的图像文件，如架构图。
• docker-compose.yml: Docker Compose配置文件，用于容器化部署。
• MicroserviceDemo.sln: 解决方案文件，包含所有项目引用。
• README.md: 项目说明文档。
• MIT license: 开源许可协议文件。

每个服务内部遵循领域驱动设计（DDD）原则，可能包含控制器、模型、仓储、服务层等子目录，实现特定业务功能。

2. 项目的启动文件介绍

在MicroserviceDemo中，每个微服务可能都有自己的入口点。一般情况下，这些入口点位于各服务的主程序类中，例如，在.NET Core项目中，这通常指的是Program.cs和Startup.cs文件。

• Program.cs：初始化应用程序上下文，设置宿主环境，调用CreateWebHostBuilder方法来创建Web主机。

• Startup.cs：配置HTTP管道（使用ConfigureServices添加服务到依赖注入容器，而Configure则配置中间件管道），初始化应用程序的关键服务和端点。

对于运行整个解决方案，如果存在统一的服务网关启动项，则可能会有一个主项目的入口点，通过它启动整个微服务集群。

3. 项目的配置文件介绍

MicroserviceDemo利用.NET Core的标准配置机制，配置信息可能来源于多个来源，包括但不限于appsettings.json、appsettings.Development.json（环境特定配置）、环境变量以及命令行参数。

• appsettings.json: 包含了默认的配置信息，如数据库连接字符串、第三方服务API密钥等。

• appsettings.{Environment}.json: 根据当前环境（如Development、Production）加载额外或覆盖默认配置。

此外，项目可能还使用了环境变量进行敏感信息的存储，以增加安全性。配置文件中定义的服务地址、数据库设置、认证秘钥等关键信息，可以根据实际情况调整。

总结

要开始使用MicroserviceDemo，首先需要通过Git克隆仓库到本地，然后依据各个服务的依赖和配置要求，进行环境搭建，包括安装.NET Core SDK、配置数据库连接、配置外部服务如Redis、RabbitMQ等。接着，可以通过dotnet命令或者Docker Compose根据提供的配置文件启动服务。记得查看appsettings.json及其环境变体和任何其他明确指定的配置文件来定制配置。