bookkeeper visual manager

BKVM - Gerenciador Visual para Apache BookKeeper

Bookkeeper Visual Manager é uma interface visual de código aberto para Apache Bookkeeper.

Características:

• Conecte-se a um cluster BookKeeper (4.7+)
• Descubra casas de apostas e status de casas de apostas
• Pesquisar livros contábeis, usando metadados contábeis
• Inspecionar metadados do razão

Casos de uso:

• Inspecione seu cluster BookKeeper
• Verifique a saúde dos corretores
• Veja quais aplicativos estão usando mais recursos
• Validar configuração de cada aplicação (verificar replicação)
• Consulte Configuração em todo o cluster

Roteiro:

• Suporta acesso multiusuário, multilocação e vários clusters
• Gerenciar casas de apostas
• Gerenciar replicação
• Verifique a consistência do cluster
• Adicione funções de consulta avançadas
• Adicionar API

Visão geral

Conecte-se

Use a conta padrão ( admin ) e a senha padrão ( admin ) para fazer login.

Status dos corretores

Disponibilidade dos corretores (AVAILABLE, DOWN, READONLY) e uso do disco.

Monitoramento de livros contábeis

Pesquise livros-razão e metadados de livros-razão específicos. Monitore o uso do disco contábil e o fator de replicação.

Configuração de corretores

Início rápido

Requisitos

Para executar o BookKeeper Visual Manager você só precisa de uma máquina Unix e Java 8 runtime.

Para desenvolver o BookKeeper Visual Manager você precisa do Maven 3.6.x e do Yarn.

Usando os pacotes de lançamento fornecidos

Baixe um pacote de lançamento na página de lançamentos do github. Descompacte o pacote

Configure o serviço editando conf/server.properties Por padrão, nos conectaremos ao ZooKeeper em localhost, como quando você está usando o BookKeeper autônomo.

Inicie o serviço

 bin/service server start

Abra seu navegador em http://localhost:4500

O nome de usuário e as senhas são: admin/admin

Docker

Você pode construir a imagem do Docker executando:

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

Então você pode executar o contêiner e o serviço estará escutando em 0.0.0.0:4500:

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

Observe que usando esta configuração o banco de dados será persistido localmente.

Se você quiser confiar no BookKeeper para todos os dados BKVM ​​(configuração de cluster, metadados de bookies), você pode executar a janela de encaixe com a opção de 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

Graças ao modo diskless-cluster HerdDb, o contêiner BKVM ​​não tem estado.

Implante BKVM ​​no Kubernetes usando Helm

Você pode usar o exemplo do Helm Chart para inicializar o BKVM ​​no k8s.

Implante o aplicativo de guerra usando o plug-in Maven Jetty

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

Para passar a string de conexão do URI do serviço de metadados, você deve definir a propriedade do sistema bookkeeper.visual.manager.metadataServiceUri ou executar o script fornecido na pasta bin.

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

./bin/run_dev.sh $BVM_SERVICEURI $BVM_PORT

Implante o aplicativo de guerra no contêiner

Você também pode implantar o target/bookkeeper-visual-manager-XX.XX.war em seu contêiner, passando o local bookkeeper.visual.manager.metadataServiceUri em uma propriedade do sistema.

Implante o aplicativo de guerra usando Maven Jetty Runner

Baixe o jar jetty-runner disponível no 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

Configuração avançada

Para usar uma configuração mais avançada você precisa fornecer ao aplicativo um arquivo de propriedades chave/valor. Um arquivo de exemplo é fornecido na pasta conf/. O arquivo fornecido também pode ser a configuração do seu Bookkeeper Server.

Propriedade	Valor
metadataServiceUri	Localização do Servidor do Escriturador.
zkConnectionTimeout	Tempo limite da primeira conexão.
zkTimeout	Tempo limite da sessão do Zookeeper.

Você pode fornecer esse arquivo ao aplicativo de três maneiras:

1. Propriedade do sistema : 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. Variável de ambiente : 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. Descritor de implantação : bookkeeper.visual.manager.config.path no web.xml

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

Desenvolvimento do front-end

0. Clonar este repositório
1. Certifique-se de ter instalado o nó (v11.8.0) e o fio (1.19.1).
2. Vá para a pasta frontend src/main/bvmui
3. Instale dependências (use o comando yarn install )
4. Recarga automática (use o comando yarn serve )

    cd src/main/bvmui
   yarn install
   yarn serve
   

5. Construir (use o comando yarn build )

Envolvendo-se

Sinta-se à vontade para criar problemas e solicitar solicitações para interagir com a comunidade.

Informe-nos se você estiver testando este projeto. Teremos o maior prazer em ouvir sobre seu caso de usuário e ajudá-lo.

Liberar comandos

 git checkout master
mvn release:prepare
mvn release:perform

Liberar o gráfico

1. Atualize a versão do gráfico em kubernetes/bkvm/Chart.yaml .

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

Licença

O Bookkeeper Visual Manager está sob licença Apache 2.