bookkeeper visual manager

BKVM - Manajer Visual untuk Pembukuan Apache

Bookkeeper Visual Manager adalah antarmuka visual sumber terbuka untuk Apache Bookkeeper.

Fitur:

• Terhubung ke cluster BookKeeper (4.7+)
• Temukan bandar judi dan status bandar
• Cari buku besar, menggunakan metadata buku besar
• Periksa metadata buku besar

Kasus penggunaan:

• Periksa cluster BookKeeper Anda
• Periksa kesehatan Bandar Judi
• Lihat aplikasi mana yang menggunakan lebih banyak sumber daya
• Validasi konfigurasi setiap aplikasi (periksa replikasi)
• Lihat Konfigurasi clusterwide

Peta jalan:

• Mendukung akses multi pengguna, multitenancy, dan banyak cluster
• Kelola Bandar Judi
• Kelola replikasi
• Verifikasi konsistensi cluster
• Tambahkan fungsi kueri tingkat lanjut
• Tambahkan API

Ringkasan

Masuk

Gunakan akun default ( admin ) dan kata sandi default ( admin ) untuk login.

Status bandar judi

Ketersediaan bandar (TERSEDIA, TURUN, READONLY) dan penggunaan disk.

Pemantauan buku besar

Telusuri buku besar dan metadata buku besar tertentu. Pantau penggunaan disk buku besar dan faktor replikasi.

Konfigurasi bandar judi

Mulai cepat

Persyaratan

Untuk menjalankan BookKeeper Visual Manager Anda hanya memerlukan Mesin Unix dan runtime Java 8.

Untuk mengembangkan BookKeeper Visual Manager Anda memerlukan Maven 3.6.x dan Yarn.

Menggunakan paket rilis yang disediakan

Unduh paket rilis dari halaman rilis github. Buka zip paketnya

Konfigurasikan layanan dengan mengedit conf/server.properties Secara default kita akan terhubung ke ZooKeeper di localhost, seperti saat Anda menggunakan BookKeeper mandiri.

Mulai layanan

 bin/service server start

Buka browser Anda di http://localhost:4500

Nama pengguna dan kata sandi adalah: admin/admin

Buruh pelabuhan

Anda dapat membuat image buruh pelabuhan dengan menjalankan:

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

Kemudian Anda dapat menjalankan container dan layanan akan mendengarkan pada 0.0.0.0:4500:

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

Harap dicatat bahwa dengan menggunakan konfigurasi ini, database akan disimpan secara lokal.

Jika Anda ingin mengandalkan BookKeeper untuk semua data BKVM ​​(konfigurasi klaster, metadata bandar judi), Anda dapat menjalankan buruh pelabuhan dengan opsi url JDBC:

 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

Berkat mode diskless-cluster HerdDb, container BKVM ​​tidak memiliki kewarganegaraan.

Terapkan BKVM ​​di Kubernetes menggunakan Helm

Anda dapat menggunakan contoh Helm Chart untuk mem-bootstrap BKVM ​​di k8s.

Deploy aplikasi perang menggunakan Plugin Maven Jetty

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

Untuk meneruskan string koneksi URI Layanan Metadata, Anda harus mengatur properti sistem bookkeeper.visual.manager.metadataServiceUri atau menjalankan skrip yang disediakan di folder bin.

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

./bin/run_dev.sh $BVM_SERVICEURI $BVM_PORT

Menyebarkan aplikasi perang pada kontainer

Anda juga dapat menyebarkan target/bookkeeper-visual-manager-XX.XX.war pada kontainer Anda dengan melewati lokasi bookkeeper.visual.manager.metadataServiceUri di properti sistem.

Deploy aplikasi perang menggunakan Maven Jetty Runner

Unduh toples jetty-runner yang tersedia di Maven Central.

 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

Konfigurasi lanjutan

Untuk menggunakan konfigurasi lebih lanjut, Anda perlu menyediakan file properti kunci/nilai ke aplikasi. Contoh file disediakan di folder conf/. File yang disediakan juga dapat menjadi konfigurasi Server Pembukuan Anda.

Milik	Nilai
metadataServiceUri	Lokasi Server Pembukuan.
zkConnectionTimeout	Batas waktu koneksi pertama habis.
zkWaktu habis	Batas waktu sesi penjaga kebun binatang.

Anda dapat memberikan file ini ke aplikasi dengan tiga cara:

1. Properti Sistem : 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. Variabel Lingkungan : 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. Deskriptor Penerapan : bookkeeper.visual.manager.config.path di web.xml

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

Pengembangan front-end

0. Kloning repo ini
1. Pastikan Anda telah menginstal node (v11.8.0) dan benang (1.19.1).
2. Masuk ke folder frontend src/main/bvmui
3. Instal dependensi (gunakan perintah yarn install )
4. Muat ulang otomatis (gunakan perintah yarn serve )

    cd src/main/bvmui
   yarn install
   yarn serve
   

5. Bangun (gunakan perintah yarn build )

Terlibat

Jangan ragu untuk membuat masalah dan menarik permintaan untuk berinteraksi dengan komunitas.

Harap beri tahu kami jika Anda mencoba proyek ini, kami akan dengan senang hati mendengar tentang kasus pengguna Anda dan membantu Anda.

Lepaskan perintah

 git checkout master
mvn release:prepare
mvn release:perform

Lepaskan grafiknya

1. Perbarui versi bagan di kubernetes/bkvm/Chart.yaml .

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

Lisensi

Manajer Visual Pembukuan berada di bawah lisensi Apache 2.