AG-Admin 一个spring cloud的好例子

比眉伴天荒 2022-06-09 05:45 203阅读 0赞

https://github.com/wxiaoqi/ace-admin

# AG-Admin #

AG-Admin是基于Spring Cloud实现的`前后端分离`的后台管理信息系统，具备用户管理、部门管理、菜单管理等多个模块，支持多业务系统并行开发，可以作为后台管理系统的脚手架。代码简洁，架构清晰，适合学习和直接项目中使用。核心技术采用Eureka、Fegin、Ribbon、Zuul、Hystrix、Security、OAth、Mybatis、Ace-cache等主要框架和中间件，前端采用Layui组件。

QQ群号：169824183

访问地址: [http://120.77.133.155/admin/index][http_120.77.133.155_admin_index]

账号/密码：admin/admin

[![Markdown][]][Markdown]

--------------------

# 模块说明 #

[![img][]][img]

### 架构详解 ###

#### 监控 ####

利用Spring Boot Admin 来监控各个独立Service的运行状态；利用Hystrix Dashboard来实时查看接口的运行状态和调用频率等。

#### 负载均衡 ####

将服务保留的rest进行代理和网关控制，除了平常经常使用的node.js、nginx外，Spring Cloud系列的zuul和rebbion，可以帮我们进行正常的网关管控和负载均衡。

#### 服务注册与调用 ####

基于Eureka来实现的服务注册与调用，在Spring Cloud中使用Feign, 我们可以做到使用HTTP请求远程服务时能与调用本地方法一样的编码体验，开发者完全感知不到这是远程方法，更感知不到这是个HTTP请求。

#### 熔断机智 ####

因为采取了服务的分布，为了避免服务之间的调用“雪蹦”，我采用了Hystrix的作为熔断器，避免了服务之间的“雪蹦”。

--------------------

# 项目结构 #

├─ace-security
    │  │  
    │  ├─ace-admin----------------管理端服务层
    │  │  
    │  ├─ace-gate-----------------网关负载中心
    │  │ 
    │  ├─ace-ui-------------------前端UI层面
    │  │    
    │  ├─ace-center---------------服务注册中心
    │  │   
    │  ├─ace-monitor--------------监控中心
    │  │
    │  ├─ace-config---------------配置中心
    │  │
    │  └─ace-api------------------公共服务接口包
    │

--------------------

# 功能简介 #

1.  用户管理
2.  角色管理
3.  部门管理（待完善）
4.  菜单管理
5.  字典管理
6.  操作日志
7.  监控管理
8.  消息管理（待完善）
9.  代码生成（待完善）

--------------------

# 启动指南 #

## 部署须知 ##

*  mysql数据库一个，redis数据库一个
 *  jdk1.8
 *  IDE插件一个，lombok插件，具体百度即可

## 运行步骤 ##

*  运行数据库脚本：依次运行数据库：ace-admin/db/init.sql
 *  修改配置数据库配置：ace-admin/src/main/resources/application.yml、ace-gate/src/main/resources/application.yml
 *  依次运行main类：CenterBootstrap（ace-center）、ConfigServerBootstrap（ace-config）、GateBootstrap（ace-gate）、AdminBootstrap（ace-admin）、UIBootstrap（ace-ui）
 *  访问地址: [http://localhost:8765/admin/index][http_localhost_8765_admin_index] 账号/密码：admin/admin

## 运行博客 ##

*  运行数据脚本：ace-blog-admin/db/init.sql
 *  除了上述需要运行的main类外，依次运行BlogUIBootstrap、BlogAdminBootstrap
 *  前端访问地址：[http://localhost:9700/home][http_localhost_9700_home]
 *  后端访问地址：[http://localhost:8765/admin/index][http_localhost_8765_admin_index] 账号/密码：blog/blog

# 开发指南 #

[AG-Admin开发手手册\_v1.1][AG-Admin_v1.1]

--------------------

### 2017年7月29日 Config-Server引入 ###

[![img][img 1]][img 1]

*  增加`Spring cloud config`，默认配置地址：[http://git.oschina.net/geek\_qi/AG-Config][http_git.oschina.net_geek_qi_AG-Config]
 *  ace-gate中关于网关配置抽离至config git服务器
 *  修改spring cloud config 服务地址：ace-config/src/main/resources/application.yml中git地址
 *  相对于携程的apollo的配置中心，spring cloud config不是很好用

### 2017年7月19日 后端内容管理和前端博客demo ###

[![img][img 2]][img 2][![img][img 3]][img 3]

*  完成用户浏览前端和后端管理的demo

### 2017年7月7日 用户无状态登陆 ###

*  完成用户基于token方式登陆
 *  增加用户jwt认证

### 2017年6月25日 完成资源权限管控 ###

[![img][img 4]][img 4][![img][img 5]][img 5]

*  集成spring session
 *  完成服务无状态权限拦截
 *  完成前端和后端权限拦截
 *  页面按钮权限显示和隐藏（待完成）

### 2017年6月24日 完善监控模块 ###

[![img][img 6]][img 6][![img][img 7]][img 7][![img][img 8]][img 8]

*  druid监控集成
 *  spring boot监控集成
 *  hystrix监控集成

### 2017年6月20日 完成角色和部门模块 ###

[![img][img 9]][img 9]

*  完成动态用户组设计
 *  完成动态角色、部门组功能
 *  完成角色与用户的关联
 *  完成角色与菜单的关联

### 2017年6月17日 完成菜单管理模块 ###

[![img][img 10]][img 10]

*  引入boostrap table
 *  抽象基础Controller类
 *  完成菜单的增删改查和树状
 *  多系统菜单切换

### 2017年6月13日 完成登录统一拦截 ###

[![img][img 11]][img 11]

*  spring security进行统一登录拦截

### 2017年6月10日 用户管理增删改查 ###

[![Markdown][]][Markdown]

*  完成后端的UI的选型
 *  完成首页改进
 *  完成用户模块的增删该查
 *  完成前后端分离的模块联通
 *  完成监控模块

# 版本日志 #

### 2017年6月6日 初步架构搭建 ###

*  完成spring cloud相关核心组件整合和搭建
 *  完成Hello World服务的调用和负载
 *  完成网关的初步代理
 *  完成监控中心的搭建

[http_120.77.133.155_admin_index]: http://120.77.133.155/admin/index
[Markdown]: https://camo.githubusercontent.com/8a2489627413326bc010b48c60aa77676f060bb5/687474703a2f2f69312e6275696d672e636f6d2f313934392f333966626538636266356664393631662e706e67
[img]: https://camo.githubusercontent.com/ca861274388a409eb3a01924c3552d3ffcdbaebb/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32382f313439383633353335313339312e6a7067
[http_localhost_8765_admin_index]: http://localhost:8765/admin/index
[http_localhost_9700_home]: http://localhost:9700/home
[AG-Admin_v1.1]: https://github.com/wxiaoqi/ace-admin/wiki/AG-Admin%E5%BC%80%E5%8F%91%E6%89%8B%E6%89%8B%E5%86%8C_v1.1
[img 1]: https://camo.githubusercontent.com/ee3a0f592123401de8477e945c5de0bec67f15fd/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30372d32392f313530313330313232313437352e6a7067
[http_git.oschina.net_geek_qi_AG-Config]: http://git.oschina.net/geek_qi/AG-Config
[img 2]: https://camo.githubusercontent.com/3ed06006b16b580bb77b26a1b63622539733cb0e/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30372d31392f313530303432353331323831362e6a7067
[img 3]: https://camo.githubusercontent.com/3b81ba7a6a289e5ee8c21db8523da1f67b47b8f5/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30372d31392f313530303432353931353332382e6a7067
[img 4]: https://camo.githubusercontent.com/3e52d1b49349bf7e9d7de68975146fa74de4fc92/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32342f313439383331333836343730312e6a7067
[img 5]: https://camo.githubusercontent.com/1c2096565f560390d4f60a7845bfa377577bc0a6/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32342f313439383331333737343434392e6a7067
[img 6]: https://camo.githubusercontent.com/46cc3ca4bb4e4bb5283d15dd3a3a4fd75a49b58f/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32342f313439383331333933333333322e6a7067
[img 7]: https://camo.githubusercontent.com/5448aae209fae2c9352a1eb81c962fc68ae392da/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32342f313439383331343035373033392e6a7067
[img 8]: https://camo.githubusercontent.com/9a620276d7506602c369c6978f5bcebb4c227f40/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d32342f313439383331343039373336302e6a7067
[img 9]: https://camo.githubusercontent.com/145d5ac0fc3d9e15366d7694f86f0fb23a6eea91/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d31372f313439373639383334383039372e6a7067
[img 10]: https://camo.githubusercontent.com/1cb5fe39144c39e6d6eef7938761cd823289b086/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d31352f313439373534303837303134382e6a7067
[img 11]: https://camo.githubusercontent.com/ecb0685b02737ab3263855b37c9cc6d0244fd9c6/687474703a2f2f6f66736333327435392e626b742e636c6f7564646e2e636f6d2f31372d30362d31352f313439373534313232363032332e6a70673f696d61676556696577322f322f772f383030