# spring-cloud-alibaba-template

**Repository Path**: lib108/spring-cloud-alibaba-template

## Basic Information

- **Project Name**: spring-cloud-alibaba-template
- **Description**: Spring-cloud-alibaba 微服务工程模板，已集成当下主流技术框架。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-29
- **Last Updated**: 2022-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 介绍

本工程可作为微服务项目脚手架使用，采用了当下主流的 `Spring Cloud` & `Spring Cloud Alibaba` 微服务解决方案，在通用业务的基础集成了服务注册中心、配置中心、链路追踪、熔断器、权限认证等核心功能。同时提供了一套基于 `vue.js` & `vue-element-admin` 的后台管理系统。


> NOTE：
> 1. 项目使用`Spring Cloud Hoxton.SR9`版本 
> 2. 官方支持`SpringBoot 2.3.5.RELEASE`
> 3. 文档持续完善中

## 组织结构

- ~~tiny-dependencies~~：统一的依赖管理模块
- `tiny-commons`：通用的工具类库模块
- `tiny-commons-entity`：通用的领域模型模块
- `tiny-commons-mapper`：通用的数据访问模块
- `tiny-commons-service`：通用的业务逻辑模块
- `tiny-security`：授权与认证模块
- `tiny-mbg`：通用的代码生成
- `tiny-skywalking`：外部的链路追踪
- `tiny-gateway`：路由网关统一访问接口
- `tiny-service-search`：全文检索模块
- `tiny-service-user`：用户服务模块

## 服务规划

|服务模块|端口|说明|
|---|---|---|
|tiny-gateway       |9000|路由网关统一访问接口|
|tiny-service-search|9500|全文检索模块|
|tiny-service-user  |9600|用户服务模块|
|···|···|···|

## 项目演示

[tiny-demo](http://47.105.186.18)

## 技术选型

### 后端技术

|技术        | 说明          |官网|
|---|---|---|
|Spring Cloud|    Spring官方提供的微服务解决方案    |https://spring.io/projects/spring-cloud|
|Spring Cloud Alibaba|    Alibaba提供的微服务框架    |https://github.com/alibaba/spring-cloud-alibaba|
|Spring Boot    | 全新容器+MVC框架    |https://spring.io/projects/spring-boot|
|Spring Security|认证和授权框架|https://spring.io/projects/spring-security-oauth|
|JWT|JWT授权框架|https://github.com/jwtk/jjwt|
|Mysql|Sql数据库|https://www.mysql.com/|
|Redis|分布式缓存|https://redis.io/|
|MyBatis    |ORM框架|http://www.mybatis.org/mybatis-3/zh/index.html|
|MyBatis-Plus|Mybatis增强工具|https://mp.baomidou.com/|
|MyBatis-Plus Generator|Mybatis代码生成器|https://mp.baomidou.com/guide/generator.html|
|Elasticsearch|  搜索引擎    |https://github.com/elastic/elasticsearch|
|~~RabbitMq~~ |消息队列|https://www.rabbitmq.com/|
|~~Druid~~ --> HikariCP |高性能的 JDBC 连接池组件|https://github.com/brettwooldridge/HikariCP|
|~~OSS~~    |对象存储    |https://github.com/aliyun/aliyun-oss-java-sdk|
|~~MinIO~~|对象存储    |https://github.com/minio/minio|
|Lombok|简化对象封装工具    |https://github.com/rzwitserloot/lombok|
|~~Seata~~|全局事务管理框架    |https://github.com/seata/seata|
|~~Portainer~~    |可视化Docker容器管理    |https://github.com/portainer/portainer|
|Jenkins|持续集成(CI)工具|https://github.com/jenkinsci/jenkins|
|Knife4j|文档生产工具|https://gitee.com/xiaoym/knife4j|
|……|……|……|

### 前端技术

|技术|说明|官网|
|---|---|---|
|Vue        |前端框架              |https://vuejs.org/|
|Vue-router |路由框架             |https://router.vuejs.org/|
|Vuex       |全局状态管理框架         |https://vuex.vuejs.org/|
|Element    |前端UI框架             |https://element.eleme.io/|
|Axios      |前端HTTP框架         |https://github.com/axios/axios|
|v-charts   |基于Echarts的图表框架 |https://v-charts.js.org/|

## 预览

- `SpringSecurity`授权认证中心
  ![授权认证](./doc/springsecurity.png)

- `Spring-Cloud-Gateway` `API`网关
  ![API网关](./doc/gateway.png)

- `Nacos`服务注册发现：

  - `Nacos-Config`动态配置
  ![Nacos配置](doc/nacos-config.png)

  - `Nacos-Discovery`服务注册
  ![Nacos服务](doc/nacos-server.png)
    

- `Sentinel`熔断机制
  
  >开启Sentinel支持feign:`feign.sentinel.enabled=true`

  - 关闭被调用服务，服务访问失败
  ![关闭服务](./doc/service-user-closed.png)
  - 再次访问，服务访问失败，`Sentinel`生效
  ![再次调用用户服务](./doc/service-search-user.png)


- `Skywalking`链路追踪:
  > 自行配置探针
  - 仪表盘
  ![仪表盘](./doc/skywalking.png)

  - 拓扑图
  ![拓扑图](./doc/skywalking2.png)
  
  - 追踪
  ![追踪](./doc/skywalking3.png)
    
  - 错误
  ![错误](./doc/skywalking-error.png)