Release 0.1.0-candidate-3
-----BEGIN PGP SIGNATURE-----

iQFJBAABCAAzFiEEfLgyKwIZSFWNsgIYV3wHyoZ66RAFAl3Kba0VHGd1YW5nbmlu
Z0BhcGFjaGUub3JnAAoJEFd8B8qGeukQYZAIAKybMGtsysOfj/tOiAlFIoKxRvz4
jr8px5hZJeO2y4du9qHlPqFe8G8Aq7rpUs7A3lB2LX17JB7tpm+YEJY00tlCIB9P
pR0T/jn5Cj6In7CJEXHiNROn6jiv+dRmI816sJqFC4t+oOJ8x6cuSWhRLCThx2Am
CIPsMETV5buSKzC2MgFgI5B9ZJm3evA+2BB05JfXYhFCoHMx4YX4yLfXRWlsjDfW
2eWCRPfqH4lSjA8oa6Smuyk+hiIHCPIPOWi+q3CuK/uP5xxv9jUsmLRxWf62zoz8
kB30i7WfSp8RIZxlKTzASsB/qfgWUeEpJQLXuM3EYOBWru4a+Qi14rxDsnU=
=/+Pc
-----END PGP SIGNATURE-----
Merge branch 'master' into branch-0.1.0
tree: c655c3ecce979886257c4819d83a47b56796f130
  1. .gitignore
  2. CONTRIBUTING.md
  3. Jenkinsfile
  4. LICENSE
  5. README.md
  6. VERSION
  7. build.gradle
  8. distribution/
  9. docker/
  10. docs/
  11. front-end/
  12. gradle.properties
  13. gradle/
  14. gradlew
  15. gradlew.bat
  16. src/
README.md

Apache Pulsar manager

FOSSA Status

Apache Pulsar manager is a web-based GUI management tool for managing and monitoring Pulsar.

Feature

  • Tenants Management
  • Namespaces Management
  • Topics Management
  • Subscriptions Management
  • Brokers Management
  • Clusters Management
  • Dynamic environments with multiple changes
  • Support JWT Auth

Feature preview

Log in

Use the default account (pulsar) and the default password (pulsar) to log in.

pulsar-manager-login

Configure environment

The puslar-manager supports multiple environment configurations and can manage multiple environments conveniently.

pulsar-manager-environments

Manage tenants

pulsar-manager-tenants

Manage namespaces

pulsar-manager-namespaces

Manage topics

pulsar-manager-topics

Manage subscriptions

pulsar-manager-subscriptions

Manage clusters

pulsar-manager-clusters

Manage brokers

pulsar-manager-brokers

Topics monitoring

The pulsar-manager can monitor topics and subscriptions.

pulsar-manager-topics-monitors

Manage token

pulsar-manager-token

Prerequisites

  • Java 8 or later
  • Node 10.15.3 or later
  • Npm 6.4.1 or later
  • Pulsar 2.4.0 or later
  • Docker

Preparation

  1. Start Pulsar standalone.

    docker pull apachepulsar/pulsar:2.4.0
    docker run -d -it -p 6650:6650 -p 8080:8080 -v $PWD/data:/pulsar/data --name pulsar-manager-standalone apachepulsar/pulsar:2.4.0 bin/pulsar standalone
    
  2. Build an environment.

    You can build an environment with Docker or build a local environment.

    • Build an environment with Docker

      • REDIRECT_HOST: the IP address of the front-end server.

      • REDIRECT_PORT: the port of the front-end server.

      • DRIVER_CLASS_NAME: the driver class name of MySQL.

      • URL: the url of MySQL jdbc, example: jdbc:mysql://localhost:3306/pulsar_manager?useSSL=false

      • USERNAME: the username of MySQL

      • PASSWORD: the password of MySQL

      docker pull streamnative/pulsar-manager
      docker run -it -p 9527:9527 -e REDIRECT_HOST=front-end-ip -e REDIRECT_PORT=front-end-port -e DRIVER_CLASS_NAME=com.mysql.jdbc.Driver -e URL='jdbc-url' -e USERNAME=root -e PASSWORD=pulsar pulsar-manager /bin/sh
      

      This is an example:

      docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.0.104 -e REDIRECT_PORT=9527 -e DRIVER_CLASS_NAME=org.postgresql.Driver -e URL='jdbc:postgresql://127.0.0.1:5432/pulsar_manager' -e USERNAME=pulsar -e PASSWORD=pulsar -v $PWD:/data pulsar-manager:latest /bin/sh
      
    • Build a local environment

      (1) Download the source code.

      git clone https://github.com/streamnative/pulsar-manager
      

      (2) Build and start the backend.

      cd pulsar-manager
      ./gradlew build -x test
      java -jar ./build/libs/pulsar-manager.jar
      

      (3) Build and start the front end.

      cd pulsar-manager/front-end
      npm install --save
      npm run dev
      
  3. Access Pulsar manager website.

    Use the account and the password to log in to the Pulsar manager website as below.

Default Test database HerdDB

Introduction

Pulsar Manager bundles JDBC Drivers for HerdDB. The default confguration starts and embedded in-memory only HerdDB database.

HerdDB can be used in production, you just have to use the correct JDBC URL. Follow the instructions in application.properties to switch the connection to a standalone HerdDB service or cluster.

The JDBC URL will look like this: jdbc:herddb:server:localhost:7000

In cluster mode HerdDB uses Apache BookKeeper and Apache ZooKeeper to store data and metadata, you can share your ZooKeeper cluster and the Bookies bundled with Pulsar.

The JDBC URL will look like this: jdbc:herddb:zookeeper:localhost:2181/herddb

In order to start and setup an HerdDB database follow the instructions on the HerdDB documentation.

Back end

For more information about the back end, see pulsar-manager-backend.

Front end

For more information about the front end, see pulsar-manager-frontend.

License

FOSSA Status