1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl version - Print the client and server version information
10
14 kubectl version [OPTIONS]
15
19 Print the client and server version information for the current context
20
24 --client=false If true, shows client version only (no server re‐
25 quired).
26 -o, --output="" One of 'yaml' or 'json'.
29 --short=false If true, print just the version number.
32
36 --add-dir-header=false If true, adds the file directory to the
37 header of the log messages
38 --alsologtostderr=false log to standard error as well as files
41 --application-metrics-count-limit=100 Max number of application
44 metrics to store (per container)
45 --as="" Username to impersonate for the operation
48 --as-group=[] Group to impersonate for the operation, this flag
51 can be repeated to specify multiple groups.
52 --azure-container-registry-config="" Path to the file containing
55 Azure container registry configuration information.
56 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
59 list of files to check for boot-id. Use the first one that exists.
60 --cache-dir="/builddir/.kube/cache" Default cache directory
63 --certificate-authority="" Path to a cert file for the certificate
66 authority
67 --client-certificate="" Path to a client certificate file for TLS
70 --client-key="" Path to a client key file for TLS
73 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
76 CIDRs opened in GCE firewall for L7 LB traffic proxy health
77 checks
78 --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
81 CIDRs opened in GCE firewall for L4 LB traffic proxy health
82 checks
83 --cluster="" The name of the kubeconfig cluster to use
86 --container-hints="/etc/cadvisor/container_hints.json" location of
89 the container hints file
90 --containerd="/run/containerd/containerd.sock" containerd endpoint
93 --containerd-namespace="k8s.io" containerd namespace
96 --context="" The name of the kubeconfig context to use
99 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
102 tionSeconds of the toleration for notReady:NoExecute that is added by
103 default to every pod that does not already have such a toleration.
104 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
107 tionSeconds of the toleration for unreachable:NoExecute that is added
108 by default to every pod that does not already have such a toleration.
109 --disable-root-cgroup-stats=false Disable collecting root Cgroup
112 stats
113 --docker="unix:///var/run/docker.sock" docker endpoint
116 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
119 ronment variable keys matched with specified prefix that needs to be
120 collected for docker containers
121 --docker-only=false Only report docker containers in addition to
124 root stats
125 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
128 from docker info (this is a fallback, default: /var/lib/docker)
129 --docker-tls=false use TLS to connect to docker
132 --docker-tls-ca="ca.pem" path to trusted CA
135 --docker-tls-cert="cert.pem" path to client certificate
138 --docker-tls-key="key.pem" path to private key
141 --enable-load-reader=false Whether to enable cpu load reader
144 --event-storage-age-limit="default=0" Max length of time for which
147 to store events (per type). Value is a comma separated list of key val‐
148 ues, where the keys are event types (e.g.: creation, oom) or "default"
149 and the value is a duration. Default is applied to all non-specified
150 event types
151 --event-storage-event-limit="default=0" Max number of events to
154 store (per type). Value is a comma separated list of key values, where
155 the keys are event types (e.g.: creation, oom) or "default" and the
156 value is an integer. Default is applied to all non-specified event
157 types
158 --global-housekeeping-interval=1m0s Interval between global house‐
161 keepings
162 --housekeeping-interval=10s Interval between container housekeep‐
165 ings
166 --insecure-skip-tls-verify=false If true, the server's certificate
169 will not be checked for validity. This will make your HTTPS connections
170 insecure
171 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
174 quests.
175 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
178 trace
179 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
182 sor container
183 --log-dir="" If non-empty, write log files in this directory
186 --log-file="" If non-empty, use this log file
189 --log-file-max-size=1800 Defines the maximum size a log file can
192 grow to. Unit is megabytes. If the value is 0, the maximum file size is
193 unlimited.
194 --log-flush-frequency=5s Maximum number of seconds between log
197 flushes
198 --logtostderr=true log to standard error instead of files
201 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
204 Comma-separated list of files to check for machine-id. Use the
205 first one that exists.
206 --match-server-version=false Require server version to match
209 client version
210 -n, --namespace="" If present, the namespace scope for this CLI
213 request
214 --one-output=false If true, only write logs to their native sever‐
217 ity level (vs also writing to each lower severity level)
218 --password="" Password for basic authentication to the API server
221 --profile="none" Name of profile to capture. One of
224 (none|cpu|heap|goroutine|threadcreate|block|mutex)
225 --profile-output="profile.pprof" Name of the file to write the
228 profile to
229 --referenced-reset-interval=0 Reset interval for referenced bytes
232 (container_referenced_bytes metric), number of measurement cycles after
233 which referenced bytes are cleared, if set to 0 referenced bytes are
234 never cleared (default: 0)
235 --request-timeout="0" The length of time to wait before giving up
238 on a single server request. Non-zero values should contain a corre‐
239 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
240 out requests.
241 -s, --server="" The address and port of the Kubernetes API server
244 --skip-headers=false If true, avoid header prefixes in the log
247 messages
248 --skip-log-headers=false If true, avoid headers when opening log
251 files
252 --stderrthreshold=2 logs at or above this threshold go to stderr
255 --storage-driver-buffer-duration=1m0s Writes in the storage driver
258 will be buffered for this duration, and committed to the non memory
259 backends as a single transaction
260 --storage-driver-db="cadvisor" database name
263 --storage-driver-host="localhost:8086" database host:port
266 --storage-driver-password="root" database password
269 --storage-driver-secure=false use secure connection with database
272 --storage-driver-table="stats" table name
275 --storage-driver-user="root" database username
278 --tls-server-name="" Server name to use for server certificate
281 validation. If it is not provided, the hostname used to contact the
282 server is used
283 --token="" Bearer token for authentication to the API server
286 --update-machine-info-interval=5m0s Interval between machine info
289 updates.
290 --user="" The name of the kubeconfig user to use
293 --username="" Username for basic authentication to the API server
296 -v, --v=0 number for the log level verbosity
299 --version=false Print version information and quit
302 --vmodule= comma-separated list of pattern=N settings for
305 file-filtered logging
306 --warnings-as-errors=false Treat warnings received from the server
309 as errors and exit with a non-zero exit code
310
314 # Print the client and server versions for the current context
315 kubectl version
316
321 kubectl(1),
322
326 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
327 com) based on the kubernetes source material, but hopefully they have
328 been automatically generated since!
329Manuals User KUBERNETES(1)(kubernetes)