1KUBERNETES(1)                      Jan 2015                      KUBERNETES(1)
2
3
4

NAME

6       kubectl rollout status - Show the status of the rollout
7
8
9

SYNOPSIS

11       kubectl rollout status [OPTIONS]
12
13
14

DESCRIPTION

16       Show the status of the rollout.
17
18
19       By default 'rollout status' will watch the status of the latest rollout
20       until it's done. If you don't want to wait for the rollout to finish
21       then you can use --watch=false. Note that if a new rollout starts
22       in-between, then 'rollout status' will continue watching the latest
23       revision. If you want to pin to a specific revision and abort if it is
24       rolled over by another revision, use --revision=N where N is the
25       revision you need to watch for.
26
27
28

OPTIONS

30       -f, --filename=[]
31           Filename, directory, or URL to files identifying the resource to
32       get from a server.
33
34
35       -k, --kustomize=""
36           Process the kustomization directory. This flag can't be used
37       together with -f or -R.
38
39
40       -R, --recursive=false
41           Process the directory used in -f, --filename recursively. Useful
42       when you want to manage related manifests organized within the same
43       directory.
44
45
46       --revision=0
47           Pin to a specific revision for showing its status. Defaults to 0
48       (last revision).
49
50
51       --timeout=0s
52           The length of time to wait before ending watch, zero means never.
53       Any other values should contain a corresponding time unit (e.g. 1s, 2m,
54       3h).
55
56
57       -w, --watch=true
58           Watch the status of the rollout until it's done.
59
60
61

OPTIONS INHERITED FROM PARENT COMMANDS

63       --add-dir-header=false
64           If true, adds the file directory to the header
65
66
67       --alsologtostderr=false
68           log to standard error as well as files
69
70
71       --application-metrics-count-limit=100
72           Max number of application metrics to store (per container)
73
74
75       --as=""
76           Username to impersonate for the operation
77
78
79       --as-group=[]
80           Group to impersonate for the operation, this flag can be repeated
81       to specify multiple groups.
82
83
84       --azure-container-registry-config=""
85           Path to the file containing Azure container registry configuration
86       information.
87
88
89       --boot-id-file="/proc/sys/kernel/random/boot_id"
90           Comma-separated list of files to check for boot-id. Use the first
91       one that exists.
92
93
94       --cache-dir="/builddir/.kube/http-cache"
95           Default HTTP cache directory
96
97
98       --certificate-authority=""
99           Path to a cert file for the certificate authority
100
101
102       --client-certificate=""
103           Path to a client certificate file for TLS
104
105
106       --client-key=""
107           Path to a client key file for TLS
108
109
110       --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
111           CIDRs opened in GCE firewall for L7 LB traffic proxy  health checks
112
113
114       --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
115           CIDRs opened in GCE firewall for L4 LB traffic proxy  health checks
116
117
118       --cluster=""
119           The name of the kubeconfig cluster to use
120
121
122       --container-hints="/etc/cadvisor/container_hints.json"
123           location of the container hints file
124
125
126       --containerd="/run/containerd/containerd.sock"
127           containerd endpoint
128
129
130       --containerd-namespace="k8s.io"
131           containerd namespace
132
133
134       --context=""
135           The name of the kubeconfig context to use
136
137
138       --default-not-ready-toleration-seconds=300
139           Indicates the tolerationSeconds of the toleration for
140       notReady:NoExecute that is added by default to every pod that does not
141       already have such a toleration.
142
143
144       --default-unreachable-toleration-seconds=300
145           Indicates the tolerationSeconds of the toleration for
146       unreachable:NoExecute that is added by default to every pod that does
147       not already have such a toleration.
148
149
150       --disable-root-cgroup-stats=false
151           Disable collecting root Cgroup stats
152
153
154       --docker="unix:///var/run/docker.sock"
155           docker endpoint
156
157
158       --docker-env-metadata-whitelist=""
159           a comma-separated list of environment variable keys that needs to
160       be collected for docker containers
161
162
163       --docker-only=false
164           Only report docker containers in addition to root stats
165
166
167       --docker-root="/var/lib/docker"
168           DEPRECATED: docker root is read from docker info (this is a
169       fallback, default: /var/lib/docker)
170
171
172       --docker-tls=false
173           use TLS to connect to docker
174
175
176       --docker-tls-ca="ca.pem"
177           path to trusted CA
178
179
180       --docker-tls-cert="cert.pem"
181           path to client certificate
182
183
184       --docker-tls-key="key.pem"
185           path to private key
186
187
188       --enable-load-reader=false
189           Whether to enable cpu load reader
190
191
192       --event-storage-age-limit="default=0"
193           Max length of time for which to store events (per type). Value is a
194       comma separated list of key values, where the keys are event types
195       (e.g.: creation, oom) or "default" and the value is a duration. Default
196       is applied to all non-specified event types
197
198
199       --event-storage-event-limit="default=0"
200           Max number of events to store (per type). Value is a comma
201       separated list of key values, where the keys are event types (e.g.:
202       creation, oom) or "default" and the value is an integer. Default is
203       applied to all non-specified event types
204
205
206       --global-housekeeping-interval=1m0s
207           Interval between global housekeepings
208
209
210       --housekeeping-interval=10s
211           Interval between container housekeepings
212
213
214       --insecure-skip-tls-verify=false
215           If true, the server's certificate will not be checked for validity.
216       This will make your HTTPS connections insecure
217
218
219       --kubeconfig=""
220           Path to the kubeconfig file to use for CLI requests.
221
222
223       --log-backtrace-at=:0
224           when logging hits line file:N, emit a stack trace
225
226
227       --log-cadvisor-usage=false
228           Whether to log the usage of the cAdvisor container
229
230
231       --log-dir=""
232           If non-empty, write log files in this directory
233
234
235       --log-file=""
236           If non-empty, use this log file
237
238
239       --log-file-max-size=1800
240           Defines the maximum size a log file can grow to. Unit is megabytes.
241       If the value is 0, the maximum file size is unlimited.
242
243
244       --log-flush-frequency=5s
245           Maximum number of seconds between log flushes
246
247
248       --logtostderr=true
249           log to standard error instead of files
250
251
252       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
253           Comma-separated list of files to check for machine-id. Use the
254       first one that exists.
255
256
257       --match-server-version=false
258           Require server version to match client version
259
260
261       -n, --namespace=""
262           If present, the namespace scope for this CLI request
263
264
265       --password=""
266           Password for basic authentication to the API server
267
268
269       --profile="none"
270           Name of profile to capture. One of
271       (none|cpu|heap|goroutine|threadcreate|block|mutex)
272
273
274       --profile-output="profile.pprof"
275           Name of the file to write the profile to
276
277
278       --request-timeout="0"
279           The length of time to wait before giving up on a single server
280       request. Non-zero values should contain a corresponding time unit (e.g.
281       1s, 2m, 3h). A value of zero means don't timeout requests.
282
283
284       -s, --server=""
285           The address and port of the Kubernetes API server
286
287
288       --skip-headers=false
289           If true, avoid header prefixes in the log messages
290
291
292       --skip-log-headers=false
293           If true, avoid headers when opening log files
294
295
296       --stderrthreshold=2
297           logs at or above this threshold go to stderr
298
299
300       --storage-driver-buffer-duration=1m0s
301           Writes in the storage driver will be buffered for this duration,
302       and committed to the non memory backends as a single transaction
303
304
305       --storage-driver-db="cadvisor"
306           database name
307
308
309       --storage-driver-host="localhost:8086"
310           database host:port
311
312
313       --storage-driver-password="root"
314           database password
315
316
317       --storage-driver-secure=false
318           use secure connection with database
319
320
321       --storage-driver-table="stats"
322           table name
323
324
325       --storage-driver-user="root"
326           database username
327
328
329       --tls-server-name=""
330           Server name to use for server certificate validation. If it is not
331       provided, the hostname used to contact the server is used
332
333
334       --token=""
335           Bearer token for authentication to the API server
336
337
338       --update-machine-info-interval=5m0s
339           Interval between machine info updates.
340
341
342       --user=""
343           The name of the kubeconfig user to use
344
345
346       --username=""
347           Username for basic authentication to the API server
348
349
350       -v, --v=0
351           number for the log level verbosity
352
353
354       --version=false
355           Print version information and quit
356
357
358       --vmodule=
359           comma-separated list of pattern=N settings for file-filtered
360       logging
361
362
363

EXAMPLE

365                # Watch the rollout status of a deployment
366                kubectl rollout status deployment/nginx
367
368
369
370

SEE ALSO

372       kubectl-rollout(1),
373
374
375

HISTORY

377       January 2015, Originally compiled by Eric Paris (eparis at redhat dot
378       com) based on the kubernetes source material, but hopefully they have
379       been automatically generated since!
380
381
382
383Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum