1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl create ingress - Create an ingress with the specified name.
10
14 kubectl create ingress [OPTIONS]
15
19 Create an ingress with the specified name.
20
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 --annotation=[] Annotation to insert in the ingress object, in the
30 format annotation=value
31 --class="" Ingress Class to be used
34 --default-backend="" Default service for backend, in format of
37 svcname:port
38 --dry-run="none" Must be "none", "server", or "client". If client
41 strategy, only print the object that would be sent, without sending it.
42 If server strategy, submit server-side request without persisting the
43 resource.
44 --field-manager="kubectl-create" Name of the manager used to track
47 field ownership.
48 -o, --output="" Output format. One of: json|yaml|name|go-tem‐
51 plate|go-template-file|template|templatefile|jsonpath|json‐
52 path-as-json|jsonpath-file.
53 --rule=[] Rule in format host/path=service:port[,tls=secretname].
56 Paths containing the leading character '*' are considered pathType=Pre‐
57 fix. tls argument is optional.
58 --save-config=false If true, the configuration of current object
61 will be saved in its annotation. Otherwise, the annotation will be un‐
62 changed. This flag is useful when you want to perform kubectl apply on
63 this object in the future.
64 --show-managed-fields=false If true, keep the managedFields when
67 printing objects in JSON or YAML format.
68 --template="" Template string or path to template file to use when
71 -o=go-template, -o=go-template-file. The template format is golang tem‐
72 plates [http://golang.org/pkg/text/template/#pkg-overview].
73 --validate=true If true, use a schema to validate the input before
76 sending it
77
81 --add-dir-header=false If true, adds the file directory to the
82 header of the log messages
83 --alsologtostderr=false log to standard error as well as files
86 --application-metrics-count-limit=100 Max number of application
89 metrics to store (per container)
90 --as="" Username to impersonate for the operation
93 --as-group=[] Group to impersonate for the operation, this flag
96 can be repeated to specify multiple groups.
97 --azure-container-registry-config="" Path to the file containing
100 Azure container registry configuration information.
101 --boot-id-file="/proc/sys/kernel/random/boot_id" Comma-separated
104 list of files to check for boot-id. Use the first one that exists.
105 --cache-dir="/builddir/.kube/cache" Default cache directory
108 --certificate-authority="" Path to a cert file for the certificate
111 authority
112 --client-certificate="" Path to a client certificate file for TLS
115 --client-key="" Path to a client key file for TLS
118 --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
121 CIDRs opened in GCE firewall for L7 LB traffic proxy health
122 checks
123 --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
126 CIDRs opened in GCE firewall for L4 LB traffic proxy health
127 checks
128 --cluster="" The name of the kubeconfig cluster to use
131 --container-hints="/etc/cadvisor/container_hints.json" location of
134 the container hints file
135 --containerd="/run/containerd/containerd.sock" containerd endpoint
138 --containerd-namespace="k8s.io" containerd namespace
141 --context="" The name of the kubeconfig context to use
144 --default-not-ready-toleration-seconds=300 Indicates the tolera‐
147 tionSeconds of the toleration for notReady:NoExecute that is added by
148 default to every pod that does not already have such a toleration.
149 --default-unreachable-toleration-seconds=300 Indicates the tolera‐
152 tionSeconds of the toleration for unreachable:NoExecute that is added
153 by default to every pod that does not already have such a toleration.
154 --disable-root-cgroup-stats=false Disable collecting root Cgroup
157 stats
158 --docker="unix:///var/run/docker.sock" docker endpoint
161 --docker-env-metadata-whitelist="" a comma-separated list of envi‐
164 ronment variable keys matched with specified prefix that needs to be
165 collected for docker containers
166 --docker-only=false Only report docker containers in addition to
169 root stats
170 --docker-root="/var/lib/docker" DEPRECATED: docker root is read
173 from docker info (this is a fallback, default: /var/lib/docker)
174 --docker-tls=false use TLS to connect to docker
177 --docker-tls-ca="ca.pem" path to trusted CA
180 --docker-tls-cert="cert.pem" path to client certificate
183 --docker-tls-key="key.pem" path to private key
186 --enable-load-reader=false Whether to enable cpu load reader
189 --event-storage-age-limit="default=0" Max length of time for which
192 to store events (per type). Value is a comma separated list of key val‐
193 ues, where the keys are event types (e.g.: creation, oom) or "default"
194 and the value is a duration. Default is applied to all non-specified
195 event types
196 --event-storage-event-limit="default=0" Max number of events to
199 store (per type). Value is a comma separated list of key values, where
200 the keys are event types (e.g.: creation, oom) or "default" and the
201 value is an integer. Default is applied to all non-specified event
202 types
203 --global-housekeeping-interval=1m0s Interval between global house‐
206 keepings
207 --housekeeping-interval=10s Interval between container housekeep‐
210 ings
211 --insecure-skip-tls-verify=false If true, the server's certificate
214 will not be checked for validity. This will make your HTTPS connections
215 insecure
216 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
219 quests.
220 --log-backtrace-at=:0 when logging hits line file:N, emit a stack
223 trace
224 --log-cadvisor-usage=false Whether to log the usage of the cAdvi‐
227 sor container
228 --log-dir="" If non-empty, write log files in this directory
231 --log-file="" If non-empty, use this log file
234 --log-file-max-size=1800 Defines the maximum size a log file can
237 grow to. Unit is megabytes. If the value is 0, the maximum file size is
238 unlimited.
239 --log-flush-frequency=5s Maximum number of seconds between log
242 flushes
243 --logtostderr=true log to standard error instead of files
246 --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
249 Comma-separated list of files to check for machine-id. Use the
250 first one that exists.
251 --match-server-version=false Require server version to match
254 client version
255 -n, --namespace="" If present, the namespace scope for this CLI
258 request
259 --one-output=false If true, only write logs to their native sever‐
262 ity level (vs also writing to each lower severity level)
263 --password="" Password for basic authentication to the API server
266 --profile="none" Name of profile to capture. One of
269 (none|cpu|heap|goroutine|threadcreate|block|mutex)
270 --profile-output="profile.pprof" Name of the file to write the
273 profile to
274 --referenced-reset-interval=0 Reset interval for referenced bytes
277 (container_referenced_bytes metric), number of measurement cycles after
278 which referenced bytes are cleared, if set to 0 referenced bytes are
279 never cleared (default: 0)
280 --request-timeout="0" The length of time to wait before giving up
283 on a single server request. Non-zero values should contain a corre‐
284 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
285 out requests.
286 -s, --server="" The address and port of the Kubernetes API server
289 --skip-headers=false If true, avoid header prefixes in the log
292 messages
293 --skip-log-headers=false If true, avoid headers when opening log
296 files
297 --stderrthreshold=2 logs at or above this threshold go to stderr
300 --storage-driver-buffer-duration=1m0s Writes in the storage driver
303 will be buffered for this duration, and committed to the non memory
304 backends as a single transaction
305 --storage-driver-db="cadvisor" database name
308 --storage-driver-host="localhost:8086" database host:port
311 --storage-driver-password="root" database password
314 --storage-driver-secure=false use secure connection with database
317 --storage-driver-table="stats" table name
320 --storage-driver-user="root" database username
323 --tls-server-name="" Server name to use for server certificate
326 validation. If it is not provided, the hostname used to contact the
327 server is used
328 --token="" Bearer token for authentication to the API server
331 --update-machine-info-interval=5m0s Interval between machine info
334 updates.
335 --user="" The name of the kubeconfig user to use
338 --username="" Username for basic authentication to the API server
341 -v, --v=0 number for the log level verbosity
344 --version=false Print version information and quit
347 --vmodule= comma-separated list of pattern=N settings for
350 file-filtered logging
351 --warnings-as-errors=false Treat warnings received from the server
354 as errors and exit with a non-zero exit code
355
359 # Create a single ingress called 'simple' that directs requests to foo.com/bar to svc
360 # svc1:8080 with a tls secret "my-cert"
361 kubectl create ingress simple --rule="foo.com/bar=svc1:8080,tls=my-cert"
362 # Create a catch all ingress of "/path" pointing to service svc:port and Ingress Class as "otheringress"
364 kubectl create ingress catch-all --class=otheringress --rule="/path=svc:port"
365 # Create an ingress with two annotations: ingress.annotation1 and ingress.annotations2
367 kubectl create ingress annotated --class=default --rule="foo.com/bar=svc:port" \
368 --annotation ingress.annotation1=foo \
369 --annotation ingress.annotation2=bla
370 # Create an ingress with the same host and multiple paths
372 kubectl create ingress multipath --class=default \
373 --rule="foo.com/=svc:port" \
374 --rule="foo.com/admin/=svcadmin:portadmin"
375 # Create an ingress with multiple hosts and the pathType as Prefix
377 kubectl create ingress ingress1 --class=default \
378 --rule="foo.com/path*=svc:8080" \
379 --rule="bar.com/admin*=svc2:http"
380 # Create an ingress with TLS enabled using the default ingress certificate and different path types
382 kubectl create ingress ingtls --class=default \
383 --rule="foo.com/=svc:https,tls" \
384 --rule="foo.com/path/subpath*=othersvc:8080"
385 # Create an ingress with TLS enabled using a specific secret and pathType as Prefix
387 kubectl create ingress ingsecret --class=default \
388 --rule="foo.com/*=svc:8080,tls=secret1"
389 # Create an ingress with a default backend
391 kubectl create ingress ingdefault --class=default \
392 --default-backend=defaultsvc:http \
393 --rule="foo.com/*=svc:8080,tls=secret1"
394
399 kubectl-create(1),
400
404 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
405 com) based on the kubernetes source material, but hopefully they have
406 been automatically generated since!
407Manuals User KUBERNETES(1)(kubernetes)