bookkeeper visual manager

BKVM - Apache BookKeeper 的視覺化管理器

Bookkeeper Visual Manager 是 Apache Bookkeeper 的開源視覺化介面。

特徵：

• 連接到 BookKeeper 叢集 (4.7+)
• 發現博彩公司和博彩公司狀態
• 使用分類帳元資料搜尋分類帳
• 檢查帳本元數據

用例：

• 檢查您的 BookKeeper 集群
• 檢查 Bookies 的健康狀況
• 查看哪些應用程式正在使用更多資源
• 驗證每個應用程式的配置（檢查複製）
• 請參閱叢集範圍配置

路線圖：

• 支援多用戶存取、多租戶和多集群
• 管理博彩公司
• 管理複製
• 驗證叢集的一致性
• 新增進階查詢功能
• 新增API

概述

登入

使用預設帳戶（ admin ）和預設密碼（ admin ）登入。

博彩公司狀態

Bookies 可用性（AVAILABLE、DOWN、READONLY）和磁碟使用情況。

帳本監控

搜尋特定分類帳和分類帳元資料。監控帳本磁碟使用量和複製因子。

博彩公司配置

快速入門

要求

為了執行 BookKeeper Visual Manager，您只需要 Unix 機器和 Java 8 執行時間。

為了開發 BookKeeper Visual Manager，您需要 Maven 3.6.x 和 Yarn。

使用提供的發布包

從 github 發佈頁面下載發布包。解壓縮包

透過編輯conf/server.properties來配置服務預設情況下，我們將連接到本機上的ZooKeeper，就像您獨立使用BookKeeper一樣。

啟動服務

 bin/service server start

開啟瀏覽器 http://localhost:4500

使用者名稱和密碼為：admin/admin

碼頭工人

您可以透過執行以下命令來建立 docker 映像：

 mvn clean install -DskipTests
./docker/build.sh

然後你可以運行容器，服務將在 0.0.0.0:4500 上監聽：

 docker run --rm -p 4500:4500 -e BKVM_metadataServiceUri='zk+null://<my-zookeeper>:2181/ledgers' bkvm/bkvm:latest

請注意，使用此配置資料庫將保留在本機。

如果您想依賴 BookKeeper 來取得所有 BKVM​​ 資料（叢集配置、bookies 元資料），您可以使用 JDBC url 選項執行 docker：

 docker run --rm -p 4500:4500 -e BKVM_metadataServiceUri='zk+null://bk:2181/ledgers' 
   -e BKVM_jdbc_url='jdbc:herddb:zookeeper:<my-zookeeper>:2181/herddb?server.mode=diskless-cluster' bkvm/bkvm:latest

由於 HerdDb diskless-cluster模式，BKVM 容器是無狀態的。

使用 Helm 在 Kubernetes 上部署 BKVM

您可以使用範例 Helm Chart 在 k8s 上引導 BKVM​​。

使用 Maven Jetty 插件部署 war 應用程式

 git clone https://github.com/diennea/bookkeeper-visual-manager.git
cd bookkeeper-visual-manager
mvn clean install -DskipTests

若要傳遞元資料服務 URI 連線字串，您必須設定係統屬性bookkeeper.visual.manager.metadataServiceUri或執行 bin 資料夾中提供的腳本。

 BVM_PORT=8080
BVM_SERVICEURI=zk+null://localhost:2181/ledgers

./bin/run_dev.sh $BVM_SERVICEURI $BVM_PORT

在容器上部署 war 應用程式

您也可以在容器上部署target/bookkeeper-visual-manager-XX.XX.war並傳遞系統屬性中的bookkeeper.visual.manager.metadataServiceUri位置。

使用 Maven Jetty Runner 部署 war 應用程式

下載 Maven Central 上提供的 jetty-runner jar。

 BVM_PORT=8080
BVM_WAR_PATH=path/to/warfile

# Environment Variable configuration
BVM_CONF_PATH=/path/to/conf java -jar jetty-runner.jar $BVM_WAR_PATH --port $BVM_PORT

進階配置

為了使用更高級的配置，您需要向應用程式提供鍵/值屬性檔案。 conf/ 資料夾中提供了一個範例檔案。提供的檔案也可以是您的 Bookkeeper 伺服器設定。

財產	價值
元數據服務Uri	Bookkeeper 伺服器的位置。
zk連線逾時	首次連線逾時。
zk逾時	Zookeeper 會話逾時。

您可以透過三種方式將此文件提供給應用程式：

1. 系統屬性：bookkeeper.visual.manager.config.path

    BVM_PORT=8080
   BVM_CONF_PATH=path/to/warfile
   
   mvn jetty:run 
       -Dbookkeeper.visual.manager.config.path=$BVM_CONF_PATH 
       -Djetty.http.port=$BVM_PORT
   

2. 環境變數：BVM_CONF_PATH

    BVM_PORT=8080
   BVM_WAR_PATH=path/to/warfile
   
   BVM_CONF_PATH=path/to/conf java -jar jetty-runner.jar $BVM_WAR_PATH --port $BVM_PORT
   

3. 部署描述符：web.xml 中的 bookkeeper.visual.manager.config.path

    <context-param>
       <param-name>bookkeeper.visual.manager.config.path</param-name>
       <param-value>path/to/file</param-value>
   </context-param>
   

前端開發

0. 克隆這個倉庫
1. 確保您已經安裝了node (v11.8.0) 和yarn (1.19.1)。
2. 進入前端資料夾src/main/bvmui
3. 安裝依賴項（使用yarn install指令）
4. 自動重新載入（使用yarn serve指令）

    cd src/main/bvmui
   yarn install
   yarn serve
   

5. 建置（使用yarn build指令）

參與其中

請隨意創建問題並拉取請求，以便與社區互動。

如果您正在嘗試這個項目，請告訴我們，我們將很高興聽到您的用戶案例並為您提供幫助。

釋放命令

 git checkout master
mvn release:prepare
mvn release:perform

發布圖表

1. 更新kubernetes/bkvm/Chart.yaml中的圖表版本。

 version=0.0.2
git commit -am "Release chart $version"
git tag bkvm-$version
git push
git push --tags

執照

Bookkeeper Visual Manager 受 Apache 2 授權。