Skip to content

[website]Add content of pulsar-manager in website(include release notes, download link)#5741

Merged
jiazhai merged 7 commits intoapache:masterfrom
AmateurEvents:feature/add-release-notes-download-and-doc
Nov 29, 2019
Merged

[website]Add content of pulsar-manager in website(include release notes, download link)#5741
jiazhai merged 7 commits intoapache:masterfrom
AmateurEvents:feature/add-release-notes-download-and-doc

Conversation

@tuteng
Copy link
Member

@tuteng tuteng commented Nov 25, 2019

Motivation

As a sub-project of the pulsar, pulsar-manager should update relevant content on the website after the first release is completed, so as to facilitate users' use.

Modifications

  • Add pulsar-manager release notes page
  • Add pulsar-manager download page
  • Add a document in sidebar

Verifying this change

yarn build pass

@tuteng tuteng added this to the 2.5.0 milestone Nov 25, 2019
@tuteng tuteng self-assigned this Nov 25, 2019
@Jennifer88huang-zz
Copy link
Contributor

@Anonymitaet Could you please help review this PR? Thank you.

@Anonymitaet
Copy link
Member

@jennifer88huang glad to help

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The easiest way to use the pulsar manager is to run it inside a [Docker](https://www.docker.com/products/docker) container.
The easiest way to use the Pulsar Manager is to run it inside a [Docker](https://www.docker.com/products/docker) container.

Pulsar Manager is a proper noun, please use the correct capitalization and check all occurrences.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* URL: the url of PostgreSQL jdbc, example: jdbc:postgresql://127.0.0.1:5432/pulsar_manager.
* URL: the URL of PostgreSQL JDBC. For example, `jdbc:postgresql://127.0.0.1:5432/pulsar_manager`.

Please capitalize proper nouns correctly.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Find what in the Docker?

Please capitalize "Docker" correctly. I suggest using a grammar tool before submitting a PR.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Initialize database and table structures using [file](https://github.com/apache/pulsar-manager/tree/master/src/main/resources/META-INF/sql/postgresql-schema.sql).
1. Initialize database and table structures using the [file](https://github.com/apache/pulsar-manager/tree/master/src/main/resources/META-INF/sql/postgresql-schema.sql).

Please use a grammar tool to check basic grammar mistakes before submitting a PR.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Modify the [configuration file](https://github.com/apache/pulsar-manager/blob/master/src/main/resources/application.properties) and add PostgreSQL configuration
2. Modify the [configuration file](https://github.com/apache/pulsar-manager/blob/master/src/main/resources/application.properties) and add PostgreSQL configuration.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Compile to generate a new executable jar package
3. Compile to generate a new executable jar package.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Enable JWT Auth
### Enable JWT authentication

We use sentence case rather than title case for heading.

Copy link
Member

@Anonymitaet Anonymitaet Nov 26, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* backend.jwt.token token for the superuser. You need to configure this parameter during cluster initialization.
* `backend.jwt.token`: token for the superuser. You need to configure this parameter during cluster initialization.

Please check all (line 72-75).

image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For more information, see [Apache Pulsar](http://pulsar.apache.org/docs/en/security-token-admin/)
For more information, see [Token Authentication Admin of Pulsar](http://pulsar.apache.org/docs/en/security-token-admin/).

Tell users more and accurate info.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Method 2. Configure the application.properties file
* Method 2: Configure the application.properties file

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does "use Docker only use token" mean?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean "Use Docker with token and secret key"?

Comment on lines 123 to 124
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tip

  • For more information about backend configurations, see here.
  • For more information about frontend configurations, see here.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Login platform
## Log in

Use parallel structure with "Install"

@tuteng
Copy link
Member Author

tuteng commented Nov 26, 2019

@Anonymitaet PTAL

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: The Pulsar Manager
title: Pulsar Manager

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. Do not add an article before a proper noun.

For example, we say "In 2013 Oracle introduced Oracle Database 12c—the world's first database designed for the cloud. " rather than "In 2013 Oracle introduced the Oracle Database 12c—the world...".

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've commented before but it is not changed

image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `jwt.broker.token.mode`: Two modes of generating token, SECRET and PRIVATE.
* `jwt.broker.token.mode`: two modes of generating token, SECRET and PRIVATE.

I've commented on this before as well. Please check lines 72-75.

image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For more information, see [Token Authentication Admin of Pulsar](http://pulsar.apache.org/docs/en/security-token-admin/)
For more information, see [Token Authentication Admin of Pulsar](http://pulsar.apache.org/docs/en/security-token-admin/).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you want to enable JWT authentication, use one of the following methods.

Is this correct?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Method 4: Use Docker, turn on token authentication and turn on token management by private key and public key.
* Method 4: Use Docker and turn on **token authentication** and **token management** by private key and public key.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Method 5: Use Docker, turn on token authentication and turn on token management by secret key.
* Method 5: use Docker and turn on **token authentication** and **token management** by secret key.

Comment on lines 123 to 124
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I commented on this before as well.

image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Log in platform
## Log in

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Visit http://localhost:9527
Visit http://localhost:9527 to log in.

@Anonymitaet
Copy link
Member

You can preview the doc before submitting a PR.

image

@tuteng
Copy link
Member Author

tuteng commented Nov 26, 2019

Thank you for your comments.

@sijie
Copy link
Member

sijie commented Nov 26, 2019

@Anonymitaet can you review it again?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. Do not add an article before a proper noun.

For example, we say "In 2013 Oracle introduced Oracle Database 12c—the world's first database designed for the cloud. " rather than "In 2013 Oracle introduced the Oracle Database 12c—the world...".

Comment on lines 127 to 128
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

need to correct

image

@tuteng
Copy link
Member Author

tuteng commented Nov 27, 2019

@Anonymitaet PTAL, Thanks.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* For more information about backend configurations, see [here](https://github.com/apache/pulsar-manager/blob/8b1f26f7d7c725e6d056c41b98235fbc5deb9f49/src/README.md) about backend.
* For more information about backend configurations, see [here](https://github.com/apache/pulsar-manager/blob/8b1f26f7d7c725e6d056c41b98235fbc5deb9f49/src/README.md).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* For more information about frontend configurations, see [here](https://github.com/apache/pulsar-manager/blob/master/front-end/README.md) about frontend.
* For more information about frontend configurations, see [here](https://github.com/apache/pulsar-manager/blob/master/front-end/README.md).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I didn't notice here. I have already fixed it. @Anonymitaet PTAL

@sijie
Copy link
Member

sijie commented Nov 28, 2019

@Anonymitaet PTAL

@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run java8 tests
run cpp tests

@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run java8 tests

1 similar comment
@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run java8 tests

@tuteng tuteng force-pushed the feature/add-release-notes-download-and-doc branch from 1f0e5d3 to e232a79 Compare November 29, 2019 05:16
@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run integration tests

@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run java8 tests

1 similar comment
@tuteng
Copy link
Member Author

tuteng commented Nov 29, 2019

run java8 tests

@jiazhai jiazhai merged commit e4fc609 into apache:master Nov 29, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

Comments