karmada-io
/
karmada
mirror of https://github.com/karmada-io/karmada.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

gencomponentdocs support module all to generate all karmada components docs 

Signed-off-by: zhzhuang-zju <m17799853869@163.com>
This commit is contained in:
zhzhuang-zju 2025-03-04 17:32:59 +08:00
parent 824bd8d3e0
commit 6654fee4af
1 changed files with 43 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

84
hack/tools/gencomponentdocs/gen_component_docs.go
View File

@ -55,41 +55,13 @@ func main() {
os.Exit(1)
}
var cmd *cobra.Command
switch module {
case names.KarmadaControllerManagerComponentName:
// generate docs for karmada-controller-manager
cmd = cmapp.NewControllerManagerCommand(context.TODO())
case names.KarmadaSchedulerComponentName:
// generate docs for karmada-scheduler
cmd = schapp.NewSchedulerCommand(nil)
case names.KarmadaAgentComponentName:
// generate docs for karmada-agent
cmd = agentapp.NewAgentCommand(context.TODO())
case names.KarmadaAggregatedAPIServerComponentName:
// generate docs for karmada-aggregated-apiserver
cmd = aaapp.NewAggregatedApiserverCommand(context.TODO())
case names.KarmadaDeschedulerComponentName:
// generate docs for karmada-descheduler
cmd = deschapp.NewDeschedulerCommand(nil)
case names.KarmadaSearchComponentName:
// generate docs for karmada-search
cmd = searchapp.NewKarmadaSearchCommand(context.TODO())
case names.KarmadaSchedulerEstimatorComponentName:
// generate docs for karmada-scheduler-estimator
cmd = estiapp.NewSchedulerEstimatorCommand(context.TODO())
case names.KarmadaWebhookComponentName:
// generate docs for karmada-webhook
cmd = webhookapp.NewWebhookCommand(context.TODO())
case names.KarmadaMetricsAdapterComponentName:
// generate docs for karmada-metrics-adapter
cmd = adapterapp.NewMetricsAdapterCommand(context.TODO())
default:
fmt.Fprintf(os.Stderr, "Module %s is not supported", module)
cmds, err := generateCMDs(module)
if err != nil {
fmt.Fprint(os.Stderr, err.Error())
os.Exit(1)
}
for _, cmd := range cmds {
cmd.DisableAutoGenTag = true
err = doc.GenMarkdownTree(cmd, outDir)
if err != nil {
@ -101,4 +73,52 @@ func main() {
fmt.Fprintf(os.Stderr, "failed to cleanup docs: %v\n", err)
os.Exit(1)
}
}
}
func generateCMDs(module string) ([]*cobra.Command, error) {
var cmds []*cobra.Command
switch module {
case names.KarmadaControllerManagerComponentName:
// generate docs for karmada-controller-manager
cmds = append(cmds, cmapp.NewControllerManagerCommand(context.TODO()))
case names.KarmadaSchedulerComponentName:
// generate docs for karmada-scheduler
cmds = append(cmds, schapp.NewSchedulerCommand(nil))
case names.KarmadaAgentComponentName:
// generate docs for karmada-agent
cmds = append(cmds, agentapp.NewAgentCommand(context.TODO()))
case names.KarmadaAggregatedAPIServerComponentName:
// generate docs for karmada-aggregated-apiserver
cmds = append(cmds, aaapp.NewAggregatedApiserverCommand(context.TODO()))
case names.KarmadaDeschedulerComponentName:
// generate docs for karmada-descheduler
cmds = append(cmds, deschapp.NewDeschedulerCommand(nil))
case names.KarmadaSearchComponentName:
// generate docs for karmada-search
cmds = append(cmds, searchapp.NewKarmadaSearchCommand(context.TODO()))
case names.KarmadaSchedulerEstimatorComponentName:
// generate docs for karmada-scheduler-estimator
cmds = append(cmds, estiapp.NewSchedulerEstimatorCommand(context.TODO()))
case names.KarmadaWebhookComponentName:
// generate docs for karmada-webhook
cmds = append(cmds, webhookapp.NewWebhookCommand(context.TODO()))
case names.KarmadaMetricsAdapterComponentName:
// generate docs for karmada-metrics-adapter
cmds = append(cmds, adapterapp.NewMetricsAdapterCommand(context.TODO()))
case "all":
cmds = append(cmds, cmapp.NewControllerManagerCommand(context.TODO()))
cmds = append(cmds, schapp.NewSchedulerCommand(nil))
cmds = append(cmds, agentapp.NewAgentCommand(context.TODO()))
cmds = append(cmds, aaapp.NewAggregatedApiserverCommand(context.TODO()))
cmds = append(cmds, deschapp.NewDeschedulerCommand(nil))
cmds = append(cmds, searchapp.NewKarmadaSearchCommand(context.TODO()))
cmds = append(cmds, estiapp.NewSchedulerEstimatorCommand(context.TODO()))
cmds = append(cmds, webhookapp.NewWebhookCommand(context.TODO()))
cmds = append(cmds, adapterapp.NewMetricsAdapterCommand(context.TODO()))
default:
return nil, fmt.Errorf("Module %s is not supported", module)
}
return cmds, nil
}