build_project.md

Build and Test Project

各模組說明

• app: 處理與web server，成本分析與負載平衡等功能之模組
• common: 有關叢集，客戶端等分析，管理與平衡等功能之模組
• etl: 轉換 csv 檔，再匯入 delta 並使串接部份有更好的平行化處理之模組
• gui: 與圖形化界面功能相關的模組
• connector: 基於 Kafka connector 實作的各式分散式工具
• it: 針對專案測試所提供的叢集環境

以下示範如何建構與測試本專案

建構專案並忽略測試

./gradlew clean build -x test

清理並測試整個專案

./gradlew cleanTest test

各模組測試指令

清理test，並測試 common 模組

可以至 ./app/build/reports/test 查看測試報告

./gradlew cleanTest common:test

清理先建構之資料

./gradlew clean 

直接運行 main class

如果要取得 app 的版本資訊，可以透過以下指令直接執行

./gradlew clean app:run -version

運行 GUI 程式

先建構可執行的 jar 檔案

./gradlew shadowJar

可在 GUI 模組下找到可執行的 jar 檔案 (./gui/build/libs/astraea-gui-[VERSION]-all.jar)

java -jar astraea-gui-[VERSION]-all.jar

• 請將[VERSION]替換為建構完成後所顯示之版本號（例如：java -jar astraea-gui-0.3.0-all.jar）

透過 docker 運行專案測試

運行docker container

docker run --rm -ti \
-v $HOME/project/astraea:/tmp/astraea \
ghcr.io/skiptests/astraea/deps \
/bin/bash

在運行的 container 中移至 /tmp/astraea 後，透過上方方式測試專案