环境搭建

    • 以后都是基于插件化可插拔的思想，本文是说明如何基于soul搭建属于你自己网关。
    • 请确保你的机器安装了JDK 1.8+，Mysql 5.5.20 +。

    • 解压缩 soul-admin-bin-2.3.0-RELEASE.tar.gz。 进入 bin 目录。

    • 使用 h2 来存储后台数据

    • 使用 mysql 来存储后台数据。 进入 /conf 目录，修改 application.yaml 中mysql 的配置。
    1. > windows : start.bat 
    4. > linux : ./start.sh

    docker构建

    1. > docker pull dromara/soul-admin
    2. > docker network create soul
    • 使用 h2 来存储后台数据
    1. > docker run -d -p 9095:9095 --net soul dromara/soul-admin
    • 使用 mysql 来存储后台数据。
    1. docker run -e "SPRING_PROFILES_ACTIVE=mysql" -d -p 9095:9095 --net soul dromara/soul-admin

    如果你想覆盖环境变量，你可以这样操作。

    把你的application.yml配置放到xxx目录， 然后执行以下语句。

    1. docker run -v D:\tmp\conf:/opt/soul-admin/conf/ -d -p 9095:9095 --net soul dromara/soul-admin
    • 下载代码
    1. > git clone https://github.com/dromara/soul.git
    • 编译代码
    1. > mvn clean install -Dmaven.javadoc.skip=true -B -Drat.skip=true -Djacoco.skip=true -DskipITs -DskipTests

    • 启动 SoulAdminBootstrap。

      • 如果使用h2来存储，设置变量 --spring.profiles.active = h2
      • 如果使用mysql来存储，修改 中的 mysql 配置。

    访问 用户名密码为: admin/123456

    远程下载

    • 解压缩 soul-bootstrap-bin-2.3.0-RELEASE.tar.gz。 进入 bin 目录。

    1. > windows : start.bat 
    4. > linux : ./start.sh

    本地构建

    • 下载代码
    1. > git clone https://github.com/dromara/soul.git
    2. > cd soul
    • 编译代码
    1. > mvn clean install -Dmaven.javadoc.skip=true -B -Drat.skip=true -Djacoco.skip=true -DskipITs -DskipTests
    • 启动 SoulBootstrap。

    • 首先你新建一个空的springboot项目，可以参考soul-bootstrap. 也可以在spring官网:https://spring.io/quickstart

    • 引入如下jar包：

    1.   <dependency>
    2.         <groupId>org.springframework.boot</groupId>
    3.         <artifactId>spring-boot-starter-webflux</artifactId>
    4.         <version>2.2.2.RELEASE</version>
    5.   </dependency>
    8.   <dependency>
    9.         <groupId>org.springframework.boot</groupId>
    10.         <artifactId>spring-boot-starter-actuator</artifactId>
    11.   </dependency>
    14.   <!--soul gateway start-->
    15.   <dependency>
    16.         <groupId>org.dromara</groupId>
    17.         <artifactId>soul-spring-boot-starter-gateway</artifactId>
    18.         <version>${last.version}</version>
    19.   </dependency>
    21.    <!--soul data sync start use websocket-->
    22.    <dependency>
    23.         <groupId>org.dromara</groupId>
    24.         <artifactId>soul-spring-boot-starter-sync-data-websocket</artifactId>
    25.         <version>${last.version}</version>
    26.    </dependency>
    • 在你的 application.yaml 文件中加上如下配置：
    1. spring:
    2.   main:
    3.     allow-bean-definition-overriding: true
    6. management:
    7.   health:
    8.     defaults:
    9.       enabled: false
    10. soul :
    11.   sync:
    12.     websocket :
    • 你的项目环境搭建完成，启动你的项目。