1KUBERNETES(1)(kubernetes)                            KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7

NAME

9       kubectl rollout - Manage the rollout of a resource
10
11
12

SYNOPSIS

14       kubectl rollout [OPTIONS]
15
16
17

DESCRIPTION

19       Manage the rollout of a resource.
20
21
22       Valid resource types include:
23
24
25              • deployments
26
27              • daemonsets
28
29              • statefulsets
30
31
32
33

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

313                # Rollback to the previous deployment
314                kubectl rollout undo deployment/abc
315
316                # Check the rollout status of a daemonset
317                kubectl rollout status daemonset/foo
318
319
320
321

SEE ALSO

323       kubectl(1),    kubectl-rollout-history(1),    kubectl-rollout-pause(1),
324       kubectl-rollout-restart(1),  kubectl-rollout-resume(1),   kubectl-roll‐
325       out-status(1), kubectl-rollout-undo(1),
326
327
328

HISTORY

330       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
331       com) based on the kubernetes source material, but hopefully  they  have
332       been automatically generated since!
333
334
335
336Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum