2023-05-29 21:03:29 +00:00
/ *
Copyright 2017 The Kubernetes Authors .
Licensed under the Apache License , Version 2.0 ( the "License" ) ;
you may not use this file except in compliance with the License .
You may obtain a copy of the License at
http : //www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing , software
distributed under the License is distributed on an "AS IS" BASIS ,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND , either express or implied .
See the License for the specific language governing permissions and
limitations under the License .
* /
package options
import (
2023-12-20 12:23:59 +00:00
"fmt"
2023-05-29 21:03:29 +00:00
"github.com/spf13/pflag"
"k8s.io/apimachinery/pkg/runtime/serializer"
"k8s.io/apiserver/pkg/server"
2023-12-20 12:23:59 +00:00
utilflowcontrol "k8s.io/apiserver/pkg/util/flowcontrol"
"k8s.io/client-go/informers"
"k8s.io/client-go/kubernetes"
2023-05-29 21:03:29 +00:00
)
type FeatureOptions struct {
EnableProfiling bool
2023-06-01 16:58:10 +00:00
DebugSocketPath string
2023-05-29 21:03:29 +00:00
EnableContentionProfiling bool
2023-12-20 12:23:59 +00:00
EnablePriorityAndFairness bool
2023-05-29 21:03:29 +00:00
}
func NewFeatureOptions ( ) * FeatureOptions {
defaults := server . NewConfig ( serializer . CodecFactory { } )
return & FeatureOptions {
EnableProfiling : defaults . EnableProfiling ,
2023-06-01 16:58:10 +00:00
DebugSocketPath : defaults . DebugSocketPath ,
2023-05-29 21:03:29 +00:00
EnableContentionProfiling : defaults . EnableContentionProfiling ,
2023-12-20 12:23:59 +00:00
EnablePriorityAndFairness : true ,
2023-05-29 21:03:29 +00:00
}
}
func ( o * FeatureOptions ) AddFlags ( fs * pflag . FlagSet ) {
if o == nil {
return
}
fs . BoolVar ( & o . EnableProfiling , "profiling" , o . EnableProfiling ,
"Enable profiling via web interface host:port/debug/pprof/" )
fs . BoolVar ( & o . EnableContentionProfiling , "contention-profiling" , o . EnableContentionProfiling ,
2023-06-01 16:58:10 +00:00
"Enable block profiling, if profiling is enabled" )
fs . StringVar ( & o . DebugSocketPath , "debug-socket-path" , o . DebugSocketPath ,
"Use an unprotected (no authn/authz) unix-domain socket for profiling with the given path" )
2023-12-20 12:23:59 +00:00
fs . BoolVar ( & o . EnablePriorityAndFairness , "enable-priority-and-fairness" , o . EnablePriorityAndFairness , "" +
"If true, replace the max-in-flight handler with an enhanced one that queues and dispatches with priority and fairness" )
2023-05-29 21:03:29 +00:00
}
2023-12-20 12:23:59 +00:00
func ( o * FeatureOptions ) ApplyTo ( c * server . Config , clientset kubernetes . Interface , informers informers . SharedInformerFactory ) error {
2023-05-29 21:03:29 +00:00
if o == nil {
return nil
}
c . EnableProfiling = o . EnableProfiling
2023-06-01 16:58:10 +00:00
c . DebugSocketPath = o . DebugSocketPath
2023-05-29 21:03:29 +00:00
c . EnableContentionProfiling = o . EnableContentionProfiling
2023-12-20 12:23:59 +00:00
if o . EnablePriorityAndFairness {
2024-08-19 08:01:33 +00:00
if clientset == nil {
return fmt . Errorf ( "invalid configuration: priority and fairness requires a core Kubernetes client" )
}
2023-12-20 12:23:59 +00:00
if c . MaxRequestsInFlight + c . MaxMutatingRequestsInFlight <= 0 {
return fmt . Errorf ( "invalid configuration: MaxRequestsInFlight=%d and MaxMutatingRequestsInFlight=%d; they must add up to something positive" , c . MaxRequestsInFlight , c . MaxMutatingRequestsInFlight )
}
c . FlowControl = utilflowcontrol . New (
informers ,
clientset . FlowcontrolV1 ( ) ,
c . MaxRequestsInFlight + c . MaxMutatingRequestsInFlight ,
)
}
2023-05-29 21:03:29 +00:00
return nil
}
func ( o * FeatureOptions ) Validate ( ) [ ] error {
if o == nil {
return nil
}
errs := [ ] error { }
return errs
}