madao_service 开源项目教程
1. 项目介绍
madao_service
是一个基于 Spring Cloud 全家桶的微服务架构项目。该项目旨在帮助开发者快速学习和实践微服务架构,适用于企业环境开发。权限管理基于 URL 细粒度授权,确保系统的安全性和灵活性。
项目主要模块包括:
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
: 微服务网关中心
2. 项目快速启动
前置环境
- IDE: IntelliJ IDEA
- JDK: 17+
- 工具: Maven
快速开始步骤
-
导入服务 点击 "import module" 将服务一一导入。如果你嫌一个个导入麻烦,可以在
madao-common-parent
的pom.xml
文件中最底下把标签放开。<!-- 示例代码 --> <modules> <module>madao-common</module> <module>madao-service-api</module> <!-- 其他模块 --> </modules>
-
构建服务 使用 Maven 构建服务,跳过测试。
mvn -B -DskipTests install -f madao_service/madao-common-parent mvn -B -DskipTests install -f madao_service/madao-common mvn -B -DskipTests install -f madao_service/madao-service-api mvn -B -DskipTests install -f madao_service/madao-service-article
-
配置文件 将配置文件从 Jenkins 复制到相应服务的资源目录。
sh "/bin/cp -f /var/jenkins_home/service-config/config-server.jks madao_service/madao-server-config/src/main/resources/" sh "/bin/cp -f /var/jenkins_home/service-config/bootstrap.yml madao_service/madao-server-config/src/main/resources/" sh "/bin/cp -f /var/jenkins_home/service-config/application.yml madao_service/madao-authentication-server/src/main/resources/" sh "/bin/cp -f /var/jenkins_home/service-config/JWT.keystore madao_service/madao-authentication-server/src/main/resources/"
3. 应用案例和最佳实践
应用案例
- 企业内部管理系统: 使用
madao_service
构建企业内部管理系统,实现用户管理、权限控制、文章发布等功能。 - 博客系统: 基于
madao_service
构建个人博客系统,实现文章发布、搜索、用户评论等功能。
最佳实践
- 模块化开发: 每个服务独立开发,便于团队协作和维护。
- 配置中心: 使用
madao-service-config
统一管理配置,确保配置的一致性和安全性。 - 网关中心: 使用
madao-web-gateway
作为统一入口,实现路由、负载均衡和安全认证。
4. 典型生态项目
- Spring Cloud: 提供微服务架构的核心组件,如服务注册与发现、配置中心、负载均衡等。
- Jenkins: 用于持续集成和持续部署,自动化构建和发布流程。
- Docker: 用于容器化部署,确保环境一致性和快速部署。
- Kubernetes: 用于容器编排,实现高可用和弹性扩展。
通过以上模块的介绍和快速启动步骤,您可以快速上手 madao_service
项目,并将其应用于实际开发中。