项目下载

后端源码下载地址:下载后端代码

前端源码下载地址:下载前端代码

所需中间件及环境

  • jdk 1.8       必须
  • maven >= 3.0       必须
  • nacos >=2.3.1       必须
  • redis      必须
  • minio       必须(文件管理)、可替换成obs
  • mysql      可修改成其他数据库、默认mysql >= 8.0
  • RabbitMQ      非必须、用于记录接口调用记录
  • xxl-job      非必须
  • sentinel      非必须

所需中间件安装包下载

资源下载地址

初始化配置

  1. 在nacos管理界面新建一个命名空间
  2. 下载nacos配置文件、导入nacos中
  3. 创建数据库 库名 yipeng_auth 无需导入数据表 项目启动时会自动在库里生成表结构及初始化数据
  4. 在nacos中修改 yipeng.core.yaml 把redis、rabbitmq、minio 地址改成你自己的
  redis:
    open: true 
    database: 0 
    host: 127.0.0.1 #修改ip地址
    port: 6379 #修改端口
    password: password #修改密码
    timeout: 6000ms
    jedis:
      pool:
        max-active: 1000 
        max-wait: -1ms  
        max-idle: 10 
        min-idle: 5
rabbitmq:
    host: 127.0.0.1 #修改ip地址
    port: 5672  #修改端口
    username: username #修改用户名
    password: password #修改密码
    virtual-host:
    publisher-returns: true
    publisher-confirm-type: correlated
kp:
  minio:
    url: http://127.0.0.1:9000
    user-name: username
    password: password
  1. 在nacos中修改 authentication 配置文件、把数据库链接改成你自己的
spring:
  datasource:
    dynamic:
      primary: yipeng_auth # 设置主数据源为 yipeng_auth
      p6spy: false  
      strict: false  
      datasource:
        yipeng_auth:
          url: jdbc:mysql://127.0.0.1:3306/yipeng_auth?useUnicode=true&autoReconnect=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false&zeroDateTimeBehavior=CONVERT_TO_NULL
          username: username #修改用户名
          password: password # 修改密码
          driver-class-name: com.mysql.jdbc.Driver
  1. 启动网关:修改网关代码 yipeng-gateway 中resources 里面bootstrap-dev.yml文件,把nacos地址改成你自己的
spring:
  cloud:
    nacos:
      username: username #修改用户名
      password: password #修改密码
      discovery:
        server-addr: http://127.0.0.1:8848 #修改ip地址
        namespace: b502bb03-dd78-4078-8934-111111111 # 修改命名空间
      config:
        server-addr: http://127.0.0.1:8848 #修改ip地址
        namespace: b502bb03-dd78-4078-8934-111111111 # 修改命名空间
        group: DEFAULT_GROUP
        file-extension: yaml
        prefix: gateway
logging:
  level:
    org.springframework.cloud.gateway: TRACE
    org.springframework.cloud.loadbalancer: DEBUG
  1. 启动鉴权服务:修改网关代码 yipeng-auth 中resources 里面bootstrap-dev.yml文件,把nacos地址改成你自己的
spring:
  cloud:
    nacos:
      username: username #修改用户名
      password: password #修改密码
      discovery:
        server-addr: http://127.0.0.1:8848 #修改ip地址
        namespace: b502bb03-dd78-4078-8934-111111111 # 修改命名空间
      config:
        server-addr: http://127.0.0.1:8848 #修改ip地址
        namespace: b502bb03-dd78-4078-8934-111111111 # 修改命名空间
        group: DEFAULT_GROUP
        file-extension: yaml
        prefix: authentication
        extension-configs:
          - data-id: yipeng.core.yaml
            group: DEFAULT_GROUP
            refresh: true

logging:
  level:
    com.kp.framework.modules: debug

  1. 启动前端代码:下载前端代码,然后启动,具体操作请参考前端文档

恭喜您,易鹏系统已经搭建完成。现在开始体验吧

切换其他数据源

易鹏框架原生支持多类型数据库适配,包括 MySQL、Oracle、SQL Server、PostgreSQL 等; 其中开源系统(鉴权系统、周汇通)当前已完成 MySQL、PostgreSQL 两种数据库的适配。

鉴权系统、周汇通默认使用 MySQL 作为数据源,若需切换至 PostgreSQL,仅需修改 Nacos 配置文件 yipeng.core.yamlflyway.locations 配置项: 将原配置值 classpath:db 替换为 classpath:pgsql 即可,完整配置示例如下:

flyway:
  enabled: true # 是否开启 Flyway
  encoding: UTF-8 # 设置数据库编码格式
  locations: classpath:pgsql # 设置 Flyway 的 SQL 文件位置
  baselineOnMigrate: true # 是否在迁移过程中执行基线操作
  sqlMigrationPrefix: V # 设置 SQL 文件前缀
  sqlMigrationSeparator: _ # 设置 SQL 文件分隔符
  sqlMigrationSuffixes: sql # 设置 SQL 文件后缀
  validateOnMigrate: true # 是否在迁移过程中验证数据库

在对应项目配置文件下,把数据源改成PostgreSQL,完整配置示例如下:

spring:
  datasource:
    dynamic:
      primary: yipeng_auth # 设置主数据源为 yipeng_auth
      p6spy: false # 是否启用 P6Spy 进行 SQL 监控,默认为 false
      strict: false  # 是否严格匹配数据源,默认为 false
      datasource:
        yipeng_auth:
          url: jdbc:postgresql://127.0.0.7:5432/yipeng_auth_dev?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
          username: username
          password: password
          driver-class-name: org.postgresql.Driver

若需将鉴权系统、周汇通适配 MySQL、PostgreSQL 以外的其他数据库,可自行基于易鹏框架进行扩展适配,或等待官方后续版本更新。