1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl rollout status - Show the status of the rollout
10
14 kubectl rollout status [OPTIONS]
15
19 Show the status of the rollout.
20 By default 'rollout status' will watch the status of the latest rollout
23 until it's done. If you don't want to wait for the rollout to finish
24 then you can use --watch=false. Note that if a new rollout starts
25 in-between, then 'rollout status' will continue watching the latest re‐
26 vision. If you want to pin to a specific revision and abort if it is
27 rolled over by another revision, use --revision=N where N is the revi‐
28 sion you need to watch for.
29
33 -f, --filename=[] Filename, directory, or URL to files identifying
34 the resource to get from a server.
35 -k, --kustomize="" Process the kustomization directory. This flag
38 can't be used together with -f or -R.
39 -R, --recursive=false Process the directory used in -f, --filename
42 recursively. Useful when you want to manage related manifests organized
43 within the same directory.
44 --revision=0 Pin to a specific revision for showing its status.
47 Defaults to 0 (last revision).
48 --timeout=0s The length of time to wait before ending watch, zero
51 means never. Any other values should contain a corresponding time unit
52 (e.g. 1s, 2m, 3h).
53 -w, --watch=true Watch the status of the rollout until it's done.
56
60 --add-dir-header=false If true, adds the file directory to the
61 header of the log messages
62 --alsologtostderr=false log to standard error as well as files
65 --application-metrics-count-limit=100 Max number of application
68 metrics to store (per container)
69 --as="" Username to impersonate for the operation
72 --as-group=[] Group to impersonate for the operation, this flag
75 can be repeated to specify multiple groups.
76 --azure-container-registry-config="" Path to the file containing
79 Azure container registry configuration information.
80 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
83 list of files to check for boot-id. Use the first one that exists.
84 --cache-dir="/builddir/.kube/cache" Default cache directory
87 --certificate-authority="" Path to a cert file for the certificate
90 authority
91 --client-certificate="" Path to a client certificate file for TLS
94 --client-key="" Path to a client key file for TLS
97 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
100 CIDRs opened in GCE firewall for L7 LB traffic proxy health
101 checks
102 --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
105 CIDRs opened in GCE firewall for L4 LB traffic proxy health
106 checks
107 --cluster="" The name of the kubeconfig cluster to use
110 --container-hints="/etc/cadvisor/container_hints.json" location of
113 the container hints file
114 --containerd="/run/containerd/containerd.sock" containerd endpoint
117 --containerd-namespace="k8s.io" containerd namespace
120 --context="" The name of the kubeconfig context to use
123 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
126 tionSeconds of the toleration for notReady:NoExecute that is added by
127 default to every pod that does not already have such a toleration.
128 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
131 tionSeconds of the toleration for unreachable:NoExecute that is added
132 by default to every pod that does not already have such a toleration.
133 --disable-root-cgroup-stats=false Disable collecting root Cgroup
136 stats
137 --docker="unix:///var/run/docker.sock" docker endpoint
140 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
143 ronment variable keys matched with specified prefix that needs to be
144 collected for docker containers
145 --docker-only=false Only report docker containers in addition to
148 root stats
149 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
152 from docker info (this is a fallback, default: /var/lib/docker)
153 --docker-tls=false use TLS to connect to docker
156 --docker-tls-ca="ca.pem" path to trusted CA
159 --docker-tls-cert="cert.pem" path to client certificate
162 --docker-tls-key="key.pem" path to private key
165 --enable-load-reader=false Whether to enable cpu load reader
168 --event-storage-age-limit="default=0" Max length of time for which
171 to store events (per type). Value is a comma separated list of key val‐
172 ues, where the keys are event types (e.g.: creation, oom) or "default"
173 and the value is a duration. Default is applied to all non-specified
174 event types
175 --event-storage-event-limit="default=0" Max number of events to
178 store (per type). Value is a comma separated list of key values, where
179 the keys are event types (e.g.: creation, oom) or "default" and the
180 value is an integer. Default is applied to all non-specified event
181 types
182 --global-housekeeping-interval=1m0s Interval between global house‐
185 keepings
186 --housekeeping-interval=10s Interval between container housekeep‐
189 ings
190 --insecure-skip-tls-verify=false If true, the server's certificate
193 will not be checked for validity. This will make your HTTPS connections
194 insecure
195 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
198 quests.
199 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
202 trace
203 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
206 sor container
207 --log-dir="" If non-empty, write log files in this directory
210 --log-file="" If non-empty, use this log file
213 --log-file-max-size=1800 Defines the maximum size a log file can
216 grow to. Unit is megabytes. If the value is 0, the maximum file size is
217 unlimited.
218 --log-flush-frequency=5s Maximum number of seconds between log
221 flushes
222 --logtostderr=true log to standard error instead of files
225 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
228 Comma-separated list of files to check for machine-id. Use the
229 first one that exists.
230 --match-server-version=false Require server version to match
233 client version
234 -n, --namespace="" If present, the namespace scope for this CLI
237 request
238 --one-output=false If true, only write logs to their native sever‐
241 ity level (vs also writing to each lower severity level)
242 --password="" Password for basic authentication to the API server
245 --profile="none" Name of profile to capture. One of
248 (none|cpu|heap|goroutine|threadcreate|block|mutex)
249 --profile-output="profile.pprof" Name of the file to write the
252 profile to
253 --referenced-reset-interval=0 Reset interval for referenced bytes
256 (container_referenced_bytes metric), number of measurement cycles after
257 which referenced bytes are cleared, if set to 0 referenced bytes are
258 never cleared (default: 0)
259 --request-timeout="0" The length of time to wait before giving up
262 on a single server request. Non-zero values should contain a corre‐
263 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
264 out requests.
265 -s, --server="" The address and port of the Kubernetes API server
268 --skip-headers=false If true, avoid header prefixes in the log
271 messages
272 --skip-log-headers=false If true, avoid headers when opening log
275 files
276 --stderrthreshold=2 logs at or above this threshold go to stderr
279 --storage-driver-buffer-duration=1m0s Writes in the storage driver
282 will be buffered for this duration, and committed to the non memory
283 backends as a single transaction
284 --storage-driver-db="cadvisor" database name
287 --storage-driver-host="localhost:8086" database host:port
290 --storage-driver-password="root" database password
293 --storage-driver-secure=false use secure connection with database
296 --storage-driver-table="stats" table name
299 --storage-driver-user="root" database username
302 --tls-server-name="" Server name to use for server certificate
305 validation. If it is not provided, the hostname used to contact the
306 server is used
307 --token="" Bearer token for authentication to the API server
310 --update-machine-info-interval=5m0s Interval between machine info
313 updates.
314 --user="" The name of the kubeconfig user to use
317 --username="" Username for basic authentication to the API server
320 -v, --v=0 number for the log level verbosity
323 --version=false Print version information and quit
326 --vmodule= comma-separated list of pattern=N settings for
329 file-filtered logging
330 --warnings-as-errors=false Treat warnings received from the server
333 as errors and exit with a non-zero exit code
334
338 # Watch the rollout status of a deployment
339 kubectl rollout status deployment/nginx
340
345 kubectl-rollout(1),
346
350 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
351 com) based on the kubernetes source material, but hopefully they have
352 been automatically generated since!
353Manuals User KUBERNETES(1)(kubernetes)