From dd1dcd670b4c95650569d3ef772b0fa74b7d8997 Mon Sep 17 00:00:00 2001 From: Karen Bradshaw Date: Sat, 4 May 2019 21:29:37 -0400 Subject: [PATCH] update kubectl ref docs (#14018) Testing kubectl reference generation. See issue #13961. --- .../generated/kubectl/kubectl-commands.html | 997 ++++++++++++------ .../reference/generated/kubectl/navData.js | 2 +- 2 files changed, 697 insertions(+), 302 deletions(-) diff --git a/static/docs/reference/generated/kubectl/kubectl-commands.html b/static/docs/reference/generated/kubectl/kubectl-commands.html index f9d567526d..b990856905 100644 --- a/static/docs/reference/generated/kubectl/kubectl-commands.html +++ b/static/docs/reference/generated/kubectl/kubectl-commands.html @@ -11,7 +11,7 @@ - +
  • example

GETTING STARTED

@@ -41,8 +41,8 @@ inspect them.

kubectl create -f docker-registry.yaml --edit -o json
-

Create a resource from a file or from stdin.

-

JSON and YAML formats are accepted.

+

Create a resource from a file or from stdin.

+

JSON and YAML formats are accepted.

Usage

$ create -f FILENAME

Flags

@@ -81,6 +81,12 @@ inspect them.

Filename, directory, or URL to files to use to create the resource +kustomize +k + +Process the kustomization directory. This flag can't be used together with -f or -R. + + output o @@ -120,7 +126,7 @@ inspect them.

template -Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. +Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. validate @@ -234,7 +240,7 @@ inspect them.

template -Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. +Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. validate @@ -323,7 +329,7 @@ inspect them.

template -Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. +Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. validate @@ -360,10 +366,10 @@ inspect them.

kubectl create configmap my-config --from-env-file=path/to/bar.env
-

Create a configmap based on a file, directory, or specified literal value.

-

A single configmap may package one or more key/value pairs.

-

When creating a configmap based on a file, the key will default to the basename of the file, and the value will default to the file content. If the basename is an invalid key, you may specify an alternate key.

-

When creating a configmap based on a directory, each file whose basename is a valid key in the directory will be packaged into the configmap. Any directory entries except regular files are ignored (e.g. subdirectories, symlinks, devices, pipes, etc).

+

Create a configmap based on a file, directory, or specified literal value.

+

A single configmap may package one or more key/value pairs.

+

When creating a configmap based on a file, the key will default to the basename of the file, and the value will default to the file content. If the basename is an invalid key, you may specify an alternate key.

+

When creating a configmap based on a directory, each file whose basename is a valid key in the directory will be packaged into the configmap. Any directory entries except regular files are ignored (e.g. subdirectories, symlinks, devices, pipes, etc).

Usage

$ configmap NAME [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run]

Flags

@@ -435,7 +441,94 @@ inspect them.

template -Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. +Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. + + +validate + +true +If true, use a schema to validate the input before sending it + + + +
+

cronjob

+
+

Create a cronjob

+
+
kubectl create cronjob my-job --image=busybox
+
+
+

Create a cronjob with command

+
+
kubectl create cronjob my-job --image=busybox -- date
+
+
+

Create a cronjob with schedule

+
+
kubectl create cronjob test-job --image=busybox --schedule="*/1 * * * *"
+
+

Create a cronjob with the specified name.

+

Usage

+

$ cronjob NAME --image=image --schedule='0/5 * * * ?' -- [COMMAND] [args...]

+

Flags

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -506,7 +599,7 @@ inspect them.

- + @@ -535,7 +628,7 @@ inspect them.

Create a job with the specified name.

Usage

-

$ job NAME [--image=image --from=cronjob/name] -- [COMMAND] [args...]

+

$ job NAME --image=image [--from=cronjob/name] -- [COMMAND] [args...]

Flags

NameShorthandDefaultUsage
allow-missing-template-keystrueIf true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
dry-runfalseIf true, only print the object that would be sent, without sending it.
imageImage name to run.
outputoOutput format. One of: json|yaml|name|go-template|go-template-file|template|templatefile|jsonpath|jsonpath-file.
restartjob's restart policy. supported values: OnFailure, Never
save-configfalseIf true, the configuration of current object will be saved in its annotation. Otherwise, the annotation will be unchanged. This flag is useful when you want to perform kubectl apply on this object in the future.
scheduleA schedule in the Cron format the job should be run with.
templateTemplate string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate
@@ -587,7 +680,7 @@ inspect them.

- + @@ -652,7 +745,7 @@ inspect them.

- + @@ -740,7 +833,7 @@ inspect them.

- + @@ -822,7 +915,7 @@ inspect them.

- + @@ -910,7 +1003,7 @@ inspect them.

- + @@ -996,7 +1089,7 @@ inspect them.

- + @@ -1091,7 +1184,7 @@ inspect them.

- + @@ -1117,7 +1210,7 @@ inspect them.

Dockercfg secrets are used to authenticate against Docker registries.

When using the Docker command line to push images, you can authenticate to a given registry by running: '$ docker login DOCKER_REGISTRY_SERVER --username=DOCKER_USER --password=DOCKER_PASSWORD --email=DOCKER_EMAIL'.

-

That produces a ~/.dockercfg file that is used by subsequent 'docker push' and 'docker pull' commands to authenticate to the registry. The email address is optional.

+

That produces a ~/.dockercfg file that is used by subsequent 'docker push' and 'docker pull' commands to authenticate to the registry. The email address is optional.

When creating applications, you may have a Docker registry that requires authentication. In order for the nodes to pull images on your behalf, they have to have the credentials. You can provide this information by creating a dockercfg secret and attaching it to your service account.

@@ -1204,7 +1297,7 @@ inspect them.

- + @@ -1241,10 +1334,10 @@ inspect them.

kubectl create secret generic my-secret --from-env-file=path/to/bar.env
-

Create a secret based on a file, directory, or specified literal value.

-

A single secret may package one or more key/value pairs.

-

When creating a secret based on a file, the key will default to the basename of the file, and the value will default to the file content. If the basename is an invalid key or you wish to chose your own, you may specify an alternate key.

-

When creating a secret based on a directory, each file whose basename is a valid key in the directory will be packaged into the secret. Any directory entries except regular files are ignored (e.g. subdirectories, symlinks, devices, pipes, etc).

+

Create a secret based on a file, directory, or specified literal value.

+

A single secret may package one or more key/value pairs.

+

When creating a secret based on a file, the key will default to the basename of the file, and the value will default to the file content. If the basename is an invalid key or you wish to chose your own, you may specify an alternate key.

+

When creating a secret based on a directory, each file whose basename is a valid key in the directory will be packaged into the secret. Any directory entries except regular files are ignored (e.g. subdirectories, symlinks, devices, pipes, etc).

Usage

$ generic NAME [--type=string] [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run]

Flags

@@ -1316,7 +1409,7 @@ inspect them.

- + @@ -1339,8 +1432,8 @@ inspect them.

kubectl create secret tls tls-secret --cert=path/to/tls.cert --key=path/to/tls.key
-

Create a TLS secret from the given public/private key pair.

-

The public/private key pair must exist before hand. The public key certificate must be .PEM encoded and match the given private key.

+

Create a TLS secret from the given public/private key pair.

+

The public/private key pair must exist before hand. The public key certificate must be .PEM encoded and match the given private key.

Usage

$ tls NAME --cert=path/to/cert/file --key=path/to/key/file [--dry-run]

Flags

@@ -1406,7 +1499,7 @@ inspect them.

- + @@ -1493,7 +1586,7 @@ inspect them.

- + @@ -1510,8 +1603,8 @@ inspect them.

kubectl create service externalname my-ns --external-name bar.com
-

Create an ExternalName service with the specified name.

-

ExternalName service references to an external DNS address instead of only pods, which will allow application authors to reference services that exist off platform, on other clusters, or locally.

+

Create an ExternalName service with the specified name.

+

ExternalName service references to an external DNS address instead of only pods, which will allow application authors to reference services that exist off platform, on other clusters, or locally.

Usage

$ externalname NAME --external-name external.name [--dry-run]

Flags

@@ -1571,7 +1664,7 @@ inspect them.

- + @@ -1642,7 +1735,7 @@ inspect them.

- + @@ -1719,7 +1812,7 @@ inspect them.

- + @@ -1784,7 +1877,7 @@ inspect them.

- + @@ -1827,11 +1920,21 @@ inspect them.

kubectl get -f pod.yaml -o json
+

List resources from a directory with kustomization.yaml - e.g. dir/kustomization.yaml.

+
+
kubectl get -k dir/
+
+

Return only the phase value of the specified pod.

kubectl get -o template pod/web-pod-13je7 --template={{.status.phase}}
+

List resource information in custom columns.

+
+
kubectl get pod test-pod -o custom-columns=CONTAINER:.spec.containers[0].name,IMAGE:.spec.containers[0].image
+
+

List all replication controllers and services together in ps output format.

kubectl get rc,services
@@ -1841,10 +1944,10 @@ inspect them.

 
 
kubectl get rc/web service/frontend pods/web-pod-13je7
 

-
Display one or many resources 

-
Prints a table of the most important information about the specified resources. You can filter the list using a label selector and the --selector flag. If the desired resource type is namespaced you will only see results in your current namespace unless you pass --all-namespaces. 

-
Uninitialized objects are not shown unless --include-uninitialized is passed. 

-
By specifying the output as 'template' and providing a Go template as the value of the --template flag, you can filter the attributes of the fetched resources.

+
Display one or many resources

+
 Prints a table of the most important information about the specified resources. You can filter the list using a label selector and the --selector flag. If the desired resource type is namespaced you will only see results in your current namespace unless you pass --all-namespaces.

+
 Uninitialized objects are not shown unless --include-uninitialized is passed.

+
 By specifying the output as 'template' and providing a Go template as the value of the --template flag, you can filter the attributes of the fetched resources.

 
Use "kubectl api-resources" for a complete list of supported resources.

 
Usage

 
$ get [(-o|--output=)json|yaml|wide|custom-columns=...|custom-columns-file=...|go-template=...|go-template-file=...|jsonpath=...|jsonpath-file=...] (TYPE[.VERSION][.GROUP] [NAME | -l label] | TYPE[.VERSION][.GROUP]/NAME ...) [flags]

@@ -1861,7 +1964,7 @@ inspect them.
- + @@ -1908,6 +2011,12 @@ inspect them.

 + + + + + + @@ -1923,7 +2032,7 @@ inspect them.

 - + @@ -1950,12 +2059,6 @@ inspect them.

 - - - - - - @@ -1977,7 +2080,7 @@ inspect them.

 - + @@ -2061,8 +2164,8 @@ inspect them.

kubectl run pi --schedule="0/5 * * * ?" --image=perl --restart=OnFailure -- perl -Mbignum=bpi -wle 'print bpi(2000)'
-

Create and run a particular image, possibly replicated.

-

Creates a deployment or job to manage the created container(s).

+

Create and run a particular image, possibly replicated.

+

Creates a deployment or job to manage the created container(s).

Usage

$ run NAME --image=image [--env="key=value"] [--port=port] [--replicas=replicas] [--dry-run=bool] [--overrides=inline-json] [--command] -- [COMMAND] [args...]

Flags

@@ -2161,6 +2264,12 @@ inspect them.

 + + + + + + @@ -2284,7 +2393,7 @@ inspect them.

 - + @@ -2331,7 +2440,7 @@ inspect them.

Create a service for a replicated streaming application on port 4100 balancing UDP traffic and named 'video-stream'.

-
kubectl expose rc streamer --port=4100 --protocol=udp --name=video-stream
+
kubectl expose rc streamer --port=4100 --protocol=UDP --name=video-stream
 

 

 
 Create a service for a replicated nginx using replica set, which serves on port 80 and connects to the containers on port 8000.

@@ -2343,10 +2452,10 @@ inspect them.

 

 
kubectl expose deployment nginx --port=80 --target-port=8000
 

-
Expose a resource as a new Kubernetes service. 

-
Looks up a deployment, service, replica set, replication controller or pod by name and uses the selector for that resource as the selector for a new service on the specified port. A deployment or replica set will be exposed as a service only if its selector is convertible to a selector that service supports, i.e. when the selector contains only the matchLabels component. Note that if no port is specified via --port and the exposed resource has multiple ports, all will be re-used by the new service. Also if no labels are specified, the new service will re-use the labels from the resource it exposes. 

-
Possible resources include (case insensitive): 

-
pod (po), service (svc), replicationcontroller (rc), deployment (deploy), replicaset (rs)

+
Expose a resource as a new Kubernetes service.

+
 Looks up a deployment, service, replica set, replication controller or pod by name and uses the selector for that resource as the selector for a new service on the specified port. A deployment or replica set will be exposed as a service only if its selector is convertible to a selector that service supports, i.e. when the selector contains only the matchLabels component. Note that if no port is specified via --port and the exposed resource has multiple ports, all will be re-used by the new service. Also if no labels are specified, the new service will re-use the labels from the resource it exposes.

+
 Possible resources include (case insensitive):

+
 pod (po), service (svc), replicationcontroller (rc), deployment (deploy), replicaset (rs)

 
Usage

 
$ expose (-f FILENAME | TYPE NAME) [--port=port] [--protocol=TCP|UDP|SCTP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type]

 
Flags

@@ -2403,6 +2512,12 @@ inspect them.
+ + + + + + @@ -2484,7 +2599,7 @@ inspect them.

 - + @@ -2502,6 +2617,11 @@ inspect them.

kubectl delete -f ./pod.json
+

Delete resources from a directory containing kustomization.yaml - e.g. dir/kustomization.yaml.

+
+
kubectl delete -k dir
+
+

Delete a pod based on the type and name in the JSON passed into stdin.

cat pod.json | kubectl delete -f -
@@ -2531,13 +2651,13 @@ inspect them.

 
 
kubectl delete pods --all
 

-
Delete resources by filenames, stdin, resources and names, or by resources and label selector. 

-
JSON and YAML formats are accepted. Only one type of the arguments may be specified: filenames, resources and names, or resources and label selector. 

-
Some resources, such as pods, support graceful deletion. These resources define a default period before they are forcibly terminated (the grace period) but you may override that value with the --grace-period flag, or pass --now to set a grace-period of 1. Because these resources often represent entities in the cluster, deletion may not be acknowledged immediately. If the node hosting a pod is down or cannot reach the API server, termination may take significantly longer than the grace period. To force delete a resource, you must pass a grace period of 0 and specify the --force flag. 

-
IMPORTANT: Force deleting pods does not wait for confirmation that the pod's processes have been terminated, which can leave those processes running until the node detects the deletion and completes graceful deletion. If your processes use shared storage or talk to a remote API and depend on the name of the pod to identify themselves, force deleting those pods may result in multiple processes running on different machines using the same identification which may lead to data corruption or inconsistency. Only force delete pods when you are sure the pod is terminated, or if your application can tolerate multiple copies of the same pod running at once. Also, if you force delete pods the scheduler may place new pods on those nodes before the node has released those resources and causing those pods to be evicted immediately. 

-
Note that the delete command does NOT do resource version checks, so if someone submits an update to a resource right when you submit a delete, their update will be lost along with the rest of the resource.

+
Delete resources by filenames, stdin, resources and names, or by resources and label selector.

+
 JSON and YAML formats are accepted. Only one type of the arguments may be specified: filenames, resources and names, or resources and label selector.

+
 Some resources, such as pods, support graceful deletion. These resources define a default period before they are forcibly terminated (the grace period) but you may override that value with the --grace-period flag, or pass --now to set a grace-period of 1. Because these resources often represent entities in the cluster, deletion may not be acknowledged immediately. If the node hosting a pod is down or cannot reach the API server, termination may take significantly longer than the grace period. To force delete a resource, you must pass a grace period of 0 and specify the --force flag.

+
 IMPORTANT: Force deleting pods does not wait for confirmation that the pod's processes have been terminated, which can leave those processes running until the node detects the deletion and completes graceful deletion. If your processes use shared storage or talk to a remote API and depend on the name of the pod to identify themselves, force deleting those pods may result in multiple processes running on different machines using the same identification which may lead to data corruption or inconsistency. Only force delete pods when you are sure the pod is terminated, or if your application can tolerate multiple copies of the same pod running at once. Also, if you force delete pods the scheduler may place new pods on those nodes before the node has released those resources and causing those pods to be evicted immediately.

+
 Note that the delete command does NOT do resource version checks, so if someone submits an update to a resource right when you submit a delete, their update will be lost along with the rest of the resource.

 
Usage

-
$ delete ([-f FILENAME] | TYPE [(NAME | -l label | --all)])

+
$ delete ([-f FILENAME] | [-k DIRECTORY] | TYPE [(NAME | -l label | --all)])

 
Flags
template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
type template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
validate
all-namespacesA false If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace.
If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized.
kustomizekProcess the kustomization directory. This flag can't be used together with -f or -R.
label-columns L []output o Output format. One of: json|yaml|wide|name|custom-columns=...|custom-columns-file=...|go-template=...|go-template-file=...|jsonpath=...|jsonpath-file=... See custom columns [http://kubernetes.io/docs/user-guide/kubectl-overview/#custom-columns, golang template [http://golang.org/pkg/text/template/#pkg-overview] and jsonpath template [http://kubernetes.io/docs/user-guide/jsonpath]. Output format. One of: json|yaml|wide|name|custom-columns=...|custom-columns-file=...|go-template=...|go-template-file=...|jsonpath=...|jsonpath-file=... See custom columns [http://kubernetes.io/docs/user-guide/kubectl-overview/#custom-columns], golang template [http://golang.org/pkg/text/template/#pkg-overview] and jsonpath template [http://kubernetes.io/docs/user-guide/jsonpath].
rawIf true, have the server return the appropriate table output. Supports extension APIs and CRDs.
show-allatrueWhen printing, show all resources (default show all pods including terminated one.)
show-kind falsetemplate Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
use-openapi-print-columnsThe image pull policy for the container. If left empty, this value will not be specified by the client and defaulted by the server
kustomizekProcess a kustomization directory. This flag can't be used together with -f or -R.
labels l template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
timeoutThe name of the API generator to use. There are 2 generators: 'service/v1' and 'service/v2'. The only difference between them is that service port in v1 is named 'default', while it is left unnamed in v2. Default is 'service/v2'.
kustomizekProcess the kustomization directory. This flag can't be used together with -f or -R.
labels l template Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview].
type
@@ -2556,6 +2676,12 @@ inspect them.

 + + + + + + @@ -2598,6 +2724,12 @@ inspect them.

 + + + + + + @@ -2635,48 +2767,6 @@ inspect them.

Delete all resources, including uninitialized ones, in the namespace of the specified resource types.
all-namespacesAfalseIf present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace.
cascade trueIf true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized.
kustomizekProcess a kustomization directory. This flag can't be used together with -f or -R.
now false
-
-

diff

-
-

Diff resources included in pod.json.

-
-
kubectl diff -f pod.json
-
-
-

Diff file read from stdin

-
-
cat service.yaml | kubectl diff -f -
-
-

Diff configurations specified by filename or stdin between the current online configuration, and the configuration as it would be if applied.

-

Output is always YAML.

-

KUBECTL EXTERNAL DIFF environment variable can be used to select your own diff command. By default, the "diff" command available in your path will be run with "-u" (unicode) and "-N" (treat new files as empty) options.

-

Usage

-

$ diff -f FILENAME

-

Flags

- - - - - - - - - - - - - - - - - - - - - - - -
NameShorthandDefaultUsage
filenamef[]Filename, directory, or URL to files contains the configuration to diff
recursiveRfalseProcess the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory.

APP MANAGEMENT

This section contains commands for creating, updating, deleting, and viewing your workloads in a Kubernetes cluster.

@@ -2688,6 +2778,11 @@ viewing your workloads in a Kubernetes cluster.

kubectl apply -f ./pod.json
+

Apply resources from a directory containing kustomization.yaml - e.g. dir/kustomization.yaml.

+
+
kubectl apply -k dir/
+
+

Apply the JSON passed into stdin to a pod.

cat pod.json | kubectl apply -f -
@@ -2702,11 +2797,11 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl apply --prune -f manifest.yaml --all --prune-whitelist=core/v1/ConfigMap
 

-
Apply a configuration to a resource by filename or stdin. The resource name must be specified. This resource will be created if it doesn't exist yet. To use 'apply', always create the resource initially with either 'apply' or 'create --save-config'. 

-
JSON and YAML formats are accepted. 

-
Alpha Disclaimer: the --prune functionality is not yet complete. Do not use unless you are aware of what the current state is. See https://issues.k8s.io/34274.

+
Apply a configuration to a resource by filename or stdin. The resource name must be specified. This resource will be created if it doesn't exist yet. To use 'apply', always create the resource initially with either 'apply' or 'create --save-config'.

+
 JSON and YAML formats are accepted.

+
 Alpha Disclaimer: the --prune functionality is not yet complete. Do not use unless you are aware of what the current state is. See https://issues.k8s.io/34274.

 
Usage

-
$ apply -f FILENAME

+
$ apply (-f FILENAME | -k DIRECTORY)

 
Flags

 
@@ -2740,7 +2835,25 @@ viewing your workloads in a Kubernetes cluster.

-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -2767,6 +2880,12 @@ viewing your workloads in a Kubernetes cluster.

+
+
+
+
+
+
@@ -2824,7 +2943,7 @@ viewing your workloads in a Kubernetes cluster.

-
+
@@ -2858,11 +2977,11 @@ viewing your workloads in a Kubernetes cluster.
kubectl apply edit-last-applied -f deploy.yaml -o json
 

-
Edit the latest last-applied-configuration annotations of resources from the default editor. 

-
The edit-last-applied command allows you to directly edit any API resource you can retrieve via the command line tools. It will open the editor defined by your KUBE _EDITOR, or EDITOR environment variables, or fall back to 'vi' for Linux or 'notepad' for Windows. You can edit multiple objects, although changes are applied one at a time. The command accepts filenames as well as command line arguments, although the files you point to must be previously saved versions of resources. 

-
The default format is YAML. To edit in JSON, specify "-o json". 

-
The flag --windows-line-endings can be used to force Windows line endings, otherwise the default for your operating system will be used. 

-
In the event an error occurs while updating, a temporary file will be created on disk that contains your unapplied changes. The most common error when updating a resource is another editor changing the resource on the server. When this occurs, you will have to apply your changes to the newer version of the resource, or update your temporary saved copy to include the latest resource version.

+
Edit the latest last-applied-configuration annotations of resources from the default editor.

+
 The edit-last-applied command allows you to directly edit any API resource you can retrieve via the command line tools. It will open the editor defined by your KUBE_EDITOR, or EDITOR environment variables, or fall back to 'vi' for Linux or 'notepad' for Windows. You can edit multiple objects, although changes are applied one at a time. The command accepts filenames as well as command line arguments, although the files you point to must be previously saved versions of resources.

+
 The default format is YAML. To edit in JSON, specify "-o json".

+
 The flag --windows-line-endings can be used to force Windows line endings, otherwise the default for your operating system will be used.

+
 In the event an error occurs while updating, a temporary file will be created on disk that contains your unapplied changes. The most common error when updating a resource is another editor changing the resource on the server. When this occurs, you will have to apply your changes to the newer version of the resource, or update your temporary saved copy to include the latest resource version.
Usage
$ edit-last-applied (RESOURCE/NAME | -f FILENAME)
Flags

@@ -2895,6 +3014,12 @@ viewing your workloads in a Kubernetes cluster.

+
+
+
+
+
+
@@ -2916,7 +3041,7 @@ viewing your workloads in a Kubernetes cluster.

-
+
@@ -2943,7 +3068,7 @@ viewing your workloads in a Kubernetes cluster.
kubectl apply set-last-applied -f deploy.yaml --create-annotation=true
 

-
Set the latest last-applied-configuration annotations by setting it to match the contents of a file. This results in the last-applied-configuration being updated as though 'kubectl apply -f ' was run, without updating any other parts of the object.

+
Set the latest last-applied-configuration annotations by setting it to match the contents of a file. This results in the last-applied-configuration being updated as though 'kubectl apply -f ' was run, without updating any other parts of the object.
Usage
$ set-last-applied -f FILENAME
Flags

@@ -2991,7 +3116,7 @@ viewing your workloads in a Kubernetes cluster.

-
+

 
 
dry-run
 
 falseIf true, only print the object that would be sent, without sending it. If true, only print the object that would be sent, without sending it. Warning: --dry-run cannot accurately output the result of merging the local manifest and the server-side data. Use --server-dry-run to get the merged result instead. 
experimental-field-managerkubectlName of the manager used to track field ownership. This is an alpha feature and flag. 
experimental-force-conflictsfalseIf true, server-side apply will force the changes against conflicts. This is an alpha feature and flag. 
experimental-server-sidefalseIf true, apply runs in the server instead of the client. This is an alpha feature and flag. 
 

 

 filename
 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 

 
kustomizekProcess a kustomization directory. This flag can't be used together with -f or -R. 

 openapi-patch
 
 true
 template
 
 Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 

 

 timeout
 
 
 
 
 
 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 

 
kustomizekProcess the kustomization directory. This flag can't be used together with -f or -R. 

 output
 o
 
 template
 
 Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 

 

 windows-line-endings
 
 
 
 
 
 template
 
 Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 

 
 

@@ -3007,8 +3132,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl apply view-last-applied -f deploy.yaml -o json
 

-
View the latest last-applied-configuration annotations by type/name or file. 

-
The default output will be printed to stdout in YAML format. One can use -o option to change output format.

+
View the latest last-applied-configuration annotations by type/name or file.

+
 The default output will be printed to stdout in YAML format. One can use -o option to change output format.

 
Usage

 
$ view-last-applied (TYPE [NAME | -l label] | TYPE/NAME | -f FILENAME)

 
Flags

@@ -3035,6 +3160,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files that contains the last-applied-configuration annotations 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 yaml
@@ -3086,9 +3217,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl annotate pods foo description-
 

-
Update the annotations on one or more resources 

-
All Kubernetes objects support the ability to store additional data with the object as annotations. Annotations are key/value pairs that can be larger than labels and include arbitrary string values such as structured JSON. Tools and system extensions may use annotations to store their own data. 

-
Attempting to set an annotation that already exists will fail unless --overwrite is set. If --resource-version is specified and does not match the current resource version on the server the command will fail.

+
Update the annotations on one or more resources

+
 All Kubernetes objects support the ability to store additional data with the object as annotations. Annotations are key/value pairs that can be larger than labels and include arbitrary string values such as structured JSON. Tools and system extensions may use annotations to store their own data.

+
 Attempting to set an annotation that already exists will fail unless --overwrite is set. If --resource-version is specified and does not match the current resource version on the server the command will fail.

 
Use "kubectl api-resources" for a complete list of supported resources.

 
Usage

 
$ annotate [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]

@@ -3140,6 +3271,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 false
@@ -3185,7 +3322,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -3201,8 +3338,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl autoscale rc foo --max=5 --cpu-percent=80
 

-
Creates an autoscaler that automatically chooses and sets the number of pods that run in a kubernetes cluster. 

-
Looks up a Deployment, ReplicaSet, StatefulSet, or ReplicationController by name and creates an autoscaler that uses the given resource as a reference. An autoscaler can automatically increase or decrease number of pods deployed within the system as needed.

+
Creates an autoscaler that automatically chooses and sets the number of pods that run in a kubernetes cluster.

+
 Looks up a Deployment, ReplicaSet, StatefulSet, or ReplicationController by name and creates an autoscaler that uses the given resource as a reference. An autoscaler can automatically increase or decrease number of pods deployed within the system as needed.

 
Usage

 
$ autoscale (-f FILENAME | TYPE NAME | TYPE/NAME) [--min=MINPODS] --max=MAXPODS [--cpu-percent=CPU]

 
Flags

@@ -3247,6 +3384,12 @@ viewing your workloads in a Kubernetes cluster.

 The name of the API generator to use. Currently there is only 1 generator. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 max
 
 -1
@@ -3292,7 +3435,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -3313,9 +3456,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl convert -f . | kubectl create -f -
 

-
Convert config files between different API versions. Both YAML and JSON formats are accepted. 

-
The command takes filename, directory, or URL as input, and convert it into format of version specified by --output-version flag. If target version is not specified or not supported, convert to latest version. 

-
The default output will be printed to stdout in YAML format. One can use -o option to change to output destination.

+
Convert config files between different API versions. Both YAML and JSON formats are accepted.

+
 The command takes filename, directory, or URL as input, and convert it into format of version specified by --output-version flag. If target version is not specified or not supported, convert to latest version.

+
 The default output will be printed to stdout in YAML format. One can use -o option to change to output destination.

 
Usage

 
$ convert -f FILENAME

 
Flags

@@ -3342,6 +3485,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files to need to get converted. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 true
@@ -3369,7 +3518,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 validate
@@ -3380,6 +3529,72 @@ viewing your workloads in a Kubernetes cluster.

 
 
 

+
diff

+

+
 Diff resources included in pod.json.

+

+
kubectl diff -f pod.json
+

+

+
 Diff file read from stdin

+

+
cat service.yaml | kubectl diff -f -
+

+
Diff configurations specified by filename or stdin between the current online configuration, and the configuration as it would be if applied.

+
 Output is always YAML.

+
 KUBECTL_EXTERNAL_DIFF environment variable can be used to select your own diff command. By default, the "diff" command available in your path will be run with "-u" (unicode) and "-N" (treat new files as empty) options.

+
Usage

+
$ diff -f FILENAME

+
Flags

+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
NameShorthandDefaultUsage
experimental-field-managerkubectlName of the manager used to track field ownership. This is an alpha feature and flag. 
experimental-force-conflictsfalseIf true, server-side apply will force the changes against conflicts. This is an alpha feature and flag. 
experimental-server-sidefalseIf true, apply runs in the server instead of the client. This is an alpha feature and flag. 
filenamef[]Filename, directory, or URL to files contains the configuration to diff 
kustomizekProcess the kustomization directory. This flag can't be used together with -f or -R. 
recursiveRfalseProcess the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory. 

+

 
edit

 

 
 Edit the service named 'docker-registry':

@@ -3401,12 +3616,12 @@ viewing your workloads in a Kubernetes cluster.

 

 
kubectl edit deployment/mydeployment -o yaml --save-config
 

-
Edit a resource from the default editor. 

-
The edit command allows you to directly edit any API resource you can retrieve via the command line tools. It will open the editor defined by your KUBE _EDITOR, or EDITOR environment variables, or fall back to 'vi' for Linux or 'notepad' for Windows. You can edit multiple objects, although changes are applied one at a time. The command accepts filenames as well as command line arguments, although the files you point to must be previously saved versions of resources. 

-
Editing is done with the API version used to fetch the resource. To edit using a specific API version, fully-qualify the resource, version, and group. 

-
The default format is YAML. To edit in JSON, specify "-o json". 

-
The flag --windows-line-endings can be used to force Windows line endings, otherwise the default for your operating system will be used. 

-
In the event an error occurs while updating, a temporary file will be created on disk that contains your unapplied changes. The most common error when updating a resource is another editor changing the resource on the server. When this occurs, you will have to apply your changes to the newer version of the resource, or update your temporary saved copy to include the latest resource version.

+
Edit a resource from the default editor.

+
 The edit command allows you to directly edit any API resource you can retrieve via the command line tools. It will open the editor defined by your KUBE_EDITOR, or EDITOR environment variables, or fall back to 'vi' for Linux or 'notepad' for Windows. You can edit multiple objects, although changes are applied one at a time. The command accepts filenames as well as command line arguments, although the files you point to must be previously saved versions of resources.

+
 Editing is done with the API version used to fetch the resource. To edit using a specific API version, fully-qualify the resource, version, and group.

+
 The default format is YAML. To edit in JSON, specify "-o json".

+
 The flag --windows-line-endings can be used to force Windows line endings, otherwise the default for your operating system will be used.

+
 In the event an error occurs while updating, a temporary file will be created on disk that contains your unapplied changes. The most common error when updating a resource is another editor changing the resource on the server. When this occurs, you will have to apply your changes to the newer version of the resource, or update your temporary saved copy to include the latest resource version.

 
Usage

 
$ edit (RESOURCE/NAME | -f FILENAME)

 
Flags

@@ -3439,6 +3654,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -3472,7 +3693,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 validate
@@ -3520,11 +3741,11 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl label pods foo bar-
 

-
Update the labels on a resource. 

+
Update the labels on a resource.

 
    
-
  • A label key and value must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters each.  
    • 
-
  • Optionally, the key can begin with a DNS subdomain prefix and a single '/', like example.com/my-app  
    • 
-
  • If --overwrite is true, then existing labels can be overwritten, otherwise attempting to overwrite a label will result in an error.  
    • 
+
  • A label key and value must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters each.
    • 
+
  • Optionally, the key can begin with a DNS subdomain prefix and a single '/', like example.com/my-app
    • 
+
  • If --overwrite is true, then existing labels can be overwritten, otherwise attempting to overwrite a label will result in an error.
    • 
 
  • If --resource-version is specified, then updates will use this resource version, otherwise the existing resource-version will be used.
    • 
 

 
Usage

@@ -3577,6 +3798,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 list
 
 false
@@ -3628,7 +3855,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -3659,9 +3886,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl patch pod valid-pod --type='json' -p='[{"op": "replace", "path": "/spec/containers/0/image", "value":"new image"}]'
 

-
Update field(s) of a resource using strategic merge patch, a JSON merge patch, or a JSON patch. 

-
JSON and YAML formats are accepted. 

-
Please refer to the models in https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/v1/definitions.html to find if a field is mutable.

+
Update field(s) of a resource using strategic merge patch, a JSON merge patch, or a JSON patch.

+
 JSON and YAML formats are accepted.

 
Usage

 
$ patch (-f FILENAME | TYPE NAME) -p PATCH

 
Flags

@@ -3694,6 +3920,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to update 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 false
@@ -3727,7 +3959,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 type
@@ -3759,10 +3991,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl replace --force -f ./pod.json
 

-
Replace a resource by filename or stdin. 

-
JSON and YAML formats are accepted. If replacing an existing resource, the complete resource spec must be provided. This can be obtained by 

+
Replace a resource by filename or stdin.

+
 JSON and YAML formats are accepted. If replacing an existing resource, the complete resource spec must be provided. This can be obtained by

 
  $ kubectl get TYPE NAME -o yaml

-
Please refer to the models in https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/v1/definitions.html to find if a field is mutable.

 
Usage

 
$ replace -f FILENAME

 
Flags

@@ -3807,6 +4038,12 @@ viewing your workloads in a Kubernetes cluster.

 Period of time in seconds given to the resource to terminate gracefully. Ignored if negative. Set to 1 for immediate shutdown. Can only be set to 0 when --force is true (force deletion). 
 
 
+kustomize
+k
+
+Process a kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -3828,7 +4065,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 timeout
@@ -3863,10 +4100,10 @@ viewing your workloads in a Kubernetes cluster.

 
kubectl rollout status daemonset/foo
 

 
Manage the rollout of a resource.

-
Valid resource types include: 

+
 Valid resource types include:

 
    
-
  • deployments  
    • 
-
  • daemonsets  
    • 
+
  • deployments
    • 
+
  • daemonsets
    • 
 
  • statefulsets
    • 
 

 
Usage

@@ -3910,6 +4147,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to get from a server. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -3931,7 +4174,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -3942,8 +4185,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl rollout pause deployment/nginx
 

-
Mark the provided resource as paused 

-
Paused resources will not be reconciled by a controller. Use "kubectl rollout resume" to resume a paused resource. Currently only deployments support being paused.

+
Mark the provided resource as paused

+
 Paused resources will not be reconciled by a controller. Use "kubectl rollout resume" to resume a paused resource. Currently only deployments support being paused.

 
Usage

 
$ pause RESOURCE

 
Flags

@@ -3970,6 +4213,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to get from a server. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -3985,7 +4234,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -3996,8 +4245,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl rollout resume deployment/nginx
 

-
Resume a paused resource 

-
Paused resources will not be reconciled by a controller. By resuming a resource, we allow it to be reconciled again. Currently only deployments support being resumed.

+
Resume a paused resource

+
 Paused resources will not be reconciled by a controller. By resuming a resource, we allow it to be reconciled again. Currently only deployments support being resumed.

 
Usage

 
$ resume RESOURCE

 
Flags

@@ -4024,6 +4273,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to get from a server. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -4039,7 +4294,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4050,8 +4305,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl rollout status deployment/nginx
 

-
Show the status of the rollout. 

-
By default 'rollout status' will watch the status of the latest rollout until it's done. If you don't want to wait for the rollout to finish then you can use --watch=false. Note that if a new rollout starts in-between, then 'rollout status' will continue watching the latest revision. If you want to pin to a specific revision and abort if it is rolled over by another revision, use --revision=N where N is the revision you need to watch for.

+
Show the status of the rollout.

+
 By default 'rollout status' will watch the status of the latest rollout until it's done. If you don't want to wait for the rollout to finish then you can use --watch=false. Note that if a new rollout starts in-between, then 'rollout status' will continue watching the latest revision. If you want to pin to a specific revision and abort if it is rolled over by another revision, use --revision=N where N is the revision you need to watch for.

 
Usage

 
$ status (TYPE NAME | TYPE/NAME) [flags]

 
Flags

@@ -4072,6 +4327,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to get from a server. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 recursive
 R
 false
@@ -4147,6 +4408,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to get from a server. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -4162,7 +4429,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 to-revision
@@ -4199,9 +4466,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl scale --replicas=3 statefulset/web
 

-
Set a new size for a Deployment, ReplicaSet, Replication Controller, or StatefulSet. 

-
Scale also allows users to specify one or more preconditions for the scale action. 

-
If --current-replicas or --resource-version is specified, it is validated before the scale is attempted, and it is guaranteed that the precondition holds true when the scale is sent to the server.

+
Set a new size for a Deployment, ReplicaSet, Replication Controller, or StatefulSet.

+
 Scale also allows users to specify one or more preconditions for the scale action.

+
 If --current-replicas or --resource-version is specified, it is validated before the scale is attempted, and it is guaranteed that the precondition holds true when the scale is sent to the server.

 
Usage

 
$ scale [--resource-version=version] [--current-replicas=count] --replicas=COUNT (-f FILENAME | TYPE NAME)

 
Flags

@@ -4240,6 +4507,12 @@ viewing your workloads in a Kubernetes cluster.

 Filename, directory, or URL to files identifying the resource to set a new size 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -4279,7 +4552,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 timeout
@@ -4291,8 +4564,8 @@ viewing your workloads in a Kubernetes cluster.

 
 

 
set

-
Configure application resources 

-
These commands help you make changes to existing application resources.

+
Configure application resources

+
 These commands help you make changes to existing application resources.

 
Usage

 
$ set SUBCOMMAND

 

@@ -4352,10 +4625,10 @@ viewing your workloads in a Kubernetes cluster.

 
 
env | grep RAILS_ | kubectl set env -e - deployment/registry
 

-
Update environment variables on a pod template. 

-
List environment variable definitions in one or more pods, pod templates. Add, update, or remove container environment variable definitions in one or more pod templates (within replication controllers or deployment configurations). View or modify the environment variable definitions on all containers in the specified pods or pod templates, or just those that match a wildcard. 

-
If "--env -" is passed, environment variables can be read from STDIN using the standard env syntax. 

-
Possible resources include (case insensitive): 

+
Update environment variables on a pod template.

+
 List environment variable definitions in one or more pods, pod templates. Add, update, or remove container environment variable definitions in one or more pod templates (within replication controllers or deployment configurations). View or modify the environment variable definitions on all containers in the specified pods or pod templates, or just those that match a wildcard.

+
 If "--env -" is passed, environment variables can be read from STDIN using the standard env syntax.

+
 Possible resources include (case insensitive):

 
  pod (po), replicationcontroller (rc), deployment (deploy), daemonset (ds), job, replicaset (rs)

 
Usage

 
$ env RESOURCE/NAME KEY_1=VAL_1 ... KEY_N=VAL_N

@@ -4419,6 +4692,12 @@ viewing your workloads in a Kubernetes cluster.

 Comma-separated list of keys to import from specified resource 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 list
 
 false
@@ -4470,7 +4749,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4496,8 +4775,8 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl set image -f path/to/file.yaml nginx=nginx:1.9.1 --local -o yaml
 

-
Update existing container image(s) of resources. 

-
Possible resources include (case insensitive): 

+
Update existing container image(s) of resources.

+
 Possible resources include (case insensitive):

 
  pod (po), replicationcontroller (rc), deployment (deploy), daemonset (ds), replicaset (rs)

 
Usage

 
$ image (-f FILENAME | TYPE NAME) CONTAINER_NAME_1=CONTAINER_IMAGE_1 ... CONTAINER_NAME_N=CONTAINER_IMAGE_N

@@ -4543,6 +4822,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 false
@@ -4576,7 +4861,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4602,9 +4887,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl set resources -f path/to/file.yaml --limits=cpu=200m,memory=512Mi --local -o yaml
 

-
Specify compute resource requirements (cpu, memory) for any resource that defines a pod template.  If a pod is successfully scheduled, it is guaranteed the amount of resource requested, but may burst up to its specified limits. 

-
for each compute resource, if a limit is specified and a request is omitted, the request will default to the limit. 

-
Possible resources include (case insensitive): Use "kubectl api-resources" for a complete list of supported resources..

+
Specify compute resource requirements (cpu, memory) for any resource that defines a pod template.  If a pod is successfully scheduled, it is guaranteed the amount of resource requested, but may burst up to its specified limits.

+
 for each compute resource, if a limit is specified and a request is omitted, the request will default to the limit.

+
 Possible resources include (case insensitive): Use "kubectl api-resources" for a complete list of supported resources..

 
Usage

 
$ resources (-f FILENAME | TYPE NAME)  ([--limits=LIMITS & --requests=REQUESTS]

 
Flags

@@ -4655,6 +4940,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 limits
 
 
@@ -4700,7 +4991,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4712,8 +5003,8 @@ viewing your workloads in a Kubernetes cluster.

 
kubectl create service clusterip my-svc --clusterip="None" -o yaml --dry-run | kubectl set selector --local -f - 'environment=qa' -o yaml | kubectl create -f -
 kubectl create deployment my-dep -o yaml --dry-run | kubectl label --local -f - environment=qa -o yaml | kubectl create -f -
 

-
Set the selector on a resource. Note that the new selector will overwrite the old selector if the resource had one prior to the invocation of 'set selector'. 

-
A selector must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters. If --resource-version is specified, then updates will use this resource version, otherwise the existing resource-version will be used. Note: currently selectors can only be set on Service objects.

+
Set the selector on a resource. Note that the new selector will overwrite the old selector if the resource had one prior to the invocation of 'set selector'.

+
 A selector must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters. If --resource-version is specified, then updates will use this resource version, otherwise the existing resource-version will be used. Note: currently selectors can only be set on Service objects.

 
Usage

 
$ selector (-f FILENAME | TYPE NAME) EXPRESSIONS [--resource-version=version]

 
Flags

@@ -4752,12 +5043,6 @@ viewing your workloads in a Kubernetes cluster.

 identifying the resource. 
 
 
-include-uninitialized
-
-false
-If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
-
-
 local
 
 false
@@ -4791,7 +5076,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4807,9 +5092,9 @@ viewing your workloads in a Kubernetes cluster.

 
 
kubectl set sa -f nginx-deployment.yaml serviceaccount1 --local --dry-run -o yaml
 

-
Update ServiceAccount of pod template resources. 

-
Possible resources (case insensitive) can be: 

-
replicationcontroller (rc), deployment (deploy), daemonset (ds), job, replicaset (rs), statefulset

+
Update ServiceAccount of pod template resources.

+
 Possible resources (case insensitive) can be:

+
 replicationcontroller (rc), deployment (deploy), daemonset (ds), job, replicaset (rs), statefulset

 
Usage

 
$ serviceaccount (-f FILENAME | TYPE NAME) SERVICE_ACCOUNT

 
Flags

@@ -4854,6 +5139,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 false
@@ -4881,7 +5172,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -4953,6 +5244,12 @@ viewing your workloads in a Kubernetes cluster.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 local
 
 false
@@ -4986,7 +5283,7 @@ viewing your workloads in a Kubernetes cluster.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -5003,12 +5300,12 @@ viewing your workloads in a Kubernetes cluster.

 
kubectl delete pod/busybox1
 kubectl wait --for=delete pod/busybox1 --timeout=60s
 

-
Experimental: Wait for a specific condition on one or many resources. 

-
The command takes multiple resources and waits until the specified condition is seen in the Status field of every given resource. 

-
Alternatively, the command can wait for the given set of resources to be deleted by providing the "delete" keyword as the value to the --for flag. 

-
A successful message will be printed to stdout indicating when the specified condition has been met. One can use -o option to change to output destination.

+
Experimental: Wait for a specific condition on one or many resources.

+
 The command takes multiple resources and waits until the specified condition is seen in the Status field of every given resource.

+
 Alternatively, the command can wait for the given set of resources to be deleted by providing the "delete" keyword as the value to the --for flag.

+
 A successful message will be printed to stdout indicating when the specified condition has been met. One can use -o option to change to output destination.

 
Usage

-
$ wait resource.group/name [--for=delete|--for condition=available]

+
$ wait ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=delete|--for condition=available]

 
Flags

 
@@ -5021,9 +5318,15 @@ kubectl wait --for
 
-
+
+
+
+
+
+
+
@@ -5033,6 +5336,12 @@ kubectl wait --for
 
+
+
+
+
+
+
@@ -5066,7 +5375,7 @@ kubectl wait --for
 
-
+
@@ -5183,8 +5492,13 @@ applications.
kubectl auth can-i get /logs/
 

-
Check whether an action is allowed. 

-
VERB is a logical Kubernetes API verb like 'get', 'list', 'watch', 'delete', etc. TYPE is a Kubernetes resource. Shortcuts and groups will be resolved. NONRESOURCEURL is a partial URL starts with "/". NAME is the name of a particular Kubernetes resource.

+

+
 List all allowed actions in namespace "foo"

+

+
kubectl auth can-i --list --namespace=foo
+

+
Check whether an action is allowed.

+
 VERB is a logical Kubernetes API verb like 'get', 'list', 'watch', 'delete', etc. TYPE is a Kubernetes resource. Shortcuts and groups will be resolved. NONRESOURCEURL is a partial URL starts with "/". NAME is the name of a particular Kubernetes resource.
Usage
$ can-i VERB [TYPE | TYPE/NAME | NONRESOURCEURL]
Flags

@@ -5200,11 +5514,23 @@ applications.

-
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -5225,8 +5551,11 @@ applications.
kubectl auth reconcile -f my-rbac-rules.yaml
 

-
Reconciles rules for RBAC Role, RoleBinding, ClusterRole, and ClusterRole binding objects. 

-
This is preferred to 'apply' for RBAC resources so that proper rule coverage checks are done.

+
Reconciles rules for RBAC Role, RoleBinding, ClusterRole, and ClusterRole binding objects.

+
 Missing objects are created, and the containing namespace is created for namespaced objects, if required.

+
 Existing roles are updated to include the permissions in the input objects, and remove extra permissions if --remove-extra-permissions is specified.

+
 Existing bindings are updated to include the subjects in the input objects, and remove extra subjects if --remove-extra-subjects is specified.

+
 This is preferred to 'apply' for RBAC resources so that semantically-aware merging of rules and subjects is done.
Usage
$ reconcile -f FILENAME
Flags

@@ -5259,6 +5588,12 @@ applications.

+
+
+
+
+
+
@@ -5286,7 +5621,7 @@ applications.

-
+

 
 
 
all-namespacesall
 
 falseSelect all resources in the namespace of the specified resource types 
all-namespacesAfalse
 If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace. 
 

 
If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats. 
 

 
field-selectorSelector (field query) to filter on, supports '=', '==', and '!='.(e.g. --field-selector key1=value1,key2=value2). The server only supports a limited number of field queries per type. 

 filename
 f
 []template
 
 Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 

 

 timeout
 
 
 
 
 
 

 

 all-namespacesA
 false
 If true, check the specified action in all namespaces. 
 

 
listfalseIf true, prints all allowed actions. 
no-headersfalseIf true, prints allowed actions without headers 

 quiet
 q
 false
 
 
 
 
 
 Filename, directory, or URL to files identifying the resource to reconcile. 
 

 
kustomizekProcess the kustomization directory. This flag can't be used together with -f or -R. 

 output
 o
 
 template
 
 Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 

 
 

@@ -5372,10 +5707,10 @@ applications.

 
 
kubectl describe pods frontend
 

-
Show details of a specific resource or group of resources 

-
Print a detailed description of the selected resources, including related resources such as events or controllers. You may select a single object by name, all objects of that type, provide a name prefix, or label selector. For example: 

+
Show details of a specific resource or group of resources

+
 Print a detailed description of the selected resources, including related resources such as events or controllers. You may select a single object by name, all objects of that type, provide a name prefix, or label selector. For example:

 
  $ kubectl describe TYPE NAME_PREFIX

-
will first check for an exact match on TYPE and NAME PREFIX. If no such resource exists, it will output details for every resource that has a name prefixed with NAME PREFIX.

+
 will first check for an exact match on TYPE and NAME_PREFIX. If no such resource exists, it will output details for every resource that has a name prefixed with NAME_PREFIX.

 
Use "kubectl api-resources" for a complete list of supported resources.

 
Usage

 
$ describe (-f FILENAME | TYPE [NAME_PREFIX | -l label] | TYPE/NAME)

@@ -5392,7 +5727,7 @@ applications.

 
 
 all-namespaces
-
+A
 false
 If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace. 
 
@@ -5409,6 +5744,12 @@ applications.

 If true, the kubectl command applies to uninitialized objects. If explicitly set to false, this flag overrides other flags that make the kubectl commands apply to uninitialized objects, e.g., "--all". Objects with empty metadata.initializers are regarded as initialized. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 recursive
 R
 false
@@ -5518,6 +5859,11 @@ applications.

 
kubectl logs -f -c ruby web-1
 

 

+
 Begin streaming the logs from all containers in pods defined by label app=nginx

+

+
kubectl logs -f -lapp=nginx --all-containers=true
+

+

 
 Display only the most recent 20 lines of output in pod nginx

 

 
kubectl logs --tail=20 nginx
@@ -5576,6 +5922,12 @@ applications.

 Maximum bytes of logs to return. Defaults to no limit. 
 
 
+max-log-requests
+
+5
+Specify maximum number of concurrent logs to follow when using by a selector. Defaults to 5. 
+
+
 pod-running-timeout
 
 20s
@@ -5656,9 +6008,9 @@ applications.

 
 
kubectl port-forward pod/mypod :5000
 

-
Forward one or more local ports to a pod. 

-
Use resource type/name such as deployment/mydeployment to select a pod. Resource type defaults to 'pod' if omitted. 

-
If there are multiple pods matching the criteria, a pod will be selected automatically. The forwarding session ends when the selected pod terminates, and rerun of the command is needed to resume forwarding.

+
Forward one or more local ports to a pod. This command requires the node to have 'socat' installed.

+
 Use resource type/name such as deployment/mydeployment to select a pod. Resource type defaults to 'pod' if omitted.

+
 If there are multiple pods matching the criteria, a pod will be selected automatically. The forwarding session ends when the selected pod terminates, and rerun of the command is needed to resume forwarding.

 
Usage

 
$ port-forward TYPE/NAME [options] [LOCAL_PORT:]REMOTE_PORT [...[LOCAL_PORT_N:]REMOTE_PORT_N]

 
Flags

@@ -5676,7 +6028,7 @@ applications.

 address
 
 [localhost]
-Addresses to listen on (comma separated) 
+Addresses to listen on (comma separated). Only accepts IP addresses or localhost as a value. When localhost is supplied, kubectl will try to bind on both 127.0.0.1 and ::1 and will fail if neither of these addresses are available to bind. 
 
 
 pod-running-timeout
@@ -5808,9 +6160,9 @@ applications.

 
 

 
top

-
Display Resource (CPU/Memory/Storage) usage. 

-
The top command allows you to see the resource consumption for nodes or pods. 

-
This command requires Heapster to be correctly configured and working on the server.

+
Display Resource (CPU/Memory/Storage) usage.

+
 The top command allows you to see the resource consumption for nodes or pods.

+
 This command requires Heapster to be correctly configured and working on the server.

 
Usage

 
$ top

 

@@ -5825,8 +6177,8 @@ applications.

 
 
kubectl top node NODE_NAME
 

-
Display Resource (CPU/Memory/Storage) usage of nodes. 

-
The top-node command allows you to see the resource consumption of nodes.

+
Display Resource (CPU/Memory/Storage) usage of nodes.

+
 The top-node command allows you to see the resource consumption of nodes.

 
Usage

 
$ node [NAME | -l label]

 
Flags

@@ -5900,9 +6252,9 @@ applications.

 
 
kubectl top pod -l name=myLabel
 

-
Display Resource (CPU/Memory/Storage) usage of pods. 

-
The 'top pod' command allows you to see the resource consumption of pods. 

-
Due to the metrics pipeline delay, they may be unavailable for a few minutes since pod creation.

+
Display Resource (CPU/Memory/Storage) usage of pods.

+
 The 'top pod' command allows you to see the resource consumption of pods.

+
 Due to the metrics pipeline delay, they may be unavailable for a few minutes since pod creation.

 
Usage

 
$ pod [NAME | -l label]

 
Flags

@@ -5918,7 +6270,7 @@ applications.

 
 
 all-namespaces
-
+A
 false
 If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace. 
 
@@ -5984,9 +6336,9 @@ applications.

 
$ certificate SUBCOMMAND

 

 
approve

-
Approve a certificate signing request. 

-
kubectl certificate approve allows a cluster admin to approve a certificate signing request (CSR). This action tells a certificate signing controller to issue a certificate to the requestor with the attributes requested in the CSR. 

-
SECURITY NOTICE: Depending on the requested attributes, the issued certificate can potentially grant a requester access to cluster resources or to authenticate as a requested identity. Before approving a CSR, ensure you understand what the signed certificate can do.

+
Approve a certificate signing request.

+
 kubectl certificate approve allows a cluster admin to approve a certificate signing request (CSR). This action tells a certificate signing controller to issue a certificate to the requestor with the attributes requested in the CSR.

+
 SECURITY NOTICE: Depending on the requested attributes, the issued certificate can potentially grant a requester access to cluster resources or to authenticate as a requested identity. Before approving a CSR, ensure you understand what the signed certificate can do.

 
Usage

 
$ approve (-f FILENAME | NAME)

 
Flags

@@ -6019,6 +6371,12 @@ applications.

 Update the CSR even if it is already approved. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -6034,14 +6392,14 @@ applications.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
 

 
deny

-
Deny a certificate signing request. 

-
kubectl certificate deny allows a cluster admin to deny a certificate signing request (CSR). This action tells a certificate signing controller to not to issue a certificate to the requestor.

+
Deny a certificate signing request.

+
 kubectl certificate deny allows a cluster admin to deny a certificate signing request (CSR). This action tells a certificate signing controller to not to issue a certificate to the requestor.

 
Usage

 
$ deny (-f FILENAME | NAME)

 
Flags

@@ -6074,6 +6432,12 @@ applications.

 Update the CSR even if it is already denied. 
 
 
+kustomize
+k
+
+Process the kustomization directory. This flag can't be used together with -f or -R. 
+
+
 output
 o
 
@@ -6089,7 +6453,7 @@ applications.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -6125,8 +6489,8 @@ applications.

 
 
kubectl cluster-info dump --namespaces default,kube-system --output-directory=/path/to/cluster-state
 

-
Dumps cluster info out suitable for debugging and diagnosing cluster problems.  By default, dumps everything to stdout. You can optionally specify a directory with --output-directory.  If you specify a directory, kubernetes will build a set of files in that directory.  By default only dumps things in the 'kube-system' namespace, but you can switch to a different namespace with the --namespaces flag, or specify --all-namespaces to dump all namespaces. 

-
The command also dumps the logs of all of the pods in the cluster, these logs are dumped into different directories based on namespace and pod name.

+
Dumps cluster info out suitable for debugging and diagnosing cluster problems.  By default, dumps everything to stdout. You can optionally specify a directory with --output-directory.  If you specify a directory, kubernetes will build a set of files in that directory.  By default only dumps things in the 'kube-system' namespace, but you can switch to a different namespace with the --namespaces flag, or specify --all-namespaces to dump all namespaces.

+
 The command also dumps the logs of all of the pods in the cluster, these logs are dumped into different directories based on namespace and pod name.

 
Usage

 
$ dump

 
Flags

@@ -6142,7 +6506,7 @@ applications.

 
 
 all-namespaces
-
+A
 false
 If true, dump all namespaces.  If true, --namespaces is ignored. 
 
@@ -6180,7 +6544,7 @@ applications.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -6231,11 +6595,11 @@ applications.

 
 
$ kubectl drain foo --grace-period=900
 

-
Drain node in preparation for maintenance. 

-
The given node will be marked unschedulable to prevent new pods from arriving. 'drain' evicts the pods if the APIServer supports  http://kubernetes.io/docs/admin/disruptions/. Otherwise, it will use normal DELETE to delete the pods. The 'drain' evicts or deletes all pods except mirror pods (which cannot be deleted through the API server).  If there are DaemonSet-managed pods, drain will not proceed without --ignore-daemonsets, and regardless it will not delete any DaemonSet-managed pods, because those pods would be immediately replaced by the DaemonSet controller, which ignores unschedulable markings.  If there are any pods that are neither mirror pods nor managed by ReplicationController, ReplicaSet, DaemonSet, StatefulSet or Job, then drain will not delete any pods unless you use --force.  --force will also allow deletion to proceed if the managing resource of one or more pods is missing. 

-
'drain' waits for graceful termination. You should not operate on the machine until the command completes. 

-
When you are ready to put the node back into service, use kubectl uncordon, which will make the node schedulable again. 

-
! http://kubernetes.io/images/docs/kubectl_drain.svg

+
Drain node in preparation for maintenance.

+
 The given node will be marked unschedulable to prevent new pods from arriving. 'drain' evicts the pods if the APIServer supportshttp://kubernetes.io/docs/admin/disruptions/ . Otherwise, it will use normal DELETE to delete the pods. The 'drain' evicts or deletes all pods except mirror pods (which cannot be deleted through the API server).  If there are DaemonSet-managed pods, drain will not proceed without --ignore-daemonsets, and regardless it will not delete any DaemonSet-managed pods, because those pods would be immediately replaced by the DaemonSet controller, which ignores unschedulable markings.  If there are any pods that are neither mirror pods nor managed by ReplicationController, ReplicaSet, DaemonSet, StatefulSet or Job, then drain will not delete any pods unless you use --force.  --force will also allow deletion to proceed if the managing resource of one or more pods is missing.

+
 'drain' waits for graceful termination. You should not operate on the machine until the command completes.

+
 When you are ready to put the node back into service, use kubectl uncordon, which will make the node schedulable again.

+
 http://kubernetes.io/images/docs/kubectl_drain.svg

 
Usage

 
$ drain NODE

 
Flags

@@ -6321,13 +6685,13 @@ applications.

 
 
kubectl taint node -l myLabel=X  dedicated=foo:PreferNoSchedule
 

-
Update the taints on one or more nodes. 

+
Update the taints on one or more nodes.

 
    
-
  • A taint consists of a key, value, and effect. As an argument here, it is expressed as key=value:effect.  
    • 
-
  • The key must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  253 characters.  
    • 
-
  • Optionally, the key can begin with a DNS subdomain prefix and a single '/', like example.com/my-app  
    • 
-
  • The value must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters.  
    • 
-
  • The effect must be NoSchedule, PreferNoSchedule or NoExecute.  
    • 
+
  • A taint consists of a key, value, and effect. As an argument here, it is expressed as key=value:effect.
    • 
+
  • The key must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  253 characters.
    • 
+
  • Optionally, the key can begin with a DNS subdomain prefix and a single '/', like example.com/my-app
    • 
+
  • The value must begin with a letter or number, and may contain letters, numbers, hyphens, dots, and underscores, up to  63 characters.
    • 
+
  • The effect must be NoSchedule, PreferNoSchedule or NoExecute.
    • 
 
  • Currently taint can only apply to node.
    • 
 

 
Usage

@@ -6377,7 +6741,7 @@ applications.

 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 validate
@@ -6552,18 +6916,18 @@ source $HOME/.bash_profile
 
 
kubectl completion zsh > "${fpath[1]}/_kubectl"
 

-
Output shell completion code for the specified shell (bash or zsh). The shell code must be evaluated to provide interactive completion of kubectl commands.  This can be done by sourcing it from the .bash _profile. 

-
Detailed instructions on how to do this are available here: https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion 

-
Note for zsh users: [1] zsh completions are only supported in versions of zsh >= 5.2

+
Output shell completion code for the specified shell (bash or zsh). The shell code must be evaluated to provide interactive completion of kubectl commands.  This can be done by sourcing it from the .bash_profile.

+
 Detailed instructions on how to do this are available here: https://kubernetes.io/docs/tasks/tools/install-kubectl/#enabling-shell-autocompletion

+
 Note for zsh users: [1] zsh completions are only supported in versions of zsh >= 5.2

 
Usage

 
$ completion SHELL

 

 
config

-
Modify kubeconfig files using subcommands like "kubectl config set current-context my-context" 

-
The loading order follows these rules: 

+
Modify kubeconfig files using subcommands like "kubectl config set current-context my-context"

+
 The loading order follows these rules:

 
    
-
  1. If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.  
    2. 
-
  2. If $KUBECONFIG environment variable is set, then it is used as a list of paths (normal path delimitting rules for your system). These paths are merged. When a value is modified, it is modified in the file that defines the stanza. When a value is created, it is created in the first file that exists. If no files in the chain exist, then it creates the last file in the list.  
    3. 
+
  3. If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.
    4. 
+
  4. If $KUBECONFIG environment variable is set, then it is used as a list of paths (normal path delimiting rules for your system). These paths are merged. When a value is modified, it is modified in the file that defines the stanza. When a value is created, it is created in the first file that exists. If no files in the chain exist, then it creates the last file in the list.
    5. 
 
  5. Otherwise, ${HOME}/.kube/config is used and no merging takes place.
    6. 
 

 
Usage

@@ -6655,17 +7019,38 @@ source $HOME/.bash_profile
 
 
kubectl config rename-context old-name new-name
 

-
Renames a context from the kubeconfig file. 

-
CONTEXT _NAME is the context name that you wish change. 

-
NEW _NAME is the new name you wish to set. 

-
Note: In case the context being renamed is the 'current-context', this field will also be updated.

+
Renames a context from the kubeconfig file.

+
 CONTEXT_NAME is the context name that you wish change.

+
 NEW_NAME is the new name you wish to set.

+
 Note: In case the context being renamed is the 'current-context', this field will also be updated.

 
Usage

 
$ rename-context CONTEXT_NAME NEW_NAME

 

 
set

-
Sets an individual value in a kubeconfig file 

-
PROPERTY _NAME is a dot delimited name where each token represents either an attribute name or a map key.  Map keys may not contain dots. 

-
PROPERTY _VALUE is the new value you wish to set. Binary fields such as 'certificate-authority-data' expect a base64 encoded string unless the --set-raw-bytes flag is used.

+

+
 Set server field on the my-cluster cluster to https://1.2.3.4

+

+
kubectl config set clusters.my-cluster.server https://1.2.3.4
+

+

+
 Set certificate-authority-data field on the my-cluster cluster.

+

+
kubectl config set clusters.my-cluster.certificate-authority-data $(echo "cert_data_here" | base64 -i -)
+

+

+
 Set cluster field in the my-context context to my-cluster.

+

+
kubectl config set contexts.my-context.cluster my-cluster
+

+

+
 Set client-key-data field in the cluster-admin user using --set-raw-bytes option.

+

+
kubectl config set users.cluster-admin.client-key-data cert_data_here --set-raw-bytes=true
+

+
Sets an individual value in a kubeconfig file

+
 PROPERTY_NAME is a dot delimited name where each token represents either an attribute name or a map key.  Map keys may not contain dots.

+
 PROPERTY_VALUE is the new value you wish to set. Binary fields such as 'certificate-authority-data' expect a base64 encoded string unless the --set-raw-bytes flag is used.

+
 Specifying a attribute name that already exists will merge new fields on top of existing values.

 
Usage

 
$ set PROPERTY_NAME PROPERTY_VALUE

 
Flags

@@ -6704,8 +7089,8 @@ source $HOME/.bash_profile
 
 
kubectl config set-cluster e2e --insecure-skip-tls-verify=true
 

-
Sets a cluster entry in kubeconfig. 

-
Specifying a name that already exists will merge new fields on top of existing values for those fields.

+
Sets a cluster entry in kubeconfig.

+
 Specifying a name that already exists will merge new fields on top of existing values for those fields.

 
Usage

 
$ set-cluster NAME [--server=server] [--certificate-authority=path/to/certificate/authority] [--insecure-skip-tls-verify=true]

 
Flags

@@ -6734,8 +7119,8 @@ source $HOME/.bash_profile
 
 
kubectl config set-context gce --user=cluster-admin
 

-
Sets a context entry in kubeconfig 

-
Specifying a name that already exists will merge new fields on top of existing values for those fields.

+
Sets a context entry in kubeconfig

+
 Specifying a name that already exists will merge new fields on top of existing values for those fields.

 
Usage

 
$ set-context [NAME | --current] [--cluster=cluster_nickname] [--user=user_nickname] [--namespace=namespace]

 
Flags

@@ -6789,15 +7174,15 @@ source $HOME/.bash_profile
 
 
kubectl config set-credentials cluster-admin --auth-provider=oidc --auth-provider-arg=client-secret-
 

-
Sets a user entry in kubeconfig 

-
Specifying a name that already exists will merge new fields on top of existing values. 

+
Sets a user entry in kubeconfig

+
 Specifying a name that already exists will merge new fields on top of existing values.

 
  Client-certificate flags:
   --client-certificate=certfile --client-key=keyfile

 
  Bearer token flags:
     --token=bearer_token

 
  Basic auth flags:
     --username=basic_user --password=basic_password

-
Bearer token and basic auth are mutually exclusive.

+
 Bearer token and basic auth are mutually exclusive.

 
Usage

 
$ set-credentials NAME [--client-certificate=path/to/certfile] [--client-key=path/to/keyfile] [--token=bearer_token] [--username=basic_user] [--password=basic_password] [--auth-provider=provider_name] [--auth-provider-arg=key=value]

 
Flags

@@ -6829,18 +7214,6 @@ source $HOME/.bash_profile
 false
 Embed client cert/key for the user entry in kubeconfig 
 
-
-password
-
-
-password for the user entry in kubeconfig 
-
-
-username
-
-
-username for the user entry in kubeconfig 
-
 
 
 

@@ -6855,8 +7228,8 @@ source $HOME/.bash_profile
 
 
kubectl config unset contexts.foo.namespace
 

-
Unsets an individual value in a kubeconfig file 

-
PROPERTY _NAME is a dot delimited name where each token represents either an attribute name or a map key.  Map keys may not contain dots.

+
Unsets an individual value in a kubeconfig file

+
 PROPERTY_NAME is a dot delimited name where each token represents either an attribute name or a map key.  Map keys may not contain dots.

 
Usage

 
$ unset PROPERTY_NAME

 

@@ -6886,8 +7259,8 @@ source $HOME/.bash_profile
 
 
kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'
 

-
Display merged kubeconfig settings or a specified kubeconfig file. 

-
You can use --output jsonpath={...} to extract specific values using a jsonpath expression.

+
Display merged kubeconfig settings or a specified kubeconfig file.

+
 You can use --output jsonpath={...} to extract specific values using a jsonpath expression.

 
Usage

 
$ view

 
Flags

@@ -6941,7 +7314,7 @@ source $HOME/.bash_profile
 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 
@@ -6957,10 +7330,10 @@ source $HOME/.bash_profile
 
 
kubectl explain pods.spec.containers
 

-
List the fields for supported resources 

-
This command describes the fields associated with each supported API resource. Fields are identified via a simple JSONPath identifier: 

+
List the fields for supported resources

+
 This command describes the fields associated with each supported API resource. Fields are identified via a simple JSONPath identifier:

 
  .[.]

-
Add the --recursive flag to display all of the fields at once without descriptions. Information about each field is retrieved from the server in OpenAPI format.

+
 Add the --recursive flag to display all of the fields at once without descriptions. Information about each field is retrieved from the server in OpenAPI format.

 
Use "kubectl api-resources" for a complete list of supported resources.

 
Usage

 
$ explain RESOURCE

@@ -6990,6 +7363,28 @@ source $HOME/.bash_profile
 
 
 

+
kustomize

+

+
 Use the current working directory

+

+
kubectl%20kustomize%20.
+

+

+
 Use some shared configuration directory

+

+
kubectl kustomize /home/configuration/production
+

+

+
 Use a URL

+

+
kubectl kustomize github.com/kubernetes-sigs/kustomize.git/examples/helloWorld?ref=v1.0.6
+

+
Print a set of API resources generated from instructions in a kustomization.yaml file.

+
 The argument must be the path to the directory containing the file, or a git repository URL with a path suffix specifying same with respect to the repository root.

+
 kubectl kustomize somedir

+
Usage

+
$ kustomize <dir>

+

 
options

 

 
 Print flags inherited by all commands

@@ -7001,14 +7396,14 @@ source $HOME/.bash_profile
 
$ options

 

 
plugin

-
Provides utilities for interacting with plugins. 

-
Plugins provide extended functionality that is not part of the major command-line distribution. Please refer to the documentation and examples for more information about how write your own plugins.

+
Provides utilities for interacting with plugins.

+
 Plugins provide extended functionality that is not part of the major command-line distribution. Please refer to the documentation and examples for more information about how write your own plugins.

 
Usage

 
$ plugin [flags]

 

 
list

-
List all available plugin files on a user's PATH. 

-
Available plugin files are those that are: - executable - anywhere on the user's PATH - begin with "kubectl-"

+
List all available plugin files on a user's PATH.

+
 Available plugin files are those that are: - executable - anywhere on the user's PATH - begin with "kubectl-"

 
Usage

 
$ list

 
Flags

@@ -7099,9 +7494,9 @@ source $HOME/.bash_profile
 

 
kubectl rolling-update frontend-v1 frontend-v2 --rollback
 

-
Perform a rolling update of the given ReplicationController. 

-
Replaces the specified replication controller with a new replication controller by updating one pod at a time to use the new PodTemplate. The new-controller.json must specify the same namespace as the existing replication controller and overwrite at least one (common) label in its replicaSelector. 

-
! http://kubernetes.io/images/docs/kubectl_rollingupdate.svg

+
Perform a rolling update of the given ReplicationController.

+
 Replaces the specified replication controller with a new replication controller by updating one pod at a time to use the new PodTemplate. The new-controller.json must specify the same namespace as the existing replication controller and overwrite at least one (common) label in its replicaSelector.

+
 http://kubernetes.io/images/docs/kubectl_rollingupdate.svg

 
Usage

 
$ rolling-update OLD_CONTROLLER_NAME ([NEW_CONTROLLER_NAME] --image=NEW_CONTAINER_IMAGE | -f NEW_CONTROLLER_SPEC)

 
Flags

@@ -7179,7 +7574,7 @@ source $HOME/.bash_profile
 template
 
 
-Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
+Template string or path to template file to use when -o=go-template, -o=go-template-file. The template format is golang templates [http://golang.org/pkg/text/template/#pkg-overview]. 
 
 
 timeout
diff --git a/static/docs/reference/generated/kubectl/navData.js b/static/docs/reference/generated/kubectl/navData.js
index d9ecb0666a..d58ccb5628 100644
--- a/static/docs/reference/generated/kubectl/navData.js
+++ b/static/docs/reference/generated/kubectl/navData.js
@@ -1 +1 @@
-(function(){navData = {"toc":[{"section":"rolling-update","subsections":[]},{"section":"-strong-deprecated-commands-strong-","subsections":[]},{"section":"version","subsections":[]},{"section":"plugin","subsections":[{"section":"-em-list-em-"}]},{"section":"options","subsections":[]},{"section":"explain","subsections":[]},{"section":"config","subsections":[{"section":"-em-view-em-"},{"section":"-em-use-context-em-"},{"section":"-em-unset-em-"},{"section":"-em-set-credentials-em-"},{"section":"-em-set-context-em-"},{"section":"-em-set-cluster-em-"},{"section":"-em-set-em-"},{"section":"-em-rename-context-em-"},{"section":"-em-get-contexts-em-"},{"section":"-em-get-clusters-em-"},{"section":"-em-delete-context-em-"},{"section":"-em-delete-cluster-em-"},{"section":"-em-current-context-em-"}]},{"section":"completion","subsections":[]},{"section":"api-resources","subsections":[]},{"section":"alpha","subsections":[]},{"section":"-strong-kubectl-settings-and-usage-strong-","subsections":[]},{"section":"uncordon","subsections":[]},{"section":"taint","subsections":[]},{"section":"drain","subsections":[]},{"section":"cordon","subsections":[]},{"section":"cluster-info","subsections":[{"section":"-em-dump-em-"}]},{"section":"certificate","subsections":[{"section":"-em-deny-em-"},{"section":"-em-approve-em-"}]},{"section":"api-versions","subsections":[]},{"section":"-strong-cluster-management-strong-","subsections":[]},{"section":"top","subsections":[{"section":"-em-pod-em-"},{"section":"-em-node-em-"}]},{"section":"proxy","subsections":[]},{"section":"port-forward","subsections":[]},{"section":"logs","subsections":[]},{"section":"exec","subsections":[]},{"section":"describe","subsections":[]},{"section":"cp","subsections":[]},{"section":"auth","subsections":[{"section":"-em-reconcile-em-"},{"section":"-em-can-i-em-"}]},{"section":"attach","subsections":[]},{"section":"-strong-working-with-apps-strong-","subsections":[]},{"section":"wait","subsections":[]},{"section":"set","subsections":[{"section":"-em-subject-em-"},{"section":"-em-serviceaccount-em--1"},{"section":"-em-selector-em-"},{"section":"-em-resources-em-"},{"section":"-em-image-em-"},{"section":"-em-env-em-"}]},{"section":"scale","subsections":[]},{"section":"rollout","subsections":[{"section":"-em-undo-em-"},{"section":"-em-status-em-"},{"section":"-em-resume-em-"},{"section":"-em-pause-em-"},{"section":"-em-history-em-"}]},{"section":"replace","subsections":[]},{"section":"patch","subsections":[]},{"section":"label","subsections":[]},{"section":"edit","subsections":[]},{"section":"convert","subsections":[]},{"section":"autoscale","subsections":[]},{"section":"annotate","subsections":[]},{"section":"apply","subsections":[{"section":"-em-view-last-applied-em-"},{"section":"-em-set-last-applied-em-"},{"section":"-em-edit-last-applied-em-"}]},{"section":"-strong-app-management-strong-","subsections":[]},{"section":"diff","subsections":[]},{"section":"delete","subsections":[]},{"section":"expose","subsections":[]},{"section":"run","subsections":[]},{"section":"get","subsections":[]},{"section":"create","subsections":[{"section":"-em-serviceaccount-em-"},{"section":"-em-service-nodeport-em-"},{"section":"-em-service-loadbalancer-em-"},{"section":"-em-service-externalname-em-"},{"section":"-em-service-clusterip-em-"},{"section":"-em-service-em-"},{"section":"-em-secret-tls-em-"},{"section":"-em-secret-generic-em-"},{"section":"-em-secret-docker-registry-em-"},{"section":"-em-secret-em-"},{"section":"-em-rolebinding-em-"},{"section":"-em-role-em-"},{"section":"-em-quota-em-"},{"section":"-em-priorityclass-em-"},{"section":"-em-poddisruptionbudget-em-"},{"section":"-em-namespace-em-"},{"section":"-em-job-em-"},{"section":"-em-deployment-em-"},{"section":"-em-configmap-em-"},{"section":"-em-clusterrolebinding-em-"},{"section":"-em-clusterrole-em-"}]},{"section":"-strong-getting-started-strong-","subsections":[]}],"flatToc":["rolling-update","-strong-deprecated-commands-strong-","version","-em-list-em-","plugin","options","explain","-em-view-em-","-em-use-context-em-","-em-unset-em-","-em-set-credentials-em-","-em-set-context-em-","-em-set-cluster-em-","-em-set-em-","-em-rename-context-em-","-em-get-contexts-em-","-em-get-clusters-em-","-em-delete-context-em-","-em-delete-cluster-em-","-em-current-context-em-","config","completion","api-resources","alpha","-strong-kubectl-settings-and-usage-strong-","uncordon","taint","drain","cordon","-em-dump-em-","cluster-info","-em-deny-em-","-em-approve-em-","certificate","api-versions","-strong-cluster-management-strong-","-em-pod-em-","-em-node-em-","top","proxy","port-forward","logs","exec","describe","cp","-em-reconcile-em-","-em-can-i-em-","auth","attach","-strong-working-with-apps-strong-","wait","-em-subject-em-","-em-serviceaccount-em--1","-em-selector-em-","-em-resources-em-","-em-image-em-","-em-env-em-","set","scale","-em-undo-em-","-em-status-em-","-em-resume-em-","-em-pause-em-","-em-history-em-","rollout","replace","patch","label","edit","convert","autoscale","annotate","-em-view-last-applied-em-","-em-set-last-applied-em-","-em-edit-last-applied-em-","apply","-strong-app-management-strong-","diff","delete","expose","run","get","-em-serviceaccount-em-","-em-service-nodeport-em-","-em-service-loadbalancer-em-","-em-service-externalname-em-","-em-service-clusterip-em-","-em-service-em-","-em-secret-tls-em-","-em-secret-generic-em-","-em-secret-docker-registry-em-","-em-secret-em-","-em-rolebinding-em-","-em-role-em-","-em-quota-em-","-em-priorityclass-em-","-em-poddisruptionbudget-em-","-em-namespace-em-","-em-job-em-","-em-deployment-em-","-em-configmap-em-","-em-clusterrolebinding-em-","-em-clusterrole-em-","create","-strong-getting-started-strong-"]};})();
\ No newline at end of file
+(function(){navData = {"toc":[{"section":"rolling-update","subsections":[]},{"section":"-strong-deprecated-commands-strong-","subsections":[]},{"section":"version","subsections":[]},{"section":"plugin","subsections":[{"section":"-em-list-em-"}]},{"section":"options","subsections":[]},{"section":"kustomize","subsections":[]},{"section":"explain","subsections":[]},{"section":"config","subsections":[{"section":"-em-view-em-"},{"section":"-em-use-context-em-"},{"section":"-em-unset-em-"},{"section":"-em-set-credentials-em-"},{"section":"-em-set-context-em-"},{"section":"-em-set-cluster-em-"},{"section":"-em-set-em-"},{"section":"-em-rename-context-em-"},{"section":"-em-get-contexts-em-"},{"section":"-em-get-clusters-em-"},{"section":"-em-delete-context-em-"},{"section":"-em-delete-cluster-em-"},{"section":"-em-current-context-em-"}]},{"section":"completion","subsections":[]},{"section":"api-resources","subsections":[]},{"section":"alpha","subsections":[]},{"section":"-strong-kubectl-settings-and-usage-strong-","subsections":[]},{"section":"uncordon","subsections":[]},{"section":"taint","subsections":[]},{"section":"drain","subsections":[]},{"section":"cordon","subsections":[]},{"section":"cluster-info","subsections":[{"section":"-em-dump-em-"}]},{"section":"certificate","subsections":[{"section":"-em-deny-em-"},{"section":"-em-approve-em-"}]},{"section":"api-versions","subsections":[]},{"section":"-strong-cluster-management-strong-","subsections":[]},{"section":"top","subsections":[{"section":"-em-pod-em-"},{"section":"-em-node-em-"}]},{"section":"proxy","subsections":[]},{"section":"port-forward","subsections":[]},{"section":"logs","subsections":[]},{"section":"exec","subsections":[]},{"section":"describe","subsections":[]},{"section":"cp","subsections":[]},{"section":"auth","subsections":[{"section":"-em-reconcile-em-"},{"section":"-em-can-i-em-"}]},{"section":"attach","subsections":[]},{"section":"-strong-working-with-apps-strong-","subsections":[]},{"section":"wait","subsections":[]},{"section":"set","subsections":[{"section":"-em-subject-em-"},{"section":"-em-serviceaccount-em--1"},{"section":"-em-selector-em-"},{"section":"-em-resources-em-"},{"section":"-em-image-em-"},{"section":"-em-env-em-"}]},{"section":"scale","subsections":[]},{"section":"rollout","subsections":[{"section":"-em-undo-em-"},{"section":"-em-status-em-"},{"section":"-em-resume-em-"},{"section":"-em-pause-em-"},{"section":"-em-history-em-"}]},{"section":"replace","subsections":[]},{"section":"patch","subsections":[]},{"section":"label","subsections":[]},{"section":"edit","subsections":[]},{"section":"diff","subsections":[]},{"section":"convert","subsections":[]},{"section":"autoscale","subsections":[]},{"section":"annotate","subsections":[]},{"section":"apply","subsections":[{"section":"-em-view-last-applied-em-"},{"section":"-em-set-last-applied-em-"},{"section":"-em-edit-last-applied-em-"}]},{"section":"-strong-app-management-strong-","subsections":[]},{"section":"delete","subsections":[]},{"section":"expose","subsections":[]},{"section":"run","subsections":[]},{"section":"get","subsections":[]},{"section":"create","subsections":[{"section":"-em-serviceaccount-em-"},{"section":"-em-service-nodeport-em-"},{"section":"-em-service-loadbalancer-em-"},{"section":"-em-service-externalname-em-"},{"section":"-em-service-clusterip-em-"},{"section":"-em-service-em-"},{"section":"-em-secret-tls-em-"},{"section":"-em-secret-generic-em-"},{"section":"-em-secret-docker-registry-em-"},{"section":"-em-secret-em-"},{"section":"-em-rolebinding-em-"},{"section":"-em-role-em-"},{"section":"-em-quota-em-"},{"section":"-em-priorityclass-em-"},{"section":"-em-poddisruptionbudget-em-"},{"section":"-em-namespace-em-"},{"section":"-em-job-em-"},{"section":"-em-deployment-em-"},{"section":"-em-cronjob-em-"},{"section":"-em-configmap-em-"},{"section":"-em-clusterrolebinding-em-"},{"section":"-em-clusterrole-em-"}]},{"section":"-strong-getting-started-strong-","subsections":[]}],"flatToc":["rolling-update","-strong-deprecated-commands-strong-","version","-em-list-em-","plugin","options","kustomize","explain","-em-view-em-","-em-use-context-em-","-em-unset-em-","-em-set-credentials-em-","-em-set-context-em-","-em-set-cluster-em-","-em-set-em-","-em-rename-context-em-","-em-get-contexts-em-","-em-get-clusters-em-","-em-delete-context-em-","-em-delete-cluster-em-","-em-current-context-em-","config","completion","api-resources","alpha","-strong-kubectl-settings-and-usage-strong-","uncordon","taint","drain","cordon","-em-dump-em-","cluster-info","-em-deny-em-","-em-approve-em-","certificate","api-versions","-strong-cluster-management-strong-","-em-pod-em-","-em-node-em-","top","proxy","port-forward","logs","exec","describe","cp","-em-reconcile-em-","-em-can-i-em-","auth","attach","-strong-working-with-apps-strong-","wait","-em-subject-em-","-em-serviceaccount-em--1","-em-selector-em-","-em-resources-em-","-em-image-em-","-em-env-em-","set","scale","-em-undo-em-","-em-status-em-","-em-resume-em-","-em-pause-em-","-em-history-em-","rollout","replace","patch","label","edit","diff","convert","autoscale","annotate","-em-view-last-applied-em-","-em-set-last-applied-em-","-em-edit-last-applied-em-","apply","-strong-app-management-strong-","delete","expose","run","get","-em-serviceaccount-em-","-em-service-nodeport-em-","-em-service-loadbalancer-em-","-em-service-externalname-em-","-em-service-clusterip-em-","-em-service-em-","-em-secret-tls-em-","-em-secret-generic-em-","-em-secret-docker-registry-em-","-em-secret-em-","-em-rolebinding-em-","-em-role-em-","-em-quota-em-","-em-priorityclass-em-","-em-poddisruptionbudget-em-","-em-namespace-em-","-em-job-em-","-em-deployment-em-","-em-cronjob-em-","-em-configmap-em-","-em-clusterrolebinding-em-","-em-clusterrole-em-","create","-strong-getting-started-strong-"]};})();
\ No newline at end of file