Multicluster support in antctl

[luolanzone]

Describe what you are trying to solve

Since multi-cluster feature is under development, we need to add more commands to antctl to support multi-cluster feature to provide a better experience for MC ClusterSet initialization.

Describe the solution you have in mind

Add a sub-command mc to antctl so user can run antctl mc to trigger multi-cluster related commands.

Describe how your solution impacts user flows

User can use antctl to set up multi-cluster environment with better use experience.

Describe the main design/architecture of your solution

antctl mc should at least support below features.

• initialize a leader cluster eg antctl mc deploy-leader
• join a member cluster to an existing ClusterSet eg:antctl mc deploy-member
• off-boarding a member cluster eg: antctl mc depart-member
• show member and leader cluster information in a ClusterSet eg: antctl mc show clusterset
• list exported MC resources antctl mc show resources

Alternative solutions that you considered

Test plan

Additional context

This is a part of issue #2770

[luolanzone]

cc @hjiajing

[bangqipropel]

question on this:
show seems like an important command in mc command, will we consider show as a keyword here? it seems like it means list for resources, but seems like get or describe for clusterset?

[luolanzone]

There is a conclusion in a MC discussion meeting that we will support troubleshooting related feature in antctl for mc only, antrea operator will be the better place to do deployment/bootstrap related.

[luolanzone]

There a a few basic commands for antctl troubleshooting in MC after a discussion.

1. antctl get clustersets [-n|--namespace ] [--kubeconfig]
   antctl can list all managed ClusterSets.
2. antctl get clusterset $clusterset-name[-n|--namespace ] [--kubeconfig]
   antctl can show a ClusterSet details including the number of member/leader clusters, the ids of each cluster in the ClusterSet, and also the overall status
3. antctl get serviceexports [--clusterid] [--kubeconfig] [--configs-path]
   antctl can get all exported Services by all member clusters in one line, and can also filter them by given member clusterid
   a similar output is like below:

Name      Namespace       ClusterID
service-a   default      member-cluster-a
service-b   demo         member-cluster-a
service-a   default      member-cluster-b

4. antctl get serviceimports [--clusterid] [--kubeconfig] [--configs-path]
   antctl can get all imported Services by all member clusters in one line, and can also filter them by given member clusterid
   a similar output is like below:

Name                  Namespace       ClusterID
antrea-mc-service-a   default         member-cluster-a
antrea-mc-service-a   default         member-cluster-b
antrea-mc-service-b   demo            member-cluster-b

5. antctl get resourceexport [--kubeconfig] [--clusterid]
   antctl can list all ResourceExports in a leader cluster and can also filter ResourcExport with given member clusterid
6. print all mc antctl commands via one CLI.

[luolanzone]

@aravindakidambi Could you help to take a look as well? welcome any suggestion. thanks

[github-actions]

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment, or this will be closed in 90 days

[github-actions]

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment, or this will be closed in 90 days

[luolanzone]

This is mainly done by #3287 and #3474, close this issue.