Bookkeeper Visual Manager est une interface visuelle open source pour Apache Bookkeeper.
Caractéristiques:
Cas d'utilisation :
Feuille de route :
Utilisez le compte par défaut ( admin
) et le mot de passe par défaut ( admin
) pour vous connecter.
Disponibilité des bookmakers (AVAILABLE, DOWN, READONLY) et utilisation du disque.
Recherchez des registres spécifiques et des métadonnées de registres. Surveillez l’utilisation du disque du grand livre et le facteur de réplication.
Pour exécuter BookKeeper Visual Manager, vous avez juste besoin d'une machine Unix et d'un runtime Java 8.
Afin de développer BookKeeper Visual Manager, vous avez besoin de Maven 3.6.x et de Yarn.
Téléchargez un package de version à partir de la page des versions de github. Décompressez le paquet
Configurez le service en éditant conf/server.properties. Par défaut, nous nous connecterons à ZooKeeper sur localhost, comme lorsque vous utilisez BookKeeper autonome.
Démarrer le service
bin/service server start
Ouvrez votre navigateur sur http://localhost:4500
Le nom d'utilisateur et les mots de passe sont : admin/admin
Vous pouvez créer l'image Docker en exécutant :
mvn clean install -DskipTests
./docker/build.sh
Ensuite, vous pouvez exécuter le conteneur et le service écoutera sur 0.0.0.0:4500 :
docker run --rm -p 4500:4500 -e BKVM_metadataServiceUri='zk+null://<my-zookeeper>:2181/ledgers' bkvm/bkvm:latest
Veuillez noter qu'en utilisant cette configuration, la base de données sera conservée localement.
Si vous souhaitez plutôt vous appuyer sur BookKeeper pour toutes les données BKVM (configuration du cluster, métadonnées des bookmakers), vous pouvez exécuter le docker avec l'option 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
Grâce au mode diskless-cluster
HerdDb, le conteneur BKVM est sans état.
Vous pouvez utiliser l'exemple Helm Chart pour amorcer BKVM sur k8.
git clone https://github.com/diennea/bookkeeper-visual-manager.git
cd bookkeeper-visual-manager
mvn clean install -DskipTests
Pour transmettre la chaîne de connexion URI du service de métadonnées, vous devez définir la propriété système bookkeeper.visual.manager.metadataServiceUri
ou exécuter le script fourni dans le dossier bin.
BVM_PORT=8080
BVM_SERVICEURI=zk+null://localhost:2181/ledgers
./bin/run_dev.sh $BVM_SERVICEURI $BVM_PORT
Vous pouvez également déployer le target/bookkeeper-visual-manager-XX.XX.war
sur votre conteneur en passant l'emplacement bookkeeper.visual.manager.metadataServiceUri
dans une propriété système.
Téléchargez le pot jetty-runner disponible sur 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
Afin d'utiliser une configuration plus avancée, vous devez fournir à l'application un fichier de propriétés clé/valeur. Un exemple de fichier est fourni dans le dossier conf/. Le fichier fourni peut également être la configuration de votre Bookkeeper Server.
Propriété | Valeur |
---|---|
métadonnéesServiceUri | Emplacement du serveur comptable. |
zkConnectionTimeout | Expiration du délai de première connexion. |
zkTimeout | Expiration de la session Zookeeper. |
Vous pouvez fournir ce fichier à l'application de trois manières :
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
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
<context-param>
<param-name>bookkeeper.visual.manager.config.path</param-name>
<param-value>path/to/file</param-value>
</context-param>
src/main/bvmui
yarn install
)yarn serve
) cd src/main/bvmui
yarn install
yarn serve
yarn build
) N'hésitez pas à créer des tickets et des pull request afin d'interagir avec la communauté.
N'hésitez pas à nous faire savoir si vous essayez ce projet, nous serons heureux de connaître votre cas d'utilisation et de vous aider.
git checkout master
mvn release:prepare
mvn release:perform
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 est sous licence Apache 2.