options.go 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338
  1. /*
  2. Copyright 2018 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 options
  14. import (
  15. "fmt"
  16. "net"
  17. "os"
  18. "strconv"
  19. "time"
  20. corev1 "k8s.io/api/core/v1"
  21. metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
  22. "k8s.io/apimachinery/pkg/util/uuid"
  23. apiserveroptions "k8s.io/apiserver/pkg/server/options"
  24. utilfeature "k8s.io/apiserver/pkg/util/feature"
  25. "k8s.io/client-go/informers"
  26. clientset "k8s.io/client-go/kubernetes"
  27. "k8s.io/client-go/kubernetes/scheme"
  28. v1core "k8s.io/client-go/kubernetes/typed/core/v1"
  29. restclient "k8s.io/client-go/rest"
  30. "k8s.io/client-go/tools/clientcmd"
  31. clientcmdapi "k8s.io/client-go/tools/clientcmd/api"
  32. "k8s.io/client-go/tools/leaderelection"
  33. "k8s.io/client-go/tools/leaderelection/resourcelock"
  34. "k8s.io/client-go/tools/record"
  35. cliflag "k8s.io/component-base/cli/flag"
  36. componentbaseconfig "k8s.io/component-base/config"
  37. "k8s.io/klog"
  38. kubeschedulerconfigv1alpha1 "k8s.io/kube-scheduler/config/v1alpha1"
  39. schedulerappconfig "k8s.io/kubernetes/cmd/kube-scheduler/app/config"
  40. "k8s.io/kubernetes/pkg/client/leaderelectionconfig"
  41. "k8s.io/kubernetes/pkg/master/ports"
  42. kubeschedulerconfig "k8s.io/kubernetes/pkg/scheduler/apis/config"
  43. kubeschedulerscheme "k8s.io/kubernetes/pkg/scheduler/apis/config/scheme"
  44. "k8s.io/kubernetes/pkg/scheduler/apis/config/validation"
  45. "k8s.io/kubernetes/pkg/scheduler/factory"
  46. )
  47. // Options has all the params needed to run a Scheduler
  48. type Options struct {
  49. // The default values. These are overridden if ConfigFile is set or by values in InsecureServing.
  50. ComponentConfig kubeschedulerconfig.KubeSchedulerConfiguration
  51. SecureServing *apiserveroptions.SecureServingOptionsWithLoopback
  52. CombinedInsecureServing *CombinedInsecureServingOptions
  53. Authentication *apiserveroptions.DelegatingAuthenticationOptions
  54. Authorization *apiserveroptions.DelegatingAuthorizationOptions
  55. Deprecated *DeprecatedOptions
  56. // ConfigFile is the location of the scheduler server's configuration file.
  57. ConfigFile string
  58. // WriteConfigTo is the path where the default configuration will be written.
  59. WriteConfigTo string
  60. Master string
  61. }
  62. // NewOptions returns default scheduler app options.
  63. func NewOptions() (*Options, error) {
  64. cfg, err := newDefaultComponentConfig()
  65. if err != nil {
  66. return nil, err
  67. }
  68. hhost, hport, err := splitHostIntPort(cfg.HealthzBindAddress)
  69. if err != nil {
  70. return nil, err
  71. }
  72. o := &Options{
  73. ComponentConfig: *cfg,
  74. SecureServing: apiserveroptions.NewSecureServingOptions().WithLoopback(),
  75. CombinedInsecureServing: &CombinedInsecureServingOptions{
  76. Healthz: (&apiserveroptions.DeprecatedInsecureServingOptions{
  77. BindNetwork: "tcp",
  78. }).WithLoopback(),
  79. Metrics: (&apiserveroptions.DeprecatedInsecureServingOptions{
  80. BindNetwork: "tcp",
  81. }).WithLoopback(),
  82. BindPort: hport,
  83. BindAddress: hhost,
  84. },
  85. Authentication: apiserveroptions.NewDelegatingAuthenticationOptions(),
  86. Authorization: apiserveroptions.NewDelegatingAuthorizationOptions(),
  87. Deprecated: &DeprecatedOptions{
  88. UseLegacyPolicyConfig: false,
  89. PolicyConfigMapNamespace: metav1.NamespaceSystem,
  90. },
  91. }
  92. o.Authentication.TolerateInClusterLookupFailure = true
  93. o.Authentication.RemoteKubeConfigFileOptional = true
  94. o.Authorization.RemoteKubeConfigFileOptional = true
  95. o.Authorization.AlwaysAllowPaths = []string{"/healthz"}
  96. // Set the PairName but leave certificate directory blank to generate in-memory by default
  97. o.SecureServing.ServerCert.CertDirectory = ""
  98. o.SecureServing.ServerCert.PairName = "kube-scheduler"
  99. o.SecureServing.BindPort = ports.KubeSchedulerPort
  100. return o, nil
  101. }
  102. func splitHostIntPort(s string) (string, int, error) {
  103. host, port, err := net.SplitHostPort(s)
  104. if err != nil {
  105. return "", 0, err
  106. }
  107. portInt, err := strconv.Atoi(port)
  108. if err != nil {
  109. return "", 0, err
  110. }
  111. return host, portInt, err
  112. }
  113. func newDefaultComponentConfig() (*kubeschedulerconfig.KubeSchedulerConfiguration, error) {
  114. cfgv1alpha1 := kubeschedulerconfigv1alpha1.KubeSchedulerConfiguration{}
  115. kubeschedulerscheme.Scheme.Default(&cfgv1alpha1)
  116. cfg := kubeschedulerconfig.KubeSchedulerConfiguration{}
  117. if err := kubeschedulerscheme.Scheme.Convert(&cfgv1alpha1, &cfg, nil); err != nil {
  118. return nil, err
  119. }
  120. return &cfg, nil
  121. }
  122. // Flags returns flags for a specific scheduler by section name
  123. func (o *Options) Flags() (nfs cliflag.NamedFlagSets) {
  124. fs := nfs.FlagSet("misc")
  125. fs.StringVar(&o.ConfigFile, "config", o.ConfigFile, "The path to the configuration file. Flags override values in this file.")
  126. fs.StringVar(&o.WriteConfigTo, "write-config-to", o.WriteConfigTo, "If set, write the configuration values to this file and exit.")
  127. fs.StringVar(&o.Master, "master", o.Master, "The address of the Kubernetes API server (overrides any value in kubeconfig)")
  128. o.SecureServing.AddFlags(nfs.FlagSet("secure serving"))
  129. o.CombinedInsecureServing.AddFlags(nfs.FlagSet("insecure serving"))
  130. o.Authentication.AddFlags(nfs.FlagSet("authentication"))
  131. o.Authorization.AddFlags(nfs.FlagSet("authorization"))
  132. o.Deprecated.AddFlags(nfs.FlagSet("deprecated"), &o.ComponentConfig)
  133. leaderelectionconfig.BindFlags(&o.ComponentConfig.LeaderElection.LeaderElectionConfiguration, nfs.FlagSet("leader election"))
  134. utilfeature.DefaultMutableFeatureGate.AddFlag(nfs.FlagSet("feature gate"))
  135. return nfs
  136. }
  137. // ApplyTo applies the scheduler options to the given scheduler app configuration.
  138. func (o *Options) ApplyTo(c *schedulerappconfig.Config) error {
  139. if len(o.ConfigFile) == 0 {
  140. c.ComponentConfig = o.ComponentConfig
  141. // only apply deprecated flags if no config file is loaded (this is the old behaviour).
  142. if err := o.Deprecated.ApplyTo(&c.ComponentConfig); err != nil {
  143. return err
  144. }
  145. if err := o.CombinedInsecureServing.ApplyTo(c, &c.ComponentConfig); err != nil {
  146. return err
  147. }
  148. } else {
  149. cfg, err := loadConfigFromFile(o.ConfigFile)
  150. if err != nil {
  151. return err
  152. }
  153. // use the loaded config file only, with the exception of --address and --port. This means that
  154. // none of the deprecated flags in o.Deprecated are taken into consideration. This is the old
  155. // behaviour of the flags we have to keep.
  156. c.ComponentConfig = *cfg
  157. if err := o.CombinedInsecureServing.ApplyToFromLoadedConfig(c, &c.ComponentConfig); err != nil {
  158. return err
  159. }
  160. }
  161. if err := o.SecureServing.ApplyTo(&c.SecureServing, &c.LoopbackClientConfig); err != nil {
  162. return err
  163. }
  164. if o.SecureServing != nil && (o.SecureServing.BindPort != 0 || o.SecureServing.Listener != nil) {
  165. if err := o.Authentication.ApplyTo(&c.Authentication, c.SecureServing, nil); err != nil {
  166. return err
  167. }
  168. if err := o.Authorization.ApplyTo(&c.Authorization); err != nil {
  169. return err
  170. }
  171. }
  172. return nil
  173. }
  174. // Validate validates all the required options.
  175. func (o *Options) Validate() []error {
  176. var errs []error
  177. if err := validation.ValidateKubeSchedulerConfiguration(&o.ComponentConfig).ToAggregate(); err != nil {
  178. errs = append(errs, err.Errors()...)
  179. }
  180. errs = append(errs, o.SecureServing.Validate()...)
  181. errs = append(errs, o.CombinedInsecureServing.Validate()...)
  182. errs = append(errs, o.Authentication.Validate()...)
  183. errs = append(errs, o.Authorization.Validate()...)
  184. errs = append(errs, o.Deprecated.Validate()...)
  185. return errs
  186. }
  187. // Config return a scheduler config object
  188. func (o *Options) Config() (*schedulerappconfig.Config, error) {
  189. if o.SecureServing != nil {
  190. if err := o.SecureServing.MaybeDefaultWithSelfSignedCerts("localhost", nil, []net.IP{net.ParseIP("127.0.0.1")}); err != nil {
  191. return nil, fmt.Errorf("error creating self-signed certificates: %v", err)
  192. }
  193. }
  194. c := &schedulerappconfig.Config{}
  195. if err := o.ApplyTo(c); err != nil {
  196. return nil, err
  197. }
  198. // Prepare kube clients.
  199. client, leaderElectionClient, eventClient, err := createClients(c.ComponentConfig.ClientConnection, o.Master, c.ComponentConfig.LeaderElection.RenewDeadline.Duration)
  200. if err != nil {
  201. return nil, err
  202. }
  203. // Prepare event clients.
  204. eventBroadcaster := record.NewBroadcaster()
  205. recorder := eventBroadcaster.NewRecorder(scheme.Scheme, corev1.EventSource{Component: c.ComponentConfig.SchedulerName})
  206. // Set up leader election if enabled.
  207. var leaderElectionConfig *leaderelection.LeaderElectionConfig
  208. if c.ComponentConfig.LeaderElection.LeaderElect {
  209. leaderElectionConfig, err = makeLeaderElectionConfig(c.ComponentConfig.LeaderElection, leaderElectionClient, recorder)
  210. if err != nil {
  211. return nil, err
  212. }
  213. }
  214. c.Client = client
  215. c.InformerFactory = informers.NewSharedInformerFactory(client, 0)
  216. c.PodInformer = factory.NewPodInformer(client, 0)
  217. c.EventClient = eventClient
  218. c.Recorder = recorder
  219. c.Broadcaster = eventBroadcaster
  220. c.LeaderElection = leaderElectionConfig
  221. return c, nil
  222. }
  223. // makeLeaderElectionConfig builds a leader election configuration. It will
  224. // create a new resource lock associated with the configuration.
  225. func makeLeaderElectionConfig(config kubeschedulerconfig.KubeSchedulerLeaderElectionConfiguration, client clientset.Interface, recorder record.EventRecorder) (*leaderelection.LeaderElectionConfig, error) {
  226. hostname, err := os.Hostname()
  227. if err != nil {
  228. return nil, fmt.Errorf("unable to get hostname: %v", err)
  229. }
  230. // add a uniquifier so that two processes on the same host don't accidentally both become active
  231. id := hostname + "_" + string(uuid.NewUUID())
  232. rl, err := resourcelock.New(config.ResourceLock,
  233. config.LockObjectNamespace,
  234. config.LockObjectName,
  235. client.CoreV1(),
  236. client.CoordinationV1(),
  237. resourcelock.ResourceLockConfig{
  238. Identity: id,
  239. EventRecorder: recorder,
  240. })
  241. if err != nil {
  242. return nil, fmt.Errorf("couldn't create resource lock: %v", err)
  243. }
  244. return &leaderelection.LeaderElectionConfig{
  245. Lock: rl,
  246. LeaseDuration: config.LeaseDuration.Duration,
  247. RenewDeadline: config.RenewDeadline.Duration,
  248. RetryPeriod: config.RetryPeriod.Duration,
  249. WatchDog: leaderelection.NewLeaderHealthzAdaptor(time.Second * 20),
  250. Name: "kube-scheduler",
  251. }, nil
  252. }
  253. // createClients creates a kube client and an event client from the given config and masterOverride.
  254. // TODO remove masterOverride when CLI flags are removed.
  255. func createClients(config componentbaseconfig.ClientConnectionConfiguration, masterOverride string, timeout time.Duration) (clientset.Interface, clientset.Interface, v1core.EventsGetter, error) {
  256. if len(config.Kubeconfig) == 0 && len(masterOverride) == 0 {
  257. klog.Warningf("Neither --kubeconfig nor --master was specified. Using default API client. This might not work.")
  258. }
  259. // This creates a client, first loading any specified kubeconfig
  260. // file, and then overriding the Master flag, if non-empty.
  261. kubeConfig, err := clientcmd.NewNonInteractiveDeferredLoadingClientConfig(
  262. &clientcmd.ClientConfigLoadingRules{ExplicitPath: config.Kubeconfig},
  263. &clientcmd.ConfigOverrides{ClusterInfo: clientcmdapi.Cluster{Server: masterOverride}}).ClientConfig()
  264. if err != nil {
  265. return nil, nil, nil, err
  266. }
  267. kubeConfig.AcceptContentTypes = config.AcceptContentTypes
  268. kubeConfig.ContentType = config.ContentType
  269. kubeConfig.QPS = config.QPS
  270. //TODO make config struct use int instead of int32?
  271. kubeConfig.Burst = int(config.Burst)
  272. client, err := clientset.NewForConfig(restclient.AddUserAgent(kubeConfig, "scheduler"))
  273. if err != nil {
  274. return nil, nil, nil, err
  275. }
  276. // shallow copy, do not modify the kubeConfig.Timeout.
  277. restConfig := *kubeConfig
  278. restConfig.Timeout = timeout
  279. leaderElectionClient, err := clientset.NewForConfig(restclient.AddUserAgent(&restConfig, "leader-election"))
  280. if err != nil {
  281. return nil, nil, nil, err
  282. }
  283. eventClient, err := clientset.NewForConfig(kubeConfig)
  284. if err != nil {
  285. return nil, nil, nil, err
  286. }
  287. return client, leaderElectionClient, eventClient.CoreV1(), nil
  288. }