Huanli-Meng commented on a change in pull request #8085: URL: https://github.com/apache/pulsar/pull/8085#discussion_r490891504
########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -14,38 +14,38 @@ Pulsar Manager is a web-based GUI management and monitoring tool that helps admi The easiest way to use the Pulsar Manager is to run it inside a [Docker](https://www.docker.com/products/docker) container. +```shell +docker pull apachepulsar/pulsar-manager:v0.2.0 +docker run -it \ + -p 9527:9527 -p 7750:7750 \ + -e SPRING_CONFIGURATION_FILE=/pulsar-manager/pulsar-manager/application.properties \ + apachepulsar/pulsar-manager:v0.2.0 ``` -docker pull apachepulsar/pulsar-manager:v0.1.0 -mkdir temp-data -chmod 777 temp-data -cd temp-data -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 -e LOG_LEVEL=DEBUG -v $PWD:/data apachepulsar/pulsar-manager:v0.1.0 /bin/sh -``` - -* 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 PostgreSQL. - -* URL: the URL of PostgreSQL JDBC, For example, `jdbc:postgresql://127.0.0.1:5432/pulsar_manager`. -* USERNAME: the username of PostgreSQL. +* `SPRING_CONFIGURATION_FILE`: Default configuration file for spring. -* PASSWORD: the password of PostgreSQL. +#### Set administrator account and password -* LOG_LEVEL: level of log. + ```shell +CSRF_TOKEN=$(curl http://localhost:7750/pulsar-manager/csrf-token) +curl \ + -H 'X-XSRF-TOKEN: $CSRF_TOKEN' \ + -H 'Cookie: XSRF-TOKEN=$CSRF_TOKEN;' \ + -H "Content-Type: application/json" \ + -X PUT http://localhost:7750/pulsar-manager/users/superuser \ + -d '{"name": "admin", "password": "apachepulsar", "description": "test", "email": "[email protected]"}' +``` -You can find the in the [Docker](https://github.com/apache/pulsar-manager/tree/master/docker) directory and build an image from scratch as well: +You can find the in the [Docker](https://github.com/apache/pulsar-manager/tree/master/docker) directory and build an image from source code as well: Review comment: ```suggestion You can find the in the [Docker](https://github.com/apache/pulsar-manager/tree/master/docker) directory and build an image from the source code as well: ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) Review comment: ```suggestion * Support multiple addresses for the broker stats [#306](https://github.com/apache/pulsar-manager/pull/306). ``` use the period at the end of the sentence. same for the following newly-added contents. ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) +* Add a configuration file for backend service of pulsar manager [#236](https://github.com/apache/pulsar-manager/pull/236) +* Add default configuration for environment [#242](https://github.com/apache/pulsar-manager/pull/242) +* fixed a SQL syntax error [#298](https://github.com/apache/pulsar-manager/pull/298) +* Fix the pulsar-manager can not process the request by pulsar proxy [#281](https://github.com/apache/pulsar-manager/pull/281) Review comment: ```suggestion * Fix the issue that Pulsar Manager fail to process the request sent to the Pulsar proxy [PR-281](https://github.com/apache/pulsar-manager/pull/281). ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -89,8 +89,17 @@ If you want to enable JWT authentication, use one of the following methods. * Method 1: use command-line tool ``` -./build/distributions/pulsar-manager/bin/pulsar-manager --redirect.host=http://localhost --redirect.port=9527 insert.stats.interval=600000 --backend.jwt.token=token --jwt.broker.token.mode=PRIVATE --jwt.broker.private.key=file:///path/broker-private.key --jwt.broker.public.key=file:///path/broker-public.key +wget https://dist.apache.org/repos/dist/release/pulsar/pulsar-manager/apache-pulsar-manager-0.2.0/apache-pulsar-manager-0.2.0-bin.tar.gz +tar -zxvf apache-pulsar-manager-0.2.0-bin.tar.gz +cd pulsar-manager +tar -zxvf pulsar-manager.tar +cd pulsar-manager +cp -r ../dist ui +./bin/pulsar-manager --redirect.host=http://localhost --redirect.port=9527 insert.stats.interval=600000 --backend.jwt.token=token --jwt.broker.token.mode=PRIVATE --jwt.broker.private.key=file:///path/broker-private.key --jwt.broker.public.key=file:///path/broker-public.key ``` +First: [Set administrator account and password](#set-administrator-account-and-password) + +Second: Note: Now you can visit http://localhost:7750/ui/index.html to log in. Review comment: ```suggestion Secondly, log in to Pulsar manager through http://localhost:7750/ui/index.html. ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. Review comment: ```suggestion * `JWT_TOKEN`: the Token of superuser configured for the broker. It is generated by the `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -89,8 +89,17 @@ If you want to enable JWT authentication, use one of the following methods. * Method 1: use command-line tool ``` -./build/distributions/pulsar-manager/bin/pulsar-manager --redirect.host=http://localhost --redirect.port=9527 insert.stats.interval=600000 --backend.jwt.token=token --jwt.broker.token.mode=PRIVATE --jwt.broker.private.key=file:///path/broker-private.key --jwt.broker.public.key=file:///path/broker-public.key +wget https://dist.apache.org/repos/dist/release/pulsar/pulsar-manager/apache-pulsar-manager-0.2.0/apache-pulsar-manager-0.2.0-bin.tar.gz +tar -zxvf apache-pulsar-manager-0.2.0-bin.tar.gz +cd pulsar-manager +tar -zxvf pulsar-manager.tar +cd pulsar-manager +cp -r ../dist ui +./bin/pulsar-manager --redirect.host=http://localhost --redirect.port=9527 insert.stats.interval=600000 --backend.jwt.token=token --jwt.broker.token.mode=PRIVATE --jwt.broker.private.key=file:///path/broker-private.key --jwt.broker.public.key=file:///path/broker-public.key ``` +First: [Set administrator account and password](#set-administrator-account-and-password) Review comment: ```suggestion Firstly, [set the administrator account and password](#set-administrator-account-and-password). ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. Review comment: ```suggestion * `LOG_LEVEL`: the level of log. ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. Review comment: ```suggestion * `URL`: the JDBC URL of your PostgreSQL database, such as jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of the PostgresSQL database. ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) Review comment: ```suggestion * Support docker for JWT [#218](https://github.com/apache/pulsar-manager/pull/218) ``` ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. +* `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 PostgreSQL. Review comment: the PostgreSQL or PostgreSQL database? same comments for the below. ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. + * Method 4: use Docker and turn on **token authentication** and **token management** by private key and public key. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -export PRIVATE_KEY="file:///private-key-path" -export PUBLIC_KEY="file:///public-key-path" -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e PRIVATE_KEY=$PRIVATE_KEY -e PUBLIC_KEY=$PUBLIC_KEY -v $PWD:/data -v $PWD/private-key-path:/pulsar-manager/private-key-path -v $PWD/public-key-path:/pulsar-manager/public-key-path apachepulsar/pulsar-manager /bin/sh -``` +export PRIVATE_KEY="file:///pulsar-manager/secret/my-private.key" +export PUBLIC_KEY="file:///pulsar-manager/secret/my-public.key" +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e PRIVATE_KEY=$PRIVATE_KEY -e PUBLIC_KEY=$PUBLIC_KEY -v $PWD:/data -v $PWD/secret:/pulsar-manager/secret apachepulsar/pulsar-manager:v0.2.0 /bin/sh +``` + +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --private-key` command. +* `PRIVATE_KEY`: Private key path mounted in container, genrated by `bin/pulsar tokens create-key-pair` command. +* `PUBLIC_KEY`: Public key path mounted in container, genrated by `bin/pulsar tokens create-key-pair` command. +* `$PWD/secret`: The folder where the private key and public key generated by the `bin/pulsar tokens create-key-pair` command are placed locally +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. Review comment: update this part based on my previous comments. ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) +* Add a configuration file for backend service of pulsar manager [#236](https://github.com/apache/pulsar-manager/pull/236) +* Add default configuration for environment [#242](https://github.com/apache/pulsar-manager/pull/242) +* fixed a SQL syntax error [#298](https://github.com/apache/pulsar-manager/pull/298) +* Fix the pulsar-manager can not process the request by pulsar proxy [#281](https://github.com/apache/pulsar-manager/pull/281) +* Change default port and replace request uri [#316](https://github.com/apache/pulsar-manager/pull/316) Review comment: ```suggestion * Change the default port and replace the request URI [#316](https://github.com/apache/pulsar-manager/pull/316). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) Review comment: ```suggestion * Use `PulsarAdmin` instead of `HttpUti`l in `BrokerStatsServiceImpl` [PR-315](https://github.com/apache/pulsar-manager/pull/315). ``` please update this part in such a format. ########## File path: site2/docs/administration-pulsar-manager.md ########## @@ -106,42 +115,68 @@ jwt.broker.token.mode=SECRET jwt.broker.secret.key=file:///path/broker-secret.key ``` -* Method 3: use Docker and turn on token authentication. +* Method 3: use Docker and enable token authentication. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager /bin/sh +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -v $PWD:/data apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` or `bin/pulsar tokens create --private-key` command. +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. + * Method 4: use Docker and turn on **token authentication** and **token management** by private key and public key. ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -export PRIVATE_KEY="file:///private-key-path" -export PUBLIC_KEY="file:///public-key-path" -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e PRIVATE_KEY=$PRIVATE_KEY -e PUBLIC_KEY=$PUBLIC_KEY -v $PWD:/data -v $PWD/private-key-path:/pulsar-manager/private-key-path -v $PWD/public-key-path:/pulsar-manager/public-key-path apachepulsar/pulsar-manager /bin/sh -``` +export PRIVATE_KEY="file:///pulsar-manager/secret/my-private.key" +export PUBLIC_KEY="file:///pulsar-manager/secret/my-public.key" +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e PRIVATE_KEY=$PRIVATE_KEY -e PUBLIC_KEY=$PUBLIC_KEY -v $PWD:/data -v $PWD/secret:/pulsar-manager/secret apachepulsar/pulsar-manager:v0.2.0 /bin/sh +``` + +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --private-key` command. +* `PRIVATE_KEY`: Private key path mounted in container, genrated by `bin/pulsar tokens create-key-pair` command. +* `PUBLIC_KEY`: Public key path mounted in container, genrated by `bin/pulsar tokens create-key-pair` command. +* `$PWD/secret`: The folder where the private key and public key generated by the `bin/pulsar tokens create-key-pair` command are placed locally +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. * Method 5: use Docker and turn on **token authentication** and **token management** by secret key. + ``` -docker pull apachepulsar/pulsar-manager export JWT_TOKEN="your-token" -export SECRET_KEY="file:///secret-key-path" -mkdir temp-data -chmod 777 temp-data -cd temp-data -docker run -it -p 9527:9527 -e REDIRECT_HOST=http://192.168.55.182 -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e SECRET_KEY=$SECRET_KEY -v $PWD:/data -v $PWD/secret-key-path:/pulsar-manager/secret-key-path apachepulsar/pulsar-manager /bin/sh +export SECRET_KEY="file:///pulsar-manager/secret/my-secret.key" +docker run -it -p 9527:9527 -p 7750:7750 -e REDIRECT_HOST=http://localhost -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 -e LOG_LEVEL=DEBUG -e JWT_TOKEN=$JWT_TOKEN -e SECRET_KEY=$SECRET_KEY -v $PWD:/data -v $PWD/secret:/pulsar-manager/secret apachepulsar/pulsar-manager:v0.2.0 /bin/sh ``` -* For more information about backend configurations, see [here](https://github.com/apache/pulsar-manager/blob/8b1f26f7d7c725e6d056c41b98235fbc5deb9f49/src/README.md). -* For more information about frontend configurations, see [here](https://github.com/apache/pulsar-manager/blob/master/front-end/README.md). +* `JWT_TOKEN`: Token of superuser configured for broker, generated by `bin/pulsar tokens create --secret-key` command. +* `SECRET_KEY`: Secret key path mounted in container, genrated by `bin/pulsar tokens create-secret-key` command. +* `$PWD/secret`: The folder where the secret key generated by the `bin/pulsar tokens create-secret-key` command are placed locally +* `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 PostgreSQL. +* `URL`: the jdbc url of your PostgreSQL database, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager. The docker image automatically start a local instance of PostgresSQL database. +* `USERNAME`: the username of PostgreSQL. +* `PASSWORD`: the password of PostgreSQL. +* `LOG_LEVEL`: level of log. + +* For more information about backend configurations, see [here](https://github.com/apache/pulsar-manager/blob/master/src/README.md). +* For more information about frontend configurations, see [here](https://github.com/apache/pulsar-manager/tree/master/front-end). ## Log in +First: [Set administrator account and password](#set-administrator-account-and-password) Review comment: ```suggestion [Set the administrator account and password](#set-administrator-account-and-password). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) Review comment: Support forwarding messages through HTTPS? ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) Review comment: ```suggestion * Support sub and unsub operations [PR-240](https://github.com/apache/pulsar-manager/pull/240). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) Review comment: ```suggestion * Support peeking messages from the Pulsar broker [PR-241](https://github.com/apache/pulsar-manager/pull/241). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) Review comment: ```suggestion * Support BookKeeper visual manager 1.2.0 [PR-300](https://github.com/apache/pulsar-manager/pull/300). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) +* Add a configuration file for backend service of pulsar manager [#236](https://github.com/apache/pulsar-manager/pull/236) Review comment: ```suggestion * Add a configuration file for the backend service of Pulsar manager [PR-236](https://github.com/apache/pulsar-manager/pull/236). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) +* Add a configuration file for backend service of pulsar manager [#236](https://github.com/apache/pulsar-manager/pull/236) +* Add default configuration for environment [#242](https://github.com/apache/pulsar-manager/pull/242) +* fixed a SQL syntax error [#298](https://github.com/apache/pulsar-manager/pull/298) Review comment: ```suggestion * Fixe an SQL syntax error [PR-298](https://github.com/apache/pulsar-manager/pull/298). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) Review comment: ```suggestion * Support displaying stats for tenants and namespaces [PR-243](https://github.com/apache/pulsar-manager/pull/243). ``` ########## File path: site2/website/pulsar-manager-release-notes.md ########## @@ -1,5 +1,25 @@ ## Apache Pulsar Manager +### 0.2.0 — 2020-09-28 <a id="0.2.0"></a> + +#### Fixes + +* Support multi address for broker stats [#306](https://github.com/apache/pulsar-manager/pull/306) +* Use PulsarAdmin instead of HttpUtil [#315](https://github.com/apache/pulsar-manager/pull/315) +* Serve frontend directly from Pulsar Manager backend process [#288](https://github.com/apache/pulsar-manager/pull/288) +* Support docker for jwt [#218](https://github.com/apache/pulsar-manager/pull/218) +* Support sub and unsub [#240](https://github.com/apache/pulsar-manager/pull/240) +* Support peek messages from Ppulsar broker [#241](https://github.com/apache/pulsar-manager/pull/241) +* Support BbookKeeper visual manager 1.2.0 [#300](https://github.com/apache/pulsar-manager/pull/300) +* Support https forward [#258](https://github.com/apache/pulsar-manager/pull/258) +* Support display stats for tenant and namespace [#243](https://github.com/apache/pulsar-manager/pull/243) +* Add a configuration file for backend service of pulsar manager [#236](https://github.com/apache/pulsar-manager/pull/236) +* Add default configuration for environment [#242](https://github.com/apache/pulsar-manager/pull/242) Review comment: ```suggestion * Add default configurations for the environment [PR-242](https://github.com/apache/pulsar-manager/pull/242). ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected]
