Water 2.6.3 釋出,一站式服務治理平臺

劉之西東發表於2022-05-06

Water(水孕育萬物...)

Water 為專案開發、服務治理,提供一站式解決方案(可以理解為微服務架構支援套件)。基於 Solon 框架開發,並支援完整的 Solon Cloud 規範;已在生產環境奔跑了4年。

功能相當於:consul + rabbitmq + elk + prometheus + openFaas + quartz + 等等,並有機結合在一起。 或者約等於:nacos + rocketmq + PlumeLog + prometheus + magic-api + xxl-job + 等。

對 k8s 友好,支援 ip 漂移、支援 k8s service 對映。

本次更新

  • [控制檯] 所有匯入功能統一為插入或替換(之前有些插入,有些是替換)
  • [控制檯] 調整部分列表刪除後,跳轉到同狀態列表
  • [控制檯] 修復定時任務監控無資料的問題
  • [控制檯] UI優化
  • HttpUtils 工具類,支援超時設定
  • runJob,超時改為:60*5秒
  • runStatus,超時改為:10秒
  • solon 升級為:1.7.5(專案地址:https://gitee.com/noear/solon
  • redisx 升級為:1.4.3(專案地址:https://gitee.com/noear/redisx
  • snack3 升級為:3.2.22(專案地址:https://gitee.com/noear/snack3

快速入門

瞭解開發框架與映象

元件 說明
開發框架
org.noear:water.client 框架:Water 客戶端
org.noear:water-solon-plugin 框架:Water 客戶端 for solon(也可用於 Spring Boot 專案)
映象
noearorg/waterapi:2.6.2 映象:Water 主介面服務
noearorg/watersev:2.6.2 映象:Water 後臺服務(健康檢測;資料監視;訊息派發;定時任務等...)
noearorg/wateradmin:2.6.2 映象:Water 管理控制檯(支援LDAP登入)
noearorg/waterfaas:2.6.2 映象:Water 即時介面服務,提供輕量級FaaS介面服務
noearorg/xwater:2.6.2 構建:Water 助理工具

控制檯演示站

地址: http://water.noear.org (賬號:demo ;密碼:demo )

關鍵持久化說明:

  • 日誌持久化,支援:MySql、PostgreSQL、MongoDb、ElasticSearch、ClickHouse
  • 訊息持久化,支援:MySql、PostgreSQL、MongoDb

專案地址

程式碼演示

(1) 配置
  • pom.xml / mevan 配置
<!-- 客戶端版本 -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water.client</artifactId>
    <version>${water.ver}</version>
</dependency>

<!-- solon cloud 整合版本 (也可用於 Spring Boot 專案) -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>water-solon-plugin</artifactId>
    <version>${solon.ver}</version>
</dependency>
  • application.yml / 配置說明
solon.app:
  name: "demo-api"
  group: "demo"

solon.cloud.water:
  server: "waterapi:9371"    #WATER服務地址
  config:
    load: "demo.yml"         #預設載入的配置
(2) 程式碼
public class DemoApp {
    public void main(String[] args) {
        SolonApp app = Solon.start(DemoApp.class, args);

        //監控服務:之:新增介面效能記錄(一般這個過濾器寫成獨立類)
        Logger log = LoggerFactory.getLogger(DemoApp.class);
        app.filter((ctx, chain) -> {
            //1.開始計時(用於計算響應時長)
            long start = System.currentTimeMillis();

            try {
                chain.doFilter(ctx);
            } catch (Throwable e) {
                //2.順帶記錄個異常
                log.error("{}",e);
            } finally {
                //3.獲得介面響應時長
                long milliseconds = System.currentTimeMillis() - start;
                CloudClient.metric().addMeter(Solon.cfg().appName(), "path", ctx.pathNew(), milliseconds);
            }
        });
    }
}

@Configuration
public class DemoConfig {

    @Bean
    public DataSource db1(@CloudConfig("demoDb") HikariDataSource ds) {
        //配置一個資料來源
        return ds;
    }
    
    @Bean
    public I18nBundleFactory i18nBundleFactory(){
        //將國際化服務,切換為雲端介面
        return new CloudI18nBundleFactory();
    }
}

@Slf4j
@Controller
public class DemoController{
    @CloudConfig(name = "demoDb", autoRefreshed = true)  //配置服務的功能(註解模式)
    DbContext demoDb;

    @NamiClient            //RPC服務發現的功能(註解模式)
    RockService rockService;
   
    @Mapping("/")
    public void test(){
        //日誌服務:寫個日誌
        log.info("你好,日誌服務"); //(content)
        TagsMDC.tag0("demo");
        log.error("{}\r\n{}","test","你好,日誌服務"); //(tag,summary,content)
        
        //配置服務:使用配置的資料庫上下文進行查詢
        Map map = demoDb.table("water_reg_service").limit(1).selectMap("*");

        //訊息服務:傳送訊息
        CloudClient.event().publish(new Event("demo.test", "{\"order_id\":1}")); //(非註解模式)

        //Rpc發現服務:呼叫Rpc介面
        AppModel app = rockService.getAppById(12);
    }
}

//訊息訂閱:訂閱訊息並處理(根據:topic 進行訂閱)
@Slf4j
@CloudEvent("demo.test")
public class Event_demo_test implements CloudEventHandler {
    @Override
    public boolean handle(Event event) throws Exception {
        //處理訊息...
        log.info("我收到訊息:" + event.content());
        return true;
    }
}


//配置訂閱:關注配置的實時更新
@CloudConfig("demoDb")
public class TestConfigHandler implements CloudConfigHandler {
    @Override
    public void handle(Config config) {

    }
}

//分散式任務
@CloudJob(name = "demo_test", cron7x = "0 1 * * * ?")
public class Job_test implements CloudJobHandler {

    @Override
    public void handle(Context ctx) throws Throwable {
        //處理任務...
        log.info("我被排程了");
    }
}

相關文章