gen_kube_docs.go 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. /*
  2. Copyright 2014 The Kubernetes Authors.
  3. Licensed under the Apache License, Version 2.0 (the "License");
  4. you may not use this file except in compliance with the License.
  5. You may obtain a copy of the License at
  6. http://www.apache.org/licenses/LICENSE-2.0
  7. Unless required by applicable law or agreed to in writing, software
  8. distributed under the License is distributed on an "AS IS" BASIS,
  9. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  10. See the License for the specific language governing permissions and
  11. limitations under the License.
  12. */
  13. package main
  14. import (
  15. "fmt"
  16. "os"
  17. "github.com/spf13/cobra/doc"
  18. "k8s.io/kubernetes/cmd/genutils"
  19. apiservapp "k8s.io/kubernetes/cmd/kube-apiserver/app"
  20. cmapp "k8s.io/kubernetes/cmd/kube-controller-manager/app"
  21. proxyapp "k8s.io/kubernetes/cmd/kube-proxy/app"
  22. kubeletapp "k8s.io/kubernetes/cmd/kubelet/app"
  23. schapp "k8s.io/kubernetes/plugin/cmd/kube-scheduler/app"
  24. )
  25. func main() {
  26. // use os.Args instead of "flags" because "flags" will mess up the man pages!
  27. path := ""
  28. module := ""
  29. if len(os.Args) == 3 {
  30. path = os.Args[1]
  31. module = os.Args[2]
  32. } else {
  33. fmt.Fprintf(os.Stderr, "usage: %s [output directory] [module] \n", os.Args[0])
  34. os.Exit(1)
  35. }
  36. outDir, err := genutils.OutDir(path)
  37. if err != nil {
  38. fmt.Fprintf(os.Stderr, "failed to get output directory: %v\n", err)
  39. os.Exit(1)
  40. }
  41. switch module {
  42. case "kube-apiserver":
  43. // generate docs for kube-apiserver
  44. apiserver := apiservapp.NewAPIServerCommand()
  45. doc.GenMarkdownTree(apiserver, outDir)
  46. case "kube-controller-manager":
  47. // generate docs for kube-controller-manager
  48. controllermanager := cmapp.NewControllerManagerCommand()
  49. doc.GenMarkdownTree(controllermanager, outDir)
  50. case "kube-proxy":
  51. // generate docs for kube-proxy
  52. proxy := proxyapp.NewProxyCommand()
  53. doc.GenMarkdownTree(proxy, outDir)
  54. case "kube-scheduler":
  55. // generate docs for kube-scheduler
  56. scheduler := schapp.NewSchedulerCommand()
  57. doc.GenMarkdownTree(scheduler, outDir)
  58. case "kubelet":
  59. // generate docs for kubelet
  60. kubelet := kubeletapp.NewKubeletCommand()
  61. doc.GenMarkdownTree(kubelet, outDir)
  62. default:
  63. fmt.Fprintf(os.Stderr, "Module %s is not supported", module)
  64. os.Exit(1)
  65. }
  66. }