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

NAME

9       kubectl create cronjob - Create a cronjob with the specified name.
10
11
12

SYNOPSIS

14       kubectl create cronjob [OPTIONS]
15
16
17

DESCRIPTION

19       Create a cronjob with the specified name.
20
21
22

OPTIONS

24       --allow-missing-template-keys=true       If  true, ignore any errors in
25       templates when a field or map key is missing in the template. Only  ap‐
26       plies to golang and jsonpath output formats.
27
28
29       --dry-run="none"       Must be "none", "server", or "client". If client
30       strategy, only print the object that would be sent, without sending it.
31       If  server  strategy, submit server-side request without persisting the
32       resource.
33
34
35       --field-manager="kubectl-create"      Name of the manager used to track
36       field ownership.
37
38
39       --image=""      Image name to run.
40
41
42       -o,  --output=""       Output  format.  One  of: json|yaml|name|go-tem‐
43       plate|go-template-file|template|templatefile|jsonpath|json‐
44       path-as-json|jsonpath-file.
45
46
47       --restart=""       job's  restart  policy. supported values: OnFailure,
48       Never
49
50
51       --save-config=false      If true, the configuration of  current  object
52       will  be saved in its annotation. Otherwise, the annotation will be un‐
53       changed. This flag is useful when you want to perform kubectl apply  on
54       this object in the future.
55
56
57       --schedule=""       A schedule in the Cron format the job should be run
58       with.
59
60
61       --show-managed-fields=false      If true, keep the  managedFields  when
62       printing objects in JSON or YAML format.
63
64
65       --template=""      Template string or path to template file to use when
66       -o=go-template, -o=go-template-file. The template format is golang tem‐
67       plates [http://golang.org/pkg/text/template/#pkg-overview].
68
69
70       --validate=true      If true, use a schema to validate the input before
71       sending it
72
73
74

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

354                # Create a cronjob
355                kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *"
356
357                # Create a cronjob with command
358                kubectl create cronjob my-job --image=busybox --schedule="*/1 * * * *" -- date
359
360
361
362

SEE ALSO

364       kubectl-create(1),
365
366
367

HISTORY

369       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
370       com)  based  on the kubernetes source material, but hopefully they have
371       been automatically generated since!
372
373
374
375Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum