Silky微服务框架在线文档Silky微服务框架在线文档
首页
文档
配置
源码解析
博文
github
gitee
  • 简体中文
  • English
首页
文档
配置
源码解析
博文
github
gitee
  • 简体中文
  • English
  • 简介

    • silky 框架介绍
  • 入门

    • 名词解释
    • 快速开始
    • 脚手架
    • 微服务模块化架构的最佳实践 & 约定
    • 示例
  • 主机与模块

    • 主机
    • 网关
    • 模块
    • 插件
  • 网关与 HTTP

    • Swagger 文档
    • 性能分析(MiniProfiler)
    • 跨域(CORS)
    • 审计日志
  • 服务与 RPC

    • 应用服务和服务条目
    • rpc通信
    • websocket通信
    •  服务注册中心
    • 服务治理
  • 数据与缓存

    • EFCore 数据访问
    • 缓存
    • 分布式锁
  • 安全与认证

    • 身份认证与授权
    • 分布式事务
  • 基础设施

    • 依赖注入
    • 对象到对象的映射
    • 参数验证
    • 链路跟踪
    • 日志(Serilog)
    • 健康检查
    • 消息总线(MassTransit)
    • 单元测试与集成测试

简介

silky 示例项目 位于项目根目录下的 samples 目录,主要演示如何通过 silky 框架快速构建一个分布式微服务应用。

示例项目主要由两部分构成:

  1. 业务微服务应用模块:包含账户、订单、库存三个独立的微服务
  2. 网关应用:作为集群的统一流量入口

示例演示的功能

功能说明
项目分层结构应用接口层、应用层、领域层、基础设施层的典型划分
应用服务定义与实现[ServiceRoute] 特性的使用方式
服务间 RPC 通信通过应用接口代理实现透明调用
缓存拦截GetCachingIntercept、RemoveCachingIntercept 等缓存特性的使用
分布式事务通过下订单场景演示 TCC 分布式事务的使用
统一认证授权网关层 JWT 认证与授权

开发者可通过以下博文深入学习示例项目:

  • 通过 silky.samples 熟悉 silky 微服务框架的使用
  • silky 框架分布式事务使用简介

快速启动示例项目

步骤一:启动基础服务

进入 samples/docker-compose/infrastr 目录,通过 docker-compose 启动所需的基础服务(Zookeeper、Redis、MySQL):

docker-compose -f docker-compose.mysql.yml -f docker-compose.redis.yml -f docker-compose.zookeeper.yml up -d

步骤二:执行数据库迁移

分别进入各微服务的 EntityFrameworkCore 项目目录,执行数据库迁移:

dotnet ef database update

步骤三:运行示例项目

使用 Visual Studio 2022+ 或 JetBrains Rider 打开解决方案,设置多项目启动(网关 + 各业务微服务),或分别启动各个项目。

启动所有服务后,通过网关的 Swagger 文档地址(如 http://localhost:5000/index.html)查看和调试 API。


其他示例

Silky.Hero 权限管理系统

Silky.Hero 是基于 silky 框架构建的完整企业级权限管理系统,包含以下特性:

  • 多租户支持
  • 基于 RBAC 的权限管理
  • 完整的用户、角色、组织机构管理
  • 基于 Vue 3 的前端界面

演示地址:https://hero.silky-fk.com

账号信息(租户 silky):

  • 管理员:admin / 123qweR!
  • 普通用户:liuhll / 123qweR!
编辑当前页
Prev
微服务模块化架构的最佳实践 & 约定