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

NAME

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

SYNOPSIS

14       kubectl create namespace [OPTIONS]
15
16
17

DESCRIPTION

19       Create a namespace 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       -o,  --output=""       Output  format.  One  of: json|yaml|name|go-tem‐
40       plate|go-template-file|template|templatefile|jsonpath|json‐
41       path-as-json|jsonpath-file.
42
43
44       --save-config=false       If  true, the configuration of current object
45       will be saved in its annotation. Otherwise, the annotation will be  un‐
46       changed.  This flag is useful when you want to perform kubectl apply on
47       this object in the future.
48
49
50       --show-managed-fields=false      If true, keep the  managedFields  when
51       printing objects in JSON or YAML format.
52
53
54       --template=""      Template string or path to template file to use when
55       -o=go-template, -o=go-template-file. The template format is golang tem‐
56       plates [http://golang.org/pkg/text/template/#pkg-overview].
57
58
59       --validate=true      If true, use a schema to validate the input before
60       sending it
61
62
63

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

343                # Create a new namespace named my-namespace
344                kubectl create namespace my-namespace
345
346
347
348

SEE ALSO

350       kubectl-create(1),
351
352
353

HISTORY

355       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
356       com)  based  on the kubernetes source material, but hopefully they have
357       been automatically generated since!
358
359
360
361Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum