Water（水孕育萬物...）

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

功能約等於：consul + rabbitmq + elk + prometheus + openFaas + quartz 等一些別的功能，並有機結合在一起。

本次更新

• 服務 watersev，子級服務增加各自的註冊。從而形成子級服務的叢集
  • 服務 watersev-pln，可自由叢集，並讓每個任務分佈到叢集中執行
  • 服務 watersev-mot，可自由叢集，並讓每個任務分佈到叢集中執行
  • 服務 watersev-msgexg，可自由叢集，並分解borker到不同節點上
  • 服務 watersev-msgdis，可自由叢集，並分解borker到不同節點上
  • 服務 watersev-sevchk，取消啟動時需要 reset 的邏輯
• 服務 wateradmin
  • 增加服務規模、訊息主題規模設定，從而自動調整控制檯佈局
• 服務 waterapi
  • 映象埠改為：9371
  • 優化日誌記錄格式，強調輸出輸出概念和上下文隨帶
• 服務 waterraas
  • 埠改為：9375 （之前為：9376）
• 服務 waterpaas
  • 更名為：waterfaas
• 調整 PaaS 概念，將同時包含：FaaS + RaaS
  • FaaS 調整：
    • 資料表 paas_file 更名：luffy_file。強調FaaS自身的代號
    • 資料表 paas_etl 更名：luffy_etl
    • 管理後臺 /paas/ 開頭的路徑，改為 /luffy/開頭
    • 配置 paas_uri 更名為：faas_uri
• 安全名單，增加 token 的模式支援

快速入門

瞭解開發框架與映象

| --- | --- |
| 開發框架 | |
| org.noear:water.client | 框架：Water 客戶端 |
| org.noear:water-solon-plugin | 框架：Water 客戶端 for solon（也可用於 Spring Boot 專案） |
| 映象 | |
| noearorg/waterapi | 映象：Water 主介面服務 |
| noearorg/watersev | 映象：Water 後臺服務（健康檢測；資料監視；訊息派發；定時任務等...） |
| noearorg/wateradmin | 映象：Water 管理控制檯（支援LDAP登入） |
| noearorg/waterfaas | 映象：Water 即時介面服務，提供輕量級FaaS介面服務 |
| noearorg/waterraas | 映象：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: "wateradmin"
  group: "water"

solon.cloud.water:
  server: "waterapi:9371"           #WATER服務地址
  config:
    load: "test.properties"         #預設載入的配置
  log:
    default: "water_log_admin"      #預設日誌記錄器

(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);
            }
        });
    }
}

@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 handler(Event event) throws Exception {
        //處理訊息...
        log.info("我收到訊息：" + event.content());
        return true;
    }
}


//配置訂閱：關注配置的實時更新
@CloudConfig("demoDb")
public class TestConfigHandler implements CloudConfigHandler {
    @Override
    public void handler(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("我被排程了");
    }
}