Yong - Can you start with an official vote for this? We need an official vote thread for this.
Dave - Yes. We need to go through IP clearance for this contribution. - Sijie On Thu, Jun 18, 2020 at 9:13 PM Dave Fisher <wave4d...@comcast.net> wrote: > Very cool! > > This contribution may need to go through IP clearance. > https://incubator.apache.org/ip-clearance/ > > Regards? > Dave > > Sent from my iPhone > > On Jun 18, 2020, at 8:16 PM, Yong Zhang <zhangyong1025...@gmail.com> > wrote: > > It seems that there are no objections to accepting this repo. > > What should I do in the next step? Should I open a vote in a separate > email? > > Thanks > > --- > On Mon, 15 Jun 2020 at 14:30, Guangning E <eguangn...@gmail.com> wrote: > > Great job, +1, Thanks Yong and Xiaolong. > > > anonymitaet _ <anonymita...@hotmail.com> 于2020年6月15日周一 上午9:56写道： > > > Thanks Yong for this great job, +1 > > > On 2020/6/15, 09:34, "PengHui Li" <codelipeng...@gmail.com> wrote: > > > +1 > > On Jun 15, 2020, 9:24 AM +0800, xiaolong ran < > > ranxiaolong...@gmail.com>, > > wrote: > > Thanks Yong Zhang work for this, LGTM+1 > > > -- > > Thanks > > Xiaolong Ran > > > 在 2020年6月12日，上午11:38，Yong Zhang <zhangyong1025...@gmail.com> 写道： > > > Hi all, > > > We have developed a new tool Pulsarctl for managing Pulsar > > resources. It’s > > written in Golang > > and is an alternative tool of pulsar-admin. We’d like to > > contribute the > > project back to the Pulsar > > community. > > > ## Motivation > > > Pulsarctl is an alternative tool of pulsar-admin, used to manage > > resources > > in Apache Pulsar. > > Pulsarctl is written in Go and based on Pulsar REST API. It > > provides Go > > developers with API > > interface and user-friendly commands, making it easier to > > interact > > with > > Pulsar brokers. > > > Compared with pulsar-admin, Pulsarctl is more user-friendly. > > Pulsarctl > > requires fewer dependencies > > to use commands and provides more comprehensive description and > > usage for > > commands. > > With Pulsarctl, users can find and resolve issues faster when > > errors occur. > > > ## Features > > > Pulsarctl not only integrates the Pulsar commands and BookKeeper > > commands > > but also > > provides some useful tools like output format and context > > management. > > > > ### Pulsar operations > > > For Pulsar operations, Pulsarctl integrates almost all the > > commands of > > pulsar-admin, including > > but not limited to the following operations: > > > - broker operations > > - cluster operations > > - tenant operations > > - namespace operations > > - topic operations > > - function operations > > - sink operations > > - source operations > > > Also, Pulsarctl supports the JWT(JSON Web Token) authentication > > and TLS > > authentication. > > > The following are command flags of Pulsarctl. You can use > > `--auth-params` > > to specify the auth > > params configured in pulsar-client. Or you can just specify > > `--token` to > > use that token to connect the broker. > > > ``` > > Common flags: > > -s, --admin-service-url string The admin web service url that > > pulsarctl connects to. (default "http://localhost:8080";) > > --auth-params string Authentication parameters are used to > > configure the public and private key files required by tls > > For example: > > "tlsCertFile:val1,tlsKeyFile:val2" > > -C, --color string toggle colorized logs > > (true,false,fabulous) (default "true") > > -h, --help help for this command > > --tls-allow-insecure Allow TLS insecure connection > > --tls-trust-cert-path string Allow TLS trust cert file path > > --token string Using the token to authentication > > --token-file string Using the token file to authentication > > -v, --verbose int set log level, use 0 to silence, 4 for > > debugging (default 3) > > ``` > > > ### BookKeeper operations > > > For BookKeeper operations, Pulsarctl integrates the commands > > listed in the > > [REST API](https://bookkeeper.apache.org/docs/4.10.0/admin/http/ > > ) > > > - auto-recovery operations > > - bookie operations > > - bookies operations > > - ledger operations > > > > ### Save your configuration in the different contexts > > > Pulsarctl provides a context command which lets you manage your > > Pulsar > > cluster easier. > > The ‘context’ can save the different configurations of your > > Pulsar > > cluster. > > And you can easily > > change to another cluster by the command `pulsarctl context use`. > > For more > > details please > > refer to > > > > > https://github.com/streamnative/pulsarctl/blob/master/docs/en/how-to-use-context.md > > > > ### Get different formats of the output > > > Pulsarctl provides an output flag `--output` to make the output > > transform > > into different > > formats, such as text, JSON, and YAML. The default view is the > > text which > > allows you > > to check the resources in your cluster directly. Also, you can > > get > > the JSON > > or YAML > > format to do what you want to. > > > > ### Extend Pulsarctl using plugins easily > > > You can easily extend the Pulsarctl with a plugin. Pulsarctl will > > auto-find > > the installed > > plugins and you can use them directly in Pulsarctl. For more > > details about > > the plugin, > > please refer to > > > > > https://github.com/streamnative/pulsarctl/blob/master/docs/en/how-to-extend-pulsarctl-with-plugins.md > > > ### Auto-complete your command > > > Pulsarctl supports auto-completing your input command. If you > > forget some > > commands, > > try to `tab` it, Pulsarctl will remind you. For how to enable the > > auto-completion feature, please refer to: > > > > > https://github.com/streamnative/pulsarctl/blob/master/docs/en/enable_completion.md > > > ### A Golang library of Pulsar admin > > > Pulsarctl is not only a command-line tool but also a library of > > Pulsar > > admin API. You can > > use it in your application to communicate with Pulsar. Here is an > > example > > of how to use > > Pulsarctl in your application: > > > > > https://github.com/streamnative/pulsarctl/blob/master/docs/en/overview_of_pulsarctl.md#admin-api > > > ## More information > > > - Pulsarctl project repo: > > https://github.com/streamnative/pulsarctl > > - The latest Pulsarctl API website: > > https://streamnative.io/docs/pulsarctl/v0.4.1/ > > - Introduction to Pulsarctl: > > > https://streamnative.io/blog/tech/2019-11-26-introduction-pulsarctl > > > > > > >
