Solon2 集成 Consul 配置中心

原创
2023/03/06 23:39
阅读数 153

网上关于 Nacos 的使用介绍已经很多了,又是国产确实也好用。关于 Consul 的也很多,不过都是与 Spring Boot 集成的。此文讲讲 Consul 与 Solon 集成与简单使用(是用起来很简单的意思)。

说起 Consul 的部署,用 docker-compose 最是方便。非常适合小项目使用:

version: '3'

services:
  consul:
    image: library/consul
    container_name: consul
    volumes:
      - "./data:/consul/data"
      - "./config:/consul/config"
    ports:
      - 8300:8300
      - 8301:8301
      - 8301:8301/udp
      - 8302:8302
      - 8302:8302/udp
      - 8400:8400
      - 8500:8500
      - 153:53/udp
    command: "agent -server -bind=0.0.0.0 -client=0.0.0.0 -node=consul_Server1 -bootstrap-expect=1 -ui"

启动后用 “http://localhost:8500” 打开(账号:admin;密码:public),就进入管理后台了。

1、认识 Solon

Solon 一个高效的应用开发框架:更快、更小、更简单,也是个新起的 Java 生态。 启动快 5 ~ 10 倍;qps 高 2~ 3 倍;运行时内存节省 1/3 ~ 1/2;打包可以缩到 1/2 ~ 1/10;同时支持 jdk8, jdk11, jdk17, jdk19。

Solon 项目官网:https://solon.noear.org

2、认识 Solon Cloud Config

Solon Cloud 是一套分布式(或微服务)开发的接口与配置规范。其中 Solon Cloud Config 为云端配置服务,主要提供分布式配置服务的接口并与相关的中间件客户端进行适配:

  • 通过 CloudConfigService 接口与中间件进行适配
  • 使用 CloudClient.config() 获取适配实例,可支持手动操作
  • 一般通过通过配置和 @CloudConfig 注解进行使用

其中 consul-solon-cloud-plugin,是 consul 关于 solon cloud config 的适配。也是本文的主角。

3、项目整合

3.1、在 Consul 管理后台准备两个配置

安装好 consul 后,需要准备下配置数据。consul 没有命名空间或组的概念,但 consul-solon-cloud-plugin 还是支持组的,用“/”隔开。新建个“demo/demoapp.yml” 配置(这个配置,用于导入到应用属性):

demo.user.name: "1"

再准备 “demo/demo-ds” 配置(这个配置,将直接使用):

demo.ds:
  url: ""
  username: ""
  password: ""

3.2、创建项目,完成配置

借助 Solon Initializr( https://solon.noear.org/start/ ) 生成一个 maven + java 的模板项目(这样方便些)。用开发工具打开项目(用 IDEA 不错,他们公司还为开源作者提供免费工具用。是好公司!)。在 pom.xml 里面添加依赖:

<dependencies>
    <dependency>
        <groupId>org.noear</groupId>
        <artifactId>consul-solon-cloud-plugin</artifactId>
    </dependency>
</dependencies>

然后,在应用属性配置文件“app.yml”,添加 consul 的连接信息:

solon.app:
  name: "demoapp"
  group: "demo"

solon.cloud.consul:
  server: "127.0.0.1"           #consul 服务地址
  config:
    load: "demoapp.yml"         #加载配置到应用属性(多个以","隔开)

“...config.load” 会导入配置到应用属性。之后可用“@Inject”注入,也可用“Solon.cfg().get(...)”获取。

3.3、代码应用

模板项目里,在 “App.java” 边上,添加 "Config.java" 类:

@Configuration
public class Config {
    //注入用户名 //来自 config.load 导入到应用属性的
    @Inject("${demo.user.name}") 
    String userName;
    
    //注入并转为数据源 //直接来自 "demo/demo-ds"
    @Bean
    public DataSource ds(@CloudConfig("demo-ds") HikariDataSource ds){
        return ds;
    }
}

直接获取 consul 配置,可以通过"@CloudConfig"注解,或者 "CloudClient.config().pull(group, name)" 手动获取。

4、多马甲项目的应用

很多情况下,公司会有相同的代码,但是不同的运营项目。这个场景下,自然是希望代码都不用改。可以通过 "solon.app.group" 配置进行切换,不支持命名空间,只能借用虚拟的组了。

4.1、添加新的配置

在 consul 里,添加 “demo2/demoapp.yml” 和 "demo2/demo-ds"。然后把刚才的配置复制一份。

4.2、修改项目应用配置

  • 通过 app.yml 修改配置
solon.app:
  name: "demoapp"
  group: "demo2"

solon.cloud.consul:
  server: "127.0.0.1"           #consul 服务地址
  config:
    load: "demoapp.yml"         #加载配置到应用属性(多个以","隔开)
  • 通过启动时指定(方式二)
java -Dsolon.app.group=demo2 -jar demoapp.jar 
  • 通过容器镜像的环境变量指定 (方式三)
services:
  demoapp:
    image: demo/demoapp:1.0.0
    container_name: demoapp
    environment:
      - solon.app.group=demo2
      - TZ=Asia/Shanghai
    ports:
      - 8080:8080

方式二、方式三。什么都不用改,只需要在部署运行时指定一下,推荐!

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部