1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl plugin - Provides utilities for interacting with plugins.
10
14 kubectl plugin [OPTIONS]
15
19 Provides utilities for interacting with plugins.
20 Plugins provide extended functionality that is not part of the major
23 command-line distribution. Please refer to the documentation and exam‐
24 ples for more information about how write your own plugins.
25 The easiest way to discover and install plugins is via the kubernetes
28 sub-project krew. To install krew, visit
29 https://krew.sigs.k8s.io/docs/user-guide/setup/install/
30
34 --add-dir-header=false If true, adds the file directory to the
35 header of the log messages
36 --alsologtostderr=false log to standard error as well as files
39 --application-metrics-count-limit=100 Max number of application
42 metrics to store (per container)
43 --as="" Username to impersonate for the operation
46 --as-group=[] Group to impersonate for the operation, this flag
49 can be repeated to specify multiple groups.
50 --azure-container-registry-config="" Path to the file containing
53 Azure container registry configuration information.
54 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
57 list of files to check for boot-id. Use the first one that exists.
58 --cache-dir="/builddir/.kube/cache" Default cache directory
61 --certificate-authority="" Path to a cert file for the certificate
64 authority
65 --client-certificate="" Path to a client certificate file for TLS
68 --client-key="" Path to a client key file for TLS
71 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
74 CIDRs opened in GCE firewall for L7 LB traffic proxy health
75 checks
76 --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
79 CIDRs opened in GCE firewall for L4 LB traffic proxy health
80 checks
81 --cluster="" The name of the kubeconfig cluster to use
84 --container-hints="/etc/cadvisor/container_hints.json" location of
87 the container hints file
88 --containerd="/run/containerd/containerd.sock" containerd endpoint
91 --containerd-namespace="k8s.io" containerd namespace
94 --context="" The name of the kubeconfig context to use
97 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
100 tionSeconds of the toleration for notReady:NoExecute that is added by
101 default to every pod that does not already have such a toleration.
102 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
105 tionSeconds of the toleration for unreachable:NoExecute that is added
106 by default to every pod that does not already have such a toleration.
107 --disable-root-cgroup-stats=false Disable collecting root Cgroup
110 stats
111 --docker="unix:///var/run/docker.sock" docker endpoint
114 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
117 ronment variable keys matched with specified prefix that needs to be
118 collected for docker containers
119 --docker-only=false Only report docker containers in addition to
122 root stats
123 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
126 from docker info (this is a fallback, default: /var/lib/docker)
127 --docker-tls=false use TLS to connect to docker
130 --docker-tls-ca="ca.pem" path to trusted CA
133 --docker-tls-cert="cert.pem" path to client certificate
136 --docker-tls-key="key.pem" path to private key
139 --enable-load-reader=false Whether to enable cpu load reader
142 --event-storage-age-limit="default=0" Max length of time for which
145 to store events (per type). Value is a comma separated list of key val‐
146 ues, where the keys are event types (e.g.: creation, oom) or "default"
147 and the value is a duration. Default is applied to all non-specified
148 event types
149 --event-storage-event-limit="default=0" Max number of events to
152 store (per type). Value is a comma separated list of key values, where
153 the keys are event types (e.g.: creation, oom) or "default" and the
154 value is an integer. Default is applied to all non-specified event
155 types
156 --global-housekeeping-interval=1m0s Interval between global house‐
159 keepings
160 --housekeeping-interval=10s Interval between container housekeep‐
163 ings
164 --insecure-skip-tls-verify=false If true, the server's certificate
167 will not be checked for validity. This will make your HTTPS connections
168 insecure
169 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
172 quests.
173 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
176 trace
177 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
180 sor container
181 --log-dir="" If non-empty, write log files in this directory
184 --log-file="" If non-empty, use this log file
187 --log-file-max-size=1800 Defines the maximum size a log file can
190 grow to. Unit is megabytes. If the value is 0, the maximum file size is
191 unlimited.
192 --log-flush-frequency=5s Maximum number of seconds between log
195 flushes
196 --logtostderr=true log to standard error instead of files
199 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
202 Comma-separated list of files to check for machine-id. Use the
203 first one that exists.
204 --match-server-version=false Require server version to match
207 client version
208 -n, --namespace="" If present, the namespace scope for this CLI
211 request
212 --one-output=false If true, only write logs to their native sever‐
215 ity level (vs also writing to each lower severity level)
216 --password="" Password for basic authentication to the API server
219 --profile="none" Name of profile to capture. One of
222 (none|cpu|heap|goroutine|threadcreate|block|mutex)
223 --profile-output="profile.pprof" Name of the file to write the
226 profile to
227 --referenced-reset-interval=0 Reset interval for referenced bytes
230 (container_referenced_bytes metric), number of measurement cycles after
231 which referenced bytes are cleared, if set to 0 referenced bytes are
232 never cleared (default: 0)
233 --request-timeout="0" The length of time to wait before giving up
236 on a single server request. Non-zero values should contain a corre‐
237 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
238 out requests.
239 -s, --server="" The address and port of the Kubernetes API server
242 --skip-headers=false If true, avoid header prefixes in the log
245 messages
246 --skip-log-headers=false If true, avoid headers when opening log
249 files
250 --stderrthreshold=2 logs at or above this threshold go to stderr
253 --storage-driver-buffer-duration=1m0s Writes in the storage driver
256 will be buffered for this duration, and committed to the non memory
257 backends as a single transaction
258 --storage-driver-db="cadvisor" database name
261 --storage-driver-host="localhost:8086" database host:port
264 --storage-driver-password="root" database password
267 --storage-driver-secure=false use secure connection with database
270 --storage-driver-table="stats" table name
273 --storage-driver-user="root" database username
276 --tls-server-name="" Server name to use for server certificate
279 validation. If it is not provided, the hostname used to contact the
280 server is used
281 --token="" Bearer token for authentication to the API server
284 --update-machine-info-interval=5m0s Interval between machine info
287 updates.
288 --user="" The name of the kubeconfig user to use
291 --username="" Username for basic authentication to the API server
294 -v, --v=0 number for the log level verbosity
297 --version=false Print version information and quit
300 --vmodule= comma-separated list of pattern=N settings for
303 file-filtered logging
304 --warnings-as-errors=false Treat warnings received from the server
307 as errors and exit with a non-zero exit code
308
312 kubectl(1), kubectl-plugin-list(1),
313
317 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
318 com) based on the kubernetes source material, but hopefully they have
319 been automatically generated since!
320Manuals User KUBERNETES(1)(kubernetes)