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
- FaaS 調整：
- 安全名單，增加 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("我被調度了");
}
}