183 lines
5.1 KiB
Groff
183 lines
5.1 KiB
Groff
.TH "KUBERNETES" "1" " kubernetes User Manuals" "Scott Collier" "October 2014" ""
|
|
|
|
.SH NAME
|
|
.PP
|
|
kube\-controller\-manager \- Enforces kubernetes services.
|
|
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\fBkube\-controller\-manager\fP [OPTIONS]
|
|
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The \fBkubernetes\fP controller manager is really a service that is layered on top of the simple pod API. To enforce this layering, the logic for the replicationcontroller is actually broken out into another server. This server watches etcd for changes to replicationcontroller objects and then uses the public Kubernetes API to implement the replication algorithm.
|
|
|
|
.PP
|
|
The kube\-controller\-manager has several options.
|
|
|
|
.SH OPTIONS
|
|
.PP
|
|
\fB\-\-address\fP=127.0.0.1
|
|
The IP address to serve on (set to 0.0.0.0 for all interfaces)
|
|
|
|
.PP
|
|
\fB\-\-allocate\-node\-cidrs\fP=false
|
|
Should CIDRs for Pods be allocated and set on the cloud provider.
|
|
|
|
.PP
|
|
\fB\-\-alsologtostderr\fP=false
|
|
log to standard error as well as files
|
|
|
|
.PP
|
|
\fB\-\-cloud\-config\fP=""
|
|
The path to the cloud provider configuration file. Empty string for no configuration file.
|
|
|
|
.PP
|
|
\fB\-\-cloud\-provider\fP=""
|
|
The provider for cloud services. Empty string for no provider.
|
|
|
|
.PP
|
|
\fB\-\-cluster\-cidr\fP=
|
|
CIDR Range for Pods in cluster.
|
|
|
|
.PP
|
|
\fB\-\-concurrent\-endpoint\-syncs\fP=5
|
|
The number of endpoint syncing operations that will be done concurrently. Larger number = faster endpoint updating, but more CPU (and network) load
|
|
|
|
.PP
|
|
\fB\-\-concurrent\_rc\_syncs\fP=5
|
|
The number of replication controllers that are allowed to sync concurrently. Larger number = more reponsive replica management, but more CPU (and network) load
|
|
|
|
.PP
|
|
\fB\-\-deleting\-pods\-burst\fP=10
|
|
Number of nodes on which pods are bursty deleted in case of node failure. For more details look into RateLimiter.
|
|
|
|
.PP
|
|
\fB\-\-deleting\-pods\-qps\fP=0.1
|
|
Number of nodes per second on which pods are deleted in case of node failure.
|
|
|
|
.PP
|
|
\fB\-\-kubeconfig\fP=""
|
|
Path to kubeconfig file with authorization and master location information.
|
|
|
|
.PP
|
|
\fB\-\-log\_backtrace\_at\fP=:0
|
|
when logging hits line file:N, emit a stack trace
|
|
|
|
.PP
|
|
\fB\-\-log\_dir\fP=
|
|
If non\-empty, write log files in this directory
|
|
|
|
.PP
|
|
\fB\-\-log\_flush\_frequency\fP=5s
|
|
Maximum number of seconds between log flushes
|
|
|
|
.PP
|
|
\fB\-\-logtostderr\fP=true
|
|
log to standard error instead of files
|
|
|
|
.PP
|
|
\fB\-\-machines\fP=[]
|
|
List of machines to schedule onto, comma separated.
|
|
|
|
.PP
|
|
\fB\-\-master\fP=""
|
|
The address of the Kubernetes API server (overrides any value in kubeconfig)
|
|
|
|
.PP
|
|
\fB\-\-minion\-regexp\fP=""
|
|
If non empty, and \-\-cloud\-provider is specified, a regular expression for matching minion VMs.
|
|
|
|
.PP
|
|
\fB\-\-namespace\-sync\-period\fP=5m0s
|
|
The period for syncing namespace life\-cycle updates
|
|
|
|
.PP
|
|
\fB\-\-node\-memory\fP=3Gi
|
|
The amount of memory (in bytes) provisioned on each node
|
|
|
|
.PP
|
|
\fB\-\-node\-milli\-cpu\fP=1000
|
|
The amount of MilliCPU provisioned on each node
|
|
|
|
.PP
|
|
\fB\-\-node\-monitor\-grace\-period\fP=40s
|
|
Amount of time which we allow running Node to be unresponsive before marking it unhealty. Must be N times more than kubelet's nodeStatusUpdateFrequency, where N means number of retries allowed for kubelet to post node status.
|
|
|
|
.PP
|
|
\fB\-\-node\-monitor\-period\fP=5s
|
|
The period for syncing NodeStatus in NodeController.
|
|
|
|
.PP
|
|
\fB\-\-node\-startup\-grace\-period\fP=1m0s
|
|
Amount of time which we allow starting Node to be unresponsive before marking it unhealty.
|
|
|
|
.PP
|
|
\fB\-\-node\-sync\-period\fP=10s
|
|
The period for syncing nodes from cloudprovider. Longer periods will result in fewer calls to cloud provider, but may delay addition of new nodes to cluster.
|
|
|
|
.PP
|
|
\fB\-\-pod\-eviction\-timeout\fP=5m0s
|
|
The grace period for deleting pods on failed nodes.
|
|
|
|
.PP
|
|
\fB\-\-port\fP=10252
|
|
The port that the controller\-manager's http service runs on
|
|
|
|
.PP
|
|
\fB\-\-profiling\fP=true
|
|
Enable profiling via web interface host:port/debug/pprof/
|
|
|
|
.PP
|
|
\fB\-\-pvclaimbinder\-sync\-period\fP=10s
|
|
The period for syncing persistent volumes and persistent volume claims
|
|
|
|
.PP
|
|
\fB\-\-register\-retry\-count\fP=10
|
|
The number of retries for initial node registration. Retry interval equals node\-sync\-period.
|
|
|
|
.PP
|
|
\fB\-\-resource\-quota\-sync\-period\fP=10s
|
|
The period for syncing quota usage status in the system
|
|
|
|
.PP
|
|
\fB\-\-service\-account\-private\-key\-file\fP=""
|
|
Filename containing a PEM\-encoded private RSA key used to sign service account tokens.
|
|
|
|
.PP
|
|
\fB\-\-stderrthreshold\fP=2
|
|
logs at or above this threshold go to stderr
|
|
|
|
.PP
|
|
\fB\-\-sync\-nodes\fP=true
|
|
If true, and \-\-cloud\-provider is specified, sync nodes from the cloud provider. Default true.
|
|
|
|
.PP
|
|
\fB\-\-v\fP=0
|
|
log level for V logs
|
|
|
|
.PP
|
|
\fB\-\-version\fP=false
|
|
Print version information and quit
|
|
|
|
.PP
|
|
\fB\-\-vmodule\fP=
|
|
comma\-separated list of pattern=N settings for file\-filtered logging
|
|
|
|
.SH EXAMPLES
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
/usr/bin/kube\-controller\-manager \-\-logtostderr=true \-\-v=0 \-\-master=127.0.0.1:8080 \-\-machines=127.0.0.1
|
|
|
|
.fi
|
|
|
|
.SH HISTORY
|
|
.PP
|
|
October 2014, Originally compiled by Scott Collier (scollier at redhat dot com) based
|
|
on the kubernetes source material and internal work.
|
|
|
|
.PP
|
|
[]()
|