SurgingDemo 使用教程

1. 项目介绍

SurgingDemo 是一个基于 Surging 分布式微服务框架的入门示例项目。Surging 是一个高性能、轻量级的分布式服务框架，适用于构建企业级互联网架构平台、传统大型项目以及移动互联网项目。SurgingDemo 通过一个基本的增删改查示例，展示了如何在 Surging 框架上运行 Dapper 完成业务操作，并利用 Surging 的强大分布式缓存功能。

2. 项目快速启动

2.1 环境准备

• 安装 .NET Core SDK（建议使用 2.2 及以上版本）
• 安装 SQL Server
• 安装 Consul（用于服务注册与发现）

2.2 克隆项目

git clone https://github.com/billyang/SurgingDemo.git

2.3 配置数据库

1. 在 SQL Server 中创建一个名为 Test 的数据库。
2. 运行以下脚本创建 User 表：

CREATE TABLE [dbo].[User] (
    [Id] [bigint] IDENTITY(1,1) NOT NULL,
    [Name] [nvarchar](50) NOT NULL,
    [Email] [nvarchar](100) NOT NULL,
    [PhoneNumber] [nvarchar](20) NULL,
    [CreatedAt] [datetime] NOT NULL,
    CONSTRAINT [PK_User] PRIMARY KEY CLUSTERED ([Id] ASC)
);

3. 修改 Bill.Demo.DapperCore 项目下的 DataBaseConfig.cs 文件，配置数据库连接字符串。

2.4 启动服务

1. 启动 Consul：

consul agent -dev

2. 启动 Surging ApiGateway：

dotnet run --project Surging.ApiGateway

3. 启动服务端：

dotnet run --project Bill.Demo.Services.Server

4. 启动客户端（本示例使用 Web MVC）：

dotnet run --project Bill.Demo.Web

2.5 访问应用

打开浏览器，访问 http://localhost:5000，即可进行用户数据的增删改查操作。

3. 应用案例和最佳实践

3.1 企业级互联网架构平台

Surging 适用于构建企业级互联网架构平台，能够应对高并发、大流量的场景。例如，在双十一等大型促销活动中，Surging 可以有效处理订单暴增的情况。

3.2 传统大型项目

对于传统的大型项目，Surging 提供了强大的伸缩性，能够应对突发的流量暴增。通过分布式缓存和负载均衡，确保系统在高负载下的稳定运行。

3.3 移动互联网项目

在移动互联网项目中，Surging 可以应对因营销活动带来的流量暴增，如评论暴增等情况。通过分布式架构，确保系统的稳定性和高性能。

4. 典型生态项目

4.1 Surging 官方项目

• Surging: 高性能、轻量级的分布式服务框架，提供服务治理、负载均衡、服务发现等功能。
• Surging.ApiGateway: 提供服务管理以及网关统一访问入口，支持权限验证、数据监控等功能。

4.2 相关项目

• Dapper: 轻量级的对象关系映射（ORM）工具，用于数据库操作。
• Consul: 服务发现和配置管理工具，用于服务注册与发现。

通过以上步骤，您可以快速启动并运行 SurgingDemo 项目，体验 Surging 分布式微服务框架的强大功能。