[improve][pip] PIP-277: Add current option in the Clusters list cmd

[Technoboy-]

Fixes #20581

Motivation

After configuring the geo-replication on Pulsar clusters, the clusters list API will return multiple clusters, including the local Pulsar cluster and remote clusters like

bin/pulsar-admin clusters list
us-west
us-east
us-cent

But in this return, you can't distinguish the local and the remote cluster. When you need to remove the geo-replication configuration, it will be hard to decide which cluster should be removed on replicated tenants and namespaces unless you record the cluster information.

Modification

Add --current option in the cluster list cmd and mark the current cluster with (*)

bin/pulsar-admin clusters list --current
us-west(*)
us-east
us-cent

Documentation

• doc
• doc-required
• doc-not-needed
• doc-complete

[JooHyukKim]

Add local flag to distinguish clusters

Would you consider adding remote flag also, @Technoboy- ? 🙂 It seems like we are sort of allowing users to assume what the ones without local flag are (are called by the community) 🤔 Plus users will benefit from not having to think about what non-local clusters are called.

Possible use-case would be someone automates counting how many remotes and clusters are there in list via shellscript, or
simple String parser. It will be more convinient to group by local vs remote, rather than local vs ""

[Technoboy-]

Add local flag to distinguish clusters

Would you consider adding remote flag also, @Technoboy- ? 🙂 It seems like we are sort of allowing users to assume what the ones without local flag are (are called by the community) 🤔 Plus users will benefit from not having to think about what non-local clusters are called.

Possible use-case would be someone automates counting how many remotes and clusters are there in list via shellscript, or simple String parser. It will be more convinient to group by local vs remote, rather than local vs ""

yes, sure. Could you also send these ideas in this mail ?

[JooHyukKim]

@Technoboy- For sure, will do.👍🏻 But I am not sure if I have access 🤔.

EDIT : Done 👍🏻

[nodece]

It will be more convinient to group by local vs remote

I think this is a good idea to distinguish between local and remote types.

# list remote clusters
bin/pulsar-admin clusters list --remote
# list local clustes
bin/pulsar-admin clusters list --local
# list all clusters
bin/pulsar-admin clusters list

[JooHyukKim]

+1 on @nodece 's proposal wrt --local and --remote flag 👍🏻

[Technoboy-]

It will be more convinient to group by local vs remote

I think this is a good idea to distinguish between local and remote types.

# list remote clusters
bin/pulsar-admin clusters list --remote
# list local clustes
bin/pulsar-admin clusters list --local
# list all clusters
bin/pulsar-admin clusters list

Good idea, could you also discuss this in this mail ?

[github-actions]

The pr had no activity for 30 days, mark with Stale label.

[RobertIndie]

Why did you move pip-274.md? I see that the same change also appears in https://github.com/apache/pulsar/pull/20993/files.

[Technoboy-]

Why did you move pip-274.md? I see that the same change also appears in https://github.com/apache/pulsar/pull/20993/files.

pip-274.md should rename to pip-276.md. Then in #20993, I have done it. So no need to update in this pr