kube-controller-manager 配置参数解读

向右看齐 2023-10-05 20:11 11阅读 0赞

下面是kube-controller-manager version 1.12.0的所有配置，其中高亮加粗的是我认为需要注意的Flag。

<table> 
 <thead> 
 <tr> 
 <th>Flag</th> 
 <th>Comments</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>–allocate-node-cidrs</td> 
 <td>在cloud provider上分配和设置pod的CIDR</td> 
 </tr> 
 <tr> 
 <td>–attach-detach-reconcile-sync-period</td> 
 <td>Volume连接与分离之间的同步等待时间。这个时间必须大于1秒，从默认值增加这个值可能会导致volume和pod不匹配，默认值1m0s</td> 
 </tr> 
 <tr> 
 <td>–authentication-kubeconfig</td> 
 <td>kubeconfig文件指向‘core‘ kubernetes服务，并有足够权限创建tokenaccessreviews.authentication.k8s.io. 。可选参数，如果为空，所有token请求都当作匿名的，集群不查找客户CA证书。</td> 
 </tr> 
 <tr> 
 <td>–authentication-skip-lookup</td> 
 <td>如果是false，authentication-kubeconfig会用来从集群中查找丢失的身份验证配置</td> 
 </tr> 
 <tr> 
 <td>–authentication-token-webhook-cache-ttl</td> 
 <td>从webhook token认证器缓存响应的持续时间，默认值10s</td> 
 </tr> 
 <tr> 
 <td>–authorization-always-allow-paths</td> 
 <td>忽略授权的HTTP路径列表，无需联系‘core’ kubernetes服务器****就可以进行授权。默认值：[/healthz]</td> 
 </tr> 
 <tr> 
 <td>–authorization-kubeconfig</td> 
 <td>kubeconfig文件指向‘core‘ kubernetes服务，并有足够权限创建subjectaccessreviews.authorization.k8s.io。可选参数，如果为空，所有未经授权跳过的请求都被禁止。</td> 
 </tr> 
 <tr> 
 <td>–authorization-webhook-cache-authorized-ttl</td> 
 <td>缓存webhook授权器已授权响应的持续时间。默认值：10s</td> 
 </tr> 
 <tr> 
 <td>–authorization-webhook-cache-unauthorized-ttl</td> 
 <td>缓存webhook授权器未授权响应的持续时间。默认值：10s</td> 
 </tr> 
 <tr> 
 <td>–azure-container-registry-config</td> 
 <td>包含Azure容器注册配置信息的文件路径</td> 
 </tr> 
 <tr> 
 <td>–bind-address</td> 
 <td>默认值：0.0.0.0，监听–secure-port端口的IP地址。关联的接口****必须由集群的其他部分和CLI/web客户端访问。</td> 
 </tr> 
 <tr> 
 <td>–cert-dir</td> 
 <td>TLS certs所在的目录。如果提供了–tls-cert-file和–tls-private-key-file****那么该参数会被忽略。默认值："/var/run/kubernetes"</td> 
 </tr> 
 <tr> 
 <td>–cidr-allocator-type</td> 
 <td>使用CIDR分配器的类型，默认值：“RangeAllocator”</td> 
 </tr> 
 <tr> 
 <td>–client-ca-file</td> 
 <td>如果set了，任何提供client-ca-file中由某个权威机构签名的客户机证书的请求都使用与客户机证书的公共名称相对应的身份进行身份验证</td> 
 </tr> 
 <tr> 
 <td>–cloud-config</td> 
 <td>cloud provider配置文件的路径。空表示没有配置文件</td> 
 </tr> 
 <tr> 
 <td>–cloud-provider</td> 
 <td>云服务提供商，空表示没有提供商</td> 
 </tr> 
 <tr> 
 <td>–cluster-cidr</td> 
 <td>集群内的pod的CIDR范围，需要 --allocate-node-cidrs设为true</td> 
 </tr> 
 <tr> 
 <td>–cluster-name</td> 
 <td>集群实例的前缀，默认值：“kubernetes”</td> 
 </tr> 
 <tr> 
 <td>–cluster-signing-cert-file</td> 
 <td>包含PEM编码的X509 CA证书的文件名，用来发出cluster-scoped证书****默认值："/etc/kubernetes/ca/ca.pem"</td> 
 </tr> 
 <tr> 
 <td>–cluster-signing-key-file</td> 
 <td>包含PEM编码的RSA或者ECDSA私钥的文件名，用来签署cluster-scoped证书****默认值："/etc/kubernetes/ca/ca.key"</td> 
 </tr> 
 <tr> 
 <td>–concurrent-deployment-syncs</td> 
 <td>允许并发同步的Deployment对象的数量，更大的数量等于更快的部署响应，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent-endpoint-syncs</td> 
 <td>允许并发执行端点同步操作的数量，更大的数量等于更快的端点更新，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent-gc-syncs</td> 
 <td>允许并发同步的垃圾收集器数量，默认值：20</td> 
 </tr> 
 <tr> 
 <td>–concurrent-namespace-syncs</td> 
 <td>允许并发同步的namespace对象的数量，更大的数量等于更快的namespace终止，但是更多的CPU（和网络）负载，默认值：10</td> 
 </tr> 
 <tr> 
 <td>–concurrent-replicaset-syncs</td> 
 <td>允许并发同步的replica sets的数量，更大的数量等于更快的replica管理，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent-resource-quota-syncs</td> 
 <td>允许并发同步的resource quta的数量，更大的数量等于更快的配额管理，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent-service-syncs</td> 
 <td>允许并发同步的service的数量，更大的数量等于更快的service管理，但是更多的CPU（和网络）负载，默认值：1</td> 
 </tr> 
 <tr> 
 <td>–concurrent-serviceaccount-token-syncs</td> 
 <td>允许并发同步的service account token的数量，更大的数量等于更快的产生token，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent-ttl-after-finished-syncs</td> 
 <td>允许并发同步的TTL-after-finished控制器数量，，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–concurrent_rc_syncs</td> 
 <td>允许并发同步的replication controllers的数量，更大的数量等于更快的replica管理，但是更多的CPU（和网络）负载，默认值：5</td> 
 </tr> 
 <tr> 
 <td>–configure-cloud-routes</td> 
 <td>由allocate-node-cidrs分配的CIDR是否应该在cloud provider上配置。</td> 
 </tr> 
 <tr> 
 <td>–contention-profiling</td> 
 <td>如果启用了profilling，则启用锁争用profilling</td> 
 </tr> 
 <tr> 
 <td>–controller-start-interval</td> 
 <td>启用controller manager之间的间隔</td> 
 </tr> 
 <tr> 
 <td>–controllers</td> 
 <td>要启用的控制器列表，‘*’表示启用所有on-by-default控制器，‘foo’表示启用名称****为foo的控制器，‘-foo’表示不启用名称为foo的控制器。默认值：[*]</td> 
 </tr> 
 <tr> 
 <td>–deployment-controller-sync-period</td> 
 <td>同步deployment的周期。默认值：30s</td> 
 </tr> 
 <tr> 
 <td>–disable-attach-detach-reconcile-sync</td> 
 <td>启用volume连接与分离的协调同步。禁用此选项可能导致volume和pod不同步</td> 
 </tr> 
 <tr> 
 <td>–enable-dynamic-provisioning</td> 
 <td>为支持动态供应的环境启用动态供应，默认值：true</td> 
 </tr> 
 <tr> 
 <td>–enable-garbage-collector</td> 
 <td>启用通用的垃圾收集器。必须与kube-apiserver的相应标志一致。默认值：true</td> 
 </tr> 
 <tr> 
 <td>–enable-hostpath-provisioner</td> 
 <td>在没有cloud provider的情况下，启用HostPath PV供应。允许在测试和开发供应该功能，HostPath供应无论如何都不受支持，因为不能在多节点集群中工作，并且不应该用于测试或开发之外。</td> 
 </tr> 
 <tr> 
 <td>–enable-taint-manager</td> 
 <td>Beta功能，如果设为true。启用Noexecute Taint，并且清除所有不允许运行在有Noexecute Taint的Node上的pod，默认为true。</td> 
 </tr> 
 <tr> 
 <td>–experimental-cluster-signing-duration</td> 
 <td>已签署证书的期限，默认值：8760h0m0s</td> 
 </tr> 
 <tr> 
 <td>–external-cloud-volume-plugin</td> 
 <td>当cloud provider设置为外部时使用的插件，可以为空，只有cloud provider为外部时设置。当前用于允许node和volume controller在树cloud provider中工作</td> 
 </tr> 
 <tr> 
 <td>–feature-gates</td> 
 <td>一组键值对用于描述alpha/实验特性的特性门</td> 
 </tr> 
 <tr> 
 <td>–flex-volume-plugin-dir</td> 
 <td>flex volume插件搜索附加的第三方volume插件的目录的完整路径默认值："/usr/libexec/kubernetes/kubelet-plugins/volume/exec/"</td> 
 </tr> 
 <tr> 
 <td>–horizontal-pod-autoscaler-cpu-initialization-period</td> 
 <td>Autoscaler扩展的pod启动后CPU样本可能会被跳过的时间。默认值：5m0s</td> 
 </tr> 
 <tr> 
 <td>–horizontal-pod-autoscaler-downscale-stabilization</td> 
 <td>Autoscaler向后看的时间段，这段时间内不会缩小POD的数量。默认值：5m0s</td> 
 </tr> 
 <tr> 
 <td>–horizontal-pod-autoscaler-initial-readiness-delay</td> 
 <td>Pod启动后的一段时间，这段时间内如果readiness改变了会重新当做新的readiness，默认值：30s</td> 
 </tr> 
 <tr> 
 <td>–horizontal-pod-autoscaler-sync-period</td> 
 <td>horizontal pod autoscaler同步pods数量的周期，默认值：15s</td> 
 </tr> 
 <tr> 
 <td>–horizontal-pod-autoscaler-tolerance</td> 
 <td>horizontal pod autoscaler考虑scaling所需的实际度量比率的最小变化（从1.0），默认值：0.1</td> 
 </tr> 
 <tr> 
 <td>–http2-max-streams-per-connection</td> 
 <td>服务器提供给客户端单个HTTP/2连接的最大数据流限制。0表示使用golang的默认值。</td> 
 </tr> 
 <tr> 
 <td>–insecure-experimental-approve-all-kubelet-csrs-for-group</td> 
 <td>该参数不做任何事情</td> 
 </tr> 
 <tr> 
 <td>–kube-api-burst</td> 
 <td>和kubernetes apiserver交互的突发量，默认值：30</td> 
 </tr> 
 <tr> 
 <td>–kube-api-content-type</td> 
 <td>发送给apiserver的请求的文本类型，默认值：“application/vnd.kubernetes.protobuf”</td> 
 </tr> 
 <tr> 
 <td>–kube-api-qps</td> 
 <td>与kubernetes apiserver交互的QPS</td> 
 </tr> 
 <tr> 
 <td>–kubeconfig</td> 
 <td>带有授权和master位置信息的kubeconfig文件路径</td> 
 </tr> 
 <tr> 
 <td>–large-cluster-size-threshold</td> 
 <td>NodeController将集群当做大集群的nodes数量，主要目的驱逐的逻辑。对于这种大小或者更小的集群，隐式的将–secondary-node-eviction-rate重写为0.</td> 
 </tr> 
 <tr> 
 <td>–leader-elect</td> 
 <td>**在执行主逻辑之前，启动leader选举，并获得leader权。**当为了高可用运行多个组件的时候启用该参数。默认值：true</td> 
 </tr> 
 <tr> 
 <td>–leader-elect-lease-duration duration</td> 
 <td>**Leader在被另外的候选者取代之前可以停止的最长时间。**只有当–leader-elect参数启用时该参数才适用。默认值：15s</td> 
 </tr> 
 <tr> 
 <td>–leader-elect-renew-deadline</td> 
 <td>**代理Master在转换leader权和停止leader权之间的间隔时间，这个参数****必须小于–leader-elect-lease-duration duration。**只有当–leader-elect参数启用时该参数才适用。默认值：10s</td> 
 </tr> 
 <tr> 
 <td>–leader-elect-resource-lock</td> 
 <td>**在leader选举期间锁定的资源对象类型。支持的选项：**endpoints（默认）和configmaps</td> 
 </tr> 
 <tr> 
 <td>–leader-elect-retry-period</td> 
 <td>**客户师徒获得和更换leader之间等待的时间。**只有当–leader-elect参数启用时该参数才适用。默认值：2s</td> 
 </tr> 
 <tr> 
 <td>–log-flush-frequency</td> 
 <td>日志刷新的间隔时间，默认值5s</td> 
 </tr> 
 <tr> 
 <td>–master</td> 
 <td>Kubernetes API server的地址（覆盖kubeconfig中的任意值）</td> 
 </tr> 
 <tr> 
 <td>–min-resync-period</td> 
 <td>反射器的同步周期，取值MinResyncPeriod and2*MinResyncPeriod的随机数。默认值12h0m0s</td> 
 </tr> 
 <tr> 
 <td>–namespace-sync-period</td> 
 <td>同步namespace生命周期更新的周期，默认值：5m0s</td> 
 </tr> 
 <tr> 
 <td>–node-cidr-mask-size</td> 
 <td>集群中node cidr的掩码大小，默认值：24</td> 
 </tr> 
 <tr> 
 <td>–node-eviction-rate</td> 
 <td>一个健康的zone中Node失败时，每秒删除失败Node上Pod的百分比。默认值：0.1，即默认10s删除失败节点的所有Pod。zone是指非多区域集群中的整个集群</td> 
 </tr> 
 <tr> 
 <td>–node-monitor-grace-period</td> 
 <td>标识node为unhealthy之前，允许运行node不响应的时间，必须是kubelet nodeStatusUpdateFrequency参数的N倍，其中N表示允许kubelet节点状态的重试次数。默认值：40s</td> 
 </tr> 
 <tr> 
 <td>–node-monitor-period</td> 
 <td>NodeController同步NodeStatus的间隔时间，默认值：5s</td> 
 </tr> 
 <tr> 
 <td>–node-startup-grace-period</td> 
 <td>在标记unhealthy之前，允许启动节点不响应的时间。默认值：1m0s</td> 
 </tr> 
 <tr> 
 <td>–pod-eviction-timeout</td> 
 <td>在失败节点删除pod的宽限期，默认值：5m0s</td> 
 </tr> 
 <tr> 
 <td>–profiling</td> 
 <td>通过web接口host:port/debug/pprof/ 启用profilling</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-increment-timeout-nfs</td> 
 <td>对于NFS洗涤pod，每个Gi向ActiveDeadlineSeconds增加的时间，默认值：30s</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-minimum-timeout-hostpath</td> 
 <td>用于HostPath回收Pod的最小的activedeadlinesecond。该参数仅用于开发测试，在多节点的集群不能使用。默认值60.</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-minimum-timeout-nfs</td> 
 <td>用于NFS回收Pod的最小的activedeadlinesecond，默认值：300</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-pod-template-filepath-hostpath</td> 
 <td>用于Hostpath pv回收模板的pod定义的文件路径。该参数仅用于开发测试，在多节点的集群不能使用。</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-pod-template-filepath-nfs</td> 
 <td>用于NFS pv回收模板的pod定义的文件路径。该参数仅用于开发测试，在多节点的集群不能使用。</td> 
 </tr> 
 <tr> 
 <td>–pv-recycler-timeout-increment-hostpath</td> 
 <td>对于HostPath洗涤pod，每个Gi向ActiveDeadlineSeconds增加的时间，该参数仅用于开发测试，在多节点的集群不能使用。默认值：30s</td> 
 </tr> 
 <tr> 
 <td>–pvclaimbinder-sync-period duration</td> 
 <td>同步pv和pv 请求的周期，默认值：15s</td> 
 </tr> 
 <tr> 
 <td>–requestheader-allowed-names</td> 
 <td>客户端证书常用名称列表，允许–requestheader-username-headers中指定的标头提供用户名。如为空，则允许–requestheader-client-ca-file文件中当局验证的任何客户端证书。</td> 
 </tr> 
 <tr> 
 <td>–requestheader-client-ca-file</td> 
 <td>用于在信任由—requestheader-username-headers指定的标头中的用户名前，验证传入请求的客户端证书的根证书绑定包</td> 
 </tr> 
 <tr> 
 <td>–requestheader-extra-headers-prefix</td> 
 <td>要检查的请求标头前缀列表。建议设定为X-Remote-Extra.</td> 
 </tr> 
 <tr> 
 <td>–requestheader-group-headers</td> 
 <td>要检查组的请求标头列表。建议设定为X-Remote-Group</td> 
 </tr> 
 <tr> 
 <td>–requestheader-username-headers</td> 
 <td>要检查用户名的请求标头列表。常用X-Remote-User</td> 
 </tr> 
 <tr> 
 <td>–resource-quota-sync-period</td> 
 <td>同步系统配额使用状态的周期，默认值：5m0s</td> 
 </tr> 
 <tr> 
 <td>–root-ca-file</td> 
 <td>如果设置，该根证书权限将包含service acount的toker secret。这必须是一个有效的PEM编码CA 包。</td> 
 </tr> 
 <tr> 
 <td>–route-reconciliation-period</td> 
 <td>cloud provider为节点创建协调路由的周期，默认值：10s</td> 
 </tr> 
 <tr> 
 <td>–secondary-node-eviction-rate</td> 
 <td>区域不健康时，当节点失败，每秒删除失败Node上pod的百分比。如果集群规模小于–large-cluster-size-threshold，则该值将隐式重写为0。默认值：0.01，即默认100s删除失败节点的所有Pod。</td> 
 </tr> 
 <tr> 
 <td>–secure-port</td> 
 <td>使用身份验证和授权为HTTPS提供服务的端口。如果是0，表示****不提供HTTPS服务。默认值：10257</td> 
 </tr> 
 <tr> 
 <td>–service-account-private-key-file</td> 
 <td>包含用于签署service account token的PEM编码RSA或者ECDSA私钥的文件名</td> 
 </tr> 
 <tr> 
 <td>–service-cluster-ip-rang</td> 
 <td>集群Services 的CIDR范围。需要–allocate-node-cidrs设为true</td> 
 </tr> 
 <tr> 
 <td>–terminated-pod-gc-threshold</td> 
 <td>在pod垃圾收集器开始删除终止pod之前，可以存在的终止pod数量。默认值：12500</td> 
 </tr> 
 <tr> 
 <td>–tls-cert-file</td> 
 <td>包含用于HTTPS的默认x509证书的文件。如果HTTPS服务启用，并且–tls-cert-file和–tls-private-key-file没有提供，将为公共地址生成自签名证书和密钥，并保存到–cert-dir制定的目录。</td> 
 </tr> 
 <tr> 
 <td>–tls-cipher-suites</td> 
 <td>用逗号分隔服务器密码套件列表。如果省略，将使用默认的Go密码套件</td> 
 </tr> 
 <tr> 
 <td>–tls-min-version</td> 
 <td>支持的最小的TLS版本。可能的值：VersionTLS10, VersionTLS11,VersionTLS12</td> 
 </tr> 
 <tr> 
 <td>–tls-private-key-file</td> 
 <td>包含匹配–tls-cert-file的默认x509私钥的文件</td> 
 </tr> 
 <tr> 
 <td>–unhealthy-zone-threshold</td> 
 <td>区域被视为不健康时，Not Ready 节点的比例</td> 
 </tr> 
 <tr> 
 <td>–use-service-account-credentials</td> 
 <td>如果true，为每个控制器使用单独的service account证书</td> 
 </tr> 
 <tr> 
 <td>–tls-sni-cert-key namedCertKey</td> 
 <td>A pair of x509 certificate and private key file paths, optionallysuffixed with a list of domain patterns which are fully qualifieddomain names, possibly with prefixed wildcard segments. If nodomain patterns are provided, the names of the certificate areextracted. Non-wildcard matches trump over wildcard matches,explicit domain patterns trump over extracted names. For multiplekey/certificate pairs, use the --tls-sni-cert-key multiple times.Examples: “example.crt,example.key” or"foo.crt,foo.key:*.foo.com,foo.com". Default:[]</td> 
 </tr> 
 </tbody> 
</table>

参考链接：

[kube-controller-manager介绍][kube-controller-manager]

[kube-controller-manager 配置参数解读（kubernets version 1.12.0）][kube-controller-manager _kubernets version 1.12.0]

[kube-controller-manager]: https://kubernetes.io/zh/docs/reference/command-line-tools-reference/kube-controller-manager/
[kube-controller-manager _kubernets version 1.12.0]: https://my.oschina.net/u/3797264/blog/2243818