急速预览---直达
如果喜欢记得给个star哦
🌟
更多内容请关注公众号:码道人生
本仓库基于spring、spring-boot、spring-cloud等全家桶模块搭建
一、技术选型
- 核心框架:SpringBoot、SpringCloud全家桶、Python提供电影服务
- 安全框架:Spring Security
- 分布式任务调度:Elastic-job
- 持久层框架:Jpa
- 数据库连接池:Druid
- 数据库/存储:Mysql8.0+、Redis
- 消息队列:RabbitMQ
- 日志管理:Logback
- 三方服务: 邮件服务、阿里云短信服务、阿里云OSS对象存储
- 运维/集成/部署:Jenkins、Docker...
二、前台项目请移步
三、其他开源仓库
项目 | 地址 |
---|---|
IDEA插件 (IDEA市场搜索 Generate Crud 安装) | 根据JPA实体类生成后端代码,简单快捷 |
pinyinUtils | https://github.com/GuoGuang/pinyinUtils |
后台管理框架 | https://github.com/GuoGuang/madao_admin_manage |
数据爬虫集合 | https://github.com/GuoGuang/python-spider |
前台博客 | https://github.com/GuoGuang/madao |
如何写好单元测试 | https://github.com/GuoGuang/spring_junit_mockito_example |
四、平台目录结构说明
├─madao-common-parent----------------------------父项目,公共依赖
│ │
│ ├─madao-common--------------------------------微服务公共包
│ │
│ ├─madao-service-config-------------------------微服务配置中心+微服务注册中心
│ │
│ ├─madao-service-api---------------------------微服务API工程
│ │
│ ├─madao-service-article-----------------------文章服务
│ │
│ ├─madao-service-base--------------------------基础服务
│ │
│ ├─madao-service-search------------------------搜索服务
│ │
│ ├─madao-service-user--------------------------RBAC用户服务
│ │
│ ├─madao-web-gateway---------------------------微服务网关中心
前置环境
- IDE:IntelliJ IDEA
- JDK:17+
- 工具:Maven
五、快速开始
本项目需要你有一定得开发经验,对SpringCloud有基础的认识,此项目仅提供学习使用。
开源不易,如果此项目对您有帮助,麻烦点个star给作者一点动力,不胜感激。
✨
1. 导入服务
点击 "import module" 将服务一一导入,如果你嫌一个个导入麻烦,可以在madao-common-parent的pom.xml文件中最底下把标签放开,但是真正微服务开发一般一个团队或者一个人负责一个服务,没有一个人同时开发多个服务情况,毕竟是个人博客项目,导入方式可以自己定。
// install
mvn -B -DskipTests install -f madao-common-parent -Dmaven.test.skip=true
或者
idea里 maven选项选中madao-common-parent install 需要在Maven Projects界面里中选中"跳过测试"
2. 初始化数据库
导入系统根路径下madao.sql文件到数据库中
3. 初始化中间件
一个成熟的项目必然会依赖众多中间件,本项目也不例外,这里假设你会使用docker,如果你还没有接触到docker,那么可以参考我的另一篇文章Docker入门
使用docker启动mysql、redis
```
// mysql
docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root -d mysql --lower_case_table_names=1
// redis
docker run --name myredis -d -p 6379:6379 -v /data/redis/redis.conf:/etc/redis/redis.conf -v /data/redis/data:/data redis redis-server /etc/redis/redis.conf --requirepass "root" --appendonly yes
// rebbitmq 暂时没有用到,可以先pass
docker run -d --name rabbit-server -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin -p 5672:5672 -p 15672:15672 rabbitmq:3-management
```
4. 配置注册中心远程仓库
github fork此仓库配置中心 将里面的配置文件更改为你的地址,阿里云oss地址没有的话可以注释掉
5. 配置注册中心远程地址
在madao-server-config服务中找到bootstrap.yml文件,配置如下
spring:
profiles:
active: ${ACTIVE_PROFILE:dev}
cloud:
config:
server:
encrypt:
enabled: true # 启用config加密功能
git:
uri: 第2步配置的注册中心远程仓库地址
searchPaths: ${spring.profiles.active}
default-label: master
username: 你的github账号
password: '你的github密码'
enabled: true # 开启消息跟踪
# 非对称加密,将下面的配置注释。如果上面配置的"你的github密码"地方是明文,这里就不用管
# encrypt:
# key-store:
# location: classpath:xxx
# alias: xxx
# password: xxx
# secret: xxx
6. 启动
第一步首先启动madao-service-config服务,这个是注册中心+配置中心,然后再启动其他的服务。
Swagger
本地访问地址 默认账号:admin 密码:password
SpringSecurity流程
大致了解一下SpringSecurity的流程,方便对整个项目的了解
常见问题
1、关于内存问题
SpringCloud是比较吃内存的,如果你不指定内存大小,8G内存一般启3、4个就满了,所以这里需要配置下每个服务内存大小
打开Environment config,如果你不指定在哪打开,参考https://www.jetbrains.com/help/idea/2019.3/run-debug-configuration-junit.html?utm_campaign=IU&utm_content=2019.3&utm_medium=link&utm_source=product#configTab 的VM options
类似 config、gateway、eureka、 Oauth2Authentication、服务配置为 -Xmx128m -Xms128m -Xmn50m
其他的-Xmx236m -Xms236m -Xmn150m
以上配置请不要再生产使用,仅作为本地开发调试,为解决内存不足问题的,当然如果你的内存够大,可以忽略以上配置
2、javax.annotation.processing.FilerException: Attempt to recreate a file for xxx
maven install之前先maven clean
启动微服务
架构图
服务监控平台
启动 madao-service-monitor 服务 访问 地址
更新日志
- [20211128]:实现分布式Socket弹幕功能
- [20211111]:基于loadbalancer重写负载均衡器,实现前端指定后端实例访问的功能。
- [20210505]:将资源缓存化,加快访问速度。
- [20210412]:移除不必要得依赖,项目结构重构。
- [20210204]:Spring-Cloud-Gateway 集成 Swagger,支持认证后访问,由网关统一管理。