Skip to content

使用 Consul 快速开始

  1. 本项目代码提供使用 consul 作为注册与配置中心,分为 Spring Boot 2、3 两个产品线,并且同时开发,请根据自己的需要检出对应分支的代码。
  2. 本项目代码提供使用 nacos 作为注册与配置中心,分为 Spring Boot 2、3 两个产品线,并且同时开发,如需了解 nacos,请阅读: 使用 nacos 快速开始?

分支介绍

检出代码

  • 也可使用 github 的域名检出代码,只需要将下方的 gitee.com 替换成 github.com
  • 请勿仅使用一份检出代码查看两个不同的分支,避免 IDEA 等编程软件依赖加载问题导致项目无法启动
shell
git clone -b consul/spring-boot-2 https://gitee.com/xuxiaowei-cloud/spring-cloud-xuxiaowei.git spring-cloud-xuxiaowei-consul-2
shell
git clone -b consul/spring-boot-3 https://gitee.com/xuxiaowei-cloud/spring-cloud-xuxiaowei.git spring-cloud-xuxiaowei-consul-3

环境准备

markdown
| 软件     | 版本     |
|--------|--------|
| consul | 1.18.1 |
| JDK    | 8      |
| Maven  | 3.6.3+ |
| MySQL  | 8.0.36 |
| Redis  | 7.2.4  |
| Node   | 18.0+  |
markdown
| 软件     | 版本     |
|--------|--------|
| consul | 1.18.1 |
| JDK    | 17     |
| Maven  | 3.6.3+ |
| MySQL  | 8.0.36 |
| Redis  | 7.2.4  |
| Node   | 18.0+  |

环境变量

  • 十二要素应用宣言 > III. 配置 在环境中存储配置
  • XUXIAOWEI_REDIS_DATABASE
    • Redis 数据库
    • consul/spring-boot-2 分支默认使用 Redis 数据库为
    • consul/spring-boot-3 分支默认使用 Redis 数据库为
    • consul/spring-boot-2consul/spring-boot-3 分别使用不同的 Redis 配置文件:Spring Boot 2、3 的配置不同
环境变量名称环境变量默认值环境变量说明
XUXIAOWEI_DATABASE_HOST127.0.0.1MySQL 数据库 IP
XUXIAOWEI_DATABASE_PORT3306MySQL 数据库 端口
XUXIAOWEI_DATABASEspring_cloud_xuxiaoweiMySQL 数据库 名称
XUXIAOWEI_DATABASE_USERNAMErootMySQL 数据库 用户名
XUXIAOWEI_DATABASE_PASSWORDxuxiaowei.com.cnMySQL 数据库 密码
XUXIAOWEI_REDIS_HOST127.0.0.1Redis IP
XUXIAOWEI_REDIS_PORT6379Redis 端口
XUXIAOWEI_REDIS_PASSWORDxuxiaowei.com.cnRedis 密码
XUXIAOWEI_REDIS_DATABASE2(或 Redis 数据库
XUXIAOWEI_CONSUL_HOST127.0.0.1consul 注册 IP
XUXIAOWEI_CONSUL_PORT8500consul 注册 端口

其他环境变量

环境变量名称环境变量默认值环境变量说明
XUXIAOWEI_SPRINGDOC_OAUTHFLOW_TOKEN_URLhttp://127.0.0.1:8000/passport/oauth2/tokenSwagger 调试 OAuth 2 授权 Token 地址

表结构及基础数据

  • 在检出项目的 sql 文件夹下
  • 请根据 sql 文件夹下的文件名顺序执行创建表结构及基础数据
    • 注意:sql 脚本中的数据库名

启动项目

  1. 启动 consul 服务:注册与配置中心

    1. consul 资料
    2. 将项目 consul/kv 文件夹下的配置添加到 consul 中,consul 中的目录结构和 consul/kv 文件夹中的相同
    3. 可以使用作者开发 consul-go 工具,一键 添加/备份 数据
      1. 支持平台:loong64windows amd64windows arm64darwin amd64darwin arm64linux amd64linux arm64
      2. Gitee
        1. 请在 发行版 下载最新版编译产物
      3. GitHub
        1. 请在 releases 下载最新版编译产物
  2. 启动 Java 项目 spring-cloud-xuxiaowei-gateway 服务:网关服务

  3. 启动 Java 项目 spring-cloud-xuxiaowei-passport 服务:登陆授权服务

  4. 安装 Node 项目 spring-cloud-xuxiaowei-ui 依赖

    shell
    npm run pre:npm
    shell
    npm run pre:yarn
    shell
    npm run pre:pnpm
  5. 启动 Node 项目 spring-cloud-xuxiaowei-ui

    shell
    npm run dev
  6. 访问 Node 项目