diff --git a/static/docs/reference/generated/kubectl/kubectl-commands.html b/static/docs/reference/generated/kubectl/kubectl-commands.html index 38ea7571a9..9c06d9289e 100644 --- a/static/docs/reference/generated/kubectl/kubectl-commands.html +++ b/static/docs/reference/generated/kubectl/kubectl-commands.html @@ -45,7 +45,7 @@ inspect them.

Create a resource from a file or from stdin.

JSON and YAML formats are accepted.

Usage

-

$ create -f FILENAME

+

$ kubectl create -f FILENAME

Flags

@@ -127,7 +127,7 @@ inspect them.

- + @@ -177,7 +177,7 @@ inspect them.

Create a ClusterRole.

Usage

-

$ clusterrole NAME --verb=verb --resource=resource.group [--resource-name=resourcename] [--dry-run=server|client|none]

+

$ kubectl create clusterrole NAME --verb=verb --resource=resource.group [--resource-name=resourcename] [--dry-run=server|client|none]

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
@@ -241,7 +241,7 @@ inspect them.

- + @@ -266,7 +266,7 @@ inspect them.

Create a ClusterRoleBinding for a particular ClusterRole.

Usage

-

$ clusterrolebinding NAME --clusterrole=NAME [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

+

$ kubectl create clusterrolebinding NAME --clusterrole=NAME [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

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
@@ -330,7 +330,7 @@ inspect them.

- + @@ -372,7 +372,7 @@ inspect them.

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=server|client|none]

+

$ kubectl create configmap NAME [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run=server|client|none]

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
@@ -442,7 +442,7 @@ inspect them.

- + @@ -471,7 +471,7 @@ inspect them.

Create a cronjob with the specified name.

Usage

-

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

+

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

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
@@ -529,7 +529,7 @@ inspect them.

- + @@ -548,7 +548,7 @@ inspect them.

Create a deployment with the specified name.

Usage

-

$ deployment NAME --image=image [--dry-run=server|client|none]

+

$ kubectl create deployment NAME --image=image [--dry-run=server|client|none]

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
@@ -600,7 +600,7 @@ inspect them.

- + @@ -629,7 +629,7 @@ inspect them.

Create a job with the specified name.

Usage

-

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

+

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

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
@@ -681,7 +681,7 @@ inspect them.

- + @@ -700,7 +700,7 @@ inspect them.

Create a namespace with the specified name.

Usage

-

$ namespace NAME [--dry-run=server|client|none]

+

$ kubectl create namespace NAME [--dry-run=server|client|none]

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
@@ -746,7 +746,7 @@ inspect them.

- + @@ -770,7 +770,7 @@ inspect them.

Create a pod disruption budget with the specified name, selector, and desired minimum available pods

Usage

-

$ poddisruptionbudget NAME --selector=SELECTOR --min-available=N [--dry-run=server|client|none]

+

$ kubectl create poddisruptionbudget NAME --selector=SELECTOR --min-available=N [--dry-run=server|client|none]

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
@@ -834,7 +834,7 @@ inspect them.

- + @@ -863,7 +863,7 @@ inspect them.

Create a priorityclass with the specified name, value, globalDefault and description

Usage

-

$ priorityclass NAME --value=VALUE --global-default=BOOL [--dry-run=server|client|none]

+

$ kubectl create priorityclass NAME --value=VALUE --global-default=BOOL [--dry-run=server|client|none]

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
@@ -927,7 +927,7 @@ inspect them.

- + @@ -957,7 +957,7 @@ inspect them.

Create a resourcequota with the specified name, hard limits and optional scopes

Usage

-

$ quota NAME [--hard=key1=value1,key2=value2] [--scopes=Scope1,Scope2] [--dry-run=server|client|none]

+

$ kubectl create quota NAME [--hard=key1=value1,key2=value2] [--scopes=Scope1,Scope2] [--dry-run=server|client|none]

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
@@ -1015,7 +1015,7 @@ inspect them.

- + @@ -1049,7 +1049,7 @@ inspect them.

Create a role with single rule.

Usage

-

$ role NAME --verb=verb --resource=resource.group/subresource [--resource-name=resourcename] [--dry-run=server|client|none]

+

$ kubectl create role NAME --verb=verb --resource=resource.group/subresource [--resource-name=resourcename] [--dry-run=server|client|none]

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
@@ -1101,7 +1101,7 @@ inspect them.

- + @@ -1126,7 +1126,7 @@ inspect them.

Create a RoleBinding for a particular Role or ClusterRole.

Usage

-

$ rolebinding NAME --clusterrole=NAME|--role=NAME [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

+

$ kubectl create rolebinding NAME --clusterrole=NAME|--role=NAME [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

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
@@ -1196,7 +1196,7 @@ inspect them.

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

secret

Create a secret using specified subcommand.

Usage

-

$ secret

+

$ kubectl create secret

secret docker-registry

@@ -1227,7 +1227,7 @@ inspect them.

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.

Usage

-

$ docker-registry NAME --docker-username=user --docker-password=password --docker-email=email [--docker-server=string] [--from-literal=key1=value1] [--dry-run=server|client|none]

+

$ kubectl create docker-registry NAME --docker-username=user --docker-password=password --docker-email=email [--docker-server=string] [--from-literal=key1=value1] [--dry-run=server|client|none]

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
@@ -1309,7 +1309,7 @@ inspect them.

- + @@ -1351,7 +1351,7 @@ inspect them.

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=server|client|none]

+

$ kubectl create generic NAME [--type=string] [--from-file=[key=]source] [--from-literal=key1=value1] [--dry-run=server|client|none]

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
@@ -1421,7 +1421,7 @@ inspect them.

- + @@ -1447,7 +1447,7 @@ inspect them.

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=server|client|none]

+

$ kubectl create tls NAME --cert=path/to/cert/file --key=path/to/key/file [--dry-run=server|client|none]

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].
type
@@ -1511,7 +1511,7 @@ inspect them.

- + @@ -1525,7 +1525,7 @@ inspect them.

service

Create a service using specified subcommand.

Usage

-

$ service

+

$ kubectl create service

service clusterip

@@ -1540,7 +1540,7 @@ inspect them.

Create a ClusterIP service with the specified name.

Usage

-

$ clusterip NAME [--tcp=<port>:<targetPort>] [--dry-run=server|client|none]

+

$ kubectl create clusterip NAME [--tcp=<port>:<targetPort>] [--dry-run=server|client|none]

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
@@ -1598,7 +1598,7 @@ inspect them.

- + @@ -1618,7 +1618,7 @@ inspect them.

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=server|client|none]

+

$ kubectl create externalname NAME --external-name external.name [--dry-run=server|client|none]

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
@@ -1676,7 +1676,7 @@ inspect them.

- + @@ -1695,7 +1695,7 @@ inspect them.

Create a LoadBalancer service with the specified name.

Usage

-

$ loadbalancer NAME [--tcp=port:targetPort] [--dry-run=server|client|none]

+

$ kubectl create loadbalancer NAME [--tcp=port:targetPort] [--dry-run=server|client|none]

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
@@ -1747,7 +1747,7 @@ inspect them.

- + @@ -1766,7 +1766,7 @@ inspect them.

Create a NodePort service with the specified name.

Usage

-

$ nodeport NAME [--tcp=port:targetPort] [--dry-run=server|client|none]

+

$ kubectl create nodeport NAME [--tcp=port:targetPort] [--dry-run=server|client|none]

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
@@ -1824,7 +1824,7 @@ inspect them.

- + @@ -1843,7 +1843,7 @@ inspect them.

Create a service account with the specified name.

Usage

-

$ serviceaccount NAME [--dry-run=server|client|none]

+

$ kubectl create serviceaccount NAME [--dry-run=server|client|none]

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
@@ -1889,7 +1889,7 @@ inspect them.

- + @@ -1962,7 +1962,7 @@ inspect them.

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]

+

$ kubectl 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]

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
@@ -2038,7 +2038,7 @@ inspect them.

- + @@ -2092,7 +2092,7 @@ inspect them.

- + @@ -2163,7 +2163,7 @@ inspect them.

Create and run a particular image in a pod.

Usage

-

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

+

$ kubectl run NAME --image=image [--env="key=value"] [--port=port] [--dry-run=server|client] [--overrides=inline-json] [--command] -- [COMMAND] [args...]

Flags

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].
output-watch-events 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].
use-openapi-print-columns
@@ -2341,7 +2341,7 @@ inspect them.

- + @@ -2389,7 +2389,7 @@ inspect them.

- + @@ -2453,7 +2453,7 @@ inspect them.

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]

+

$ kubectl 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

restart AlwaysThe restart policy for this Pod. Legal values [Always, OnFailure, Never]. If set to 'Always' a deployment is created, if set to 'OnFailure' a job is created, if set to 'Never', a regular pod is created. For the latter two --replicas must be 1. Default 'Always', for CronJobs Never. The restart policy for this Pod. Legal values [Always, OnFailure, Never]. If set to 'Always' a deployment is created, if set to 'OnFailure' a job is created, if set to 'Never', a regular pod is created. For the latter two --replicas must be 1. Default 'Always', for CronJobs Never.
rm 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
@@ -2595,7 +2595,7 @@ inspect them.

- + @@ -2653,7 +2653,7 @@ inspect them.

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] | [-k DIRECTORY] | TYPE [(NAME | -l label | --all)])

+

$ kubectl 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].
type
@@ -2803,7 +2803,7 @@ viewing your workloads in a Kubernetes cluster.

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 | -k DIRECTORY)

+

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

Flags

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

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

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)

+

$ kubectl apply edit-last-applied (RESOURCE/NAME | -f FILENAME)

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].
timeout
@@ -3031,7 +3031,7 @@ viewing your workloads in a Kubernetes cluster.

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

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

+

$ kubectl apply set-last-applied -f FILENAME

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].
windows-line-endings
@@ -3106,7 +3106,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].
@@ -3125,7 +3125,7 @@ viewing your workloads in a Kubernetes cluster.

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)

+

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

Flags

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

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]

+

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

Flags

@@ -3306,7 +3306,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].
@@ -3325,7 +3325,7 @@ viewing your workloads in a Kubernetes cluster.

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]

+

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

Flags

@@ -3419,7 +3419,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].
@@ -3444,7 +3444,7 @@ viewing your workloads in a Kubernetes cluster.

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

+

$ kubectl convert -f FILENAME

Flags

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

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

Exit status: 0 No differences were found. 1 Differences were found. >1 Kubectl or diff failed with an error.

Note: KUBECTL_EXTERNAL_DIFF, if used, is expected to follow that convention.

Usage

-

$ diff -f FILENAME

+

$ kubectl diff -f FILENAME

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
@@ -3609,7 +3609,7 @@ viewing your workloads in a Kubernetes cluster.

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)

+

$ kubectl edit (RESOURCE/NAME | -f FILENAME)

Flags

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

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

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>

+

$ kubectl kustomize <dir>

label

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

  • If --resource-version is specified, then updates will use this resource version, otherwise the existing resource-version will be used.

    • Usage

    -

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

    +

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

    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
    @@ -3851,7 +3851,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].
    @@ -3885,7 +3885,7 @@ viewing your workloads in a Kubernetes cluster.

    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

    +

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

    Flags

    @@ -3955,13 +3955,13 @@ 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 strategicThe type of patch being provided; one of [json merge strategic] The type of patch being provided; one of [json merge strategic]
    @@ -3991,7 +3991,7 @@ viewing your workloads in a Kubernetes cluster.

    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

    Usage

    -

    $ replace -f FILENAME

    +

    $ kubectl replace -f FILENAME

    Flags

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

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

  • statefulsets

    • Usage

    -

    $ rollout SUBCOMMAND

    +

    $ kubectl rollout SUBCOMMAND

    history

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

    View previous rollout revisions and configurations.

    Usage

    -

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

    +

    $ kubectl rollout history (TYPE NAME | TYPE/NAME) [flags]

    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].
    timeout
    @@ -4182,7 +4182,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].
    @@ -4196,7 +4196,7 @@ viewing your workloads in a Kubernetes cluster.

    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

    +

    $ kubectl rollout pause RESOURCE

    Flags

    @@ -4242,7 +4242,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].
    @@ -4261,7 +4261,7 @@ viewing your workloads in a Kubernetes cluster.

    Restart a resource.

    Resource will be rollout restarted.

    Usage

    -

    $ restart RESOURCE

    +

    $ kubectl rollout restart RESOURCE

    Flags

    @@ -4307,7 +4307,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].
    @@ -4321,7 +4321,7 @@ viewing your workloads in a Kubernetes cluster.

    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

    +

    $ kubectl rollout resume RESOURCE

    Flags

    @@ -4367,7 +4367,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].
    @@ -4381,7 +4381,7 @@ viewing your workloads in a Kubernetes cluster.

    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]

    +

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

    Flags

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

    Rollback to a previous rollout.

    Usage

    -

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

    +

    $ kubectl rollout undo (TYPE NAME | TYPE/NAME) [flags]

    Flags

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

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

    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)

    +

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

    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].
    to-revision
    @@ -4625,7 +4625,7 @@ viewing your workloads in a Kubernetes cluster.

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

    Configure application resources

    These commands help you make changes to existing application resources.

    Usage

    -

    $ set SUBCOMMAND

    +

    $ kubectl set SUBCOMMAND

    env

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

    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

    +

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

    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].
    timeout
    @@ -4822,7 +4822,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].
    @@ -4852,7 +4852,7 @@ viewing your workloads in a Kubernetes cluster.

    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

    +

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

    Flags

    @@ -4928,7 +4928,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].
    @@ -4958,7 +4958,7 @@ viewing your workloads in a Kubernetes cluster.

    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]

    +

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

    Flags

    @@ -5052,7 +5052,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].
    @@ -5067,7 +5067,7 @@ kubectl create deployment my-dep -o yaml --dry-run<

    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]

    +

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

    Flags

    @@ -5137,7 +5137,7 @@ kubectl create deployment my-dep -o yaml --dry-run< - +
    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].
    @@ -5157,7 +5157,7 @@ kubectl create deployment my-dep -o yaml --dry-run<

    Possible resources (case insensitive) can be:

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

    Usage

    -

    $ serviceaccount (-f FILENAME | TYPE NAME) SERVICE_ACCOUNT

    +

    $ kubectl set serviceaccount (-f FILENAME | TYPE NAME) SERVICE_ACCOUNT

    Flags

    @@ -5227,7 +5227,7 @@ kubectl create deployment my-dep -o yaml --dry-run< - +
    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].
    @@ -5250,7 +5250,7 @@ kubectl create deployment my-dep -o yaml --dry-run<

    Update User, Group or ServiceAccount in a RoleBinding/ClusterRoleBinding.

    Usage

    -

    $ subject (-f FILENAME | TYPE NAME) [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

    +

    $ kubectl set subject (-f FILENAME | TYPE NAME) [--user=username] [--group=groupname] [--serviceaccount=namespace:serviceaccountname] [--dry-run=server|client|none]

    Flags

    @@ -5332,7 +5332,7 @@ kubectl create deployment my-dep -o yaml --dry-run< - +
    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].
    @@ -5354,7 +5354,7 @@ kubectl wait --for=delete pod/busybox1 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 ([-f FILENAME] | resource.group/resource.name | resource.group [(-l label | --all)]) [--for=delete|--for condition=available]

    +

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

    Flags

    @@ -5400,7 +5400,7 @@ kubectl wait --for=delete pod/busybox1 for - + @@ -5430,7 +5430,7 @@ kubectl wait --for=delete pod/busybox1 template - + @@ -5472,7 +5472,7 @@ applications.

    Attach to a process that is already running inside an existing container.

    Usage

    -

    $ attach (POD | TYPE/NAME) -c CONTAINER

    +

    $ kubectl attach (POD | TYPE/NAME) -c CONTAINER

    Flags

    The condition to wait on: [delete|condition=condition-name]. The condition to wait on: [delete|condition=condition-name].
    local 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
    @@ -5514,7 +5514,7 @@ applications.

    auth

    Inspect authorization

    Usage

    -

    $ auth

    +

    $ kubectl auth

    can-i

    @@ -5555,7 +5555,7 @@ applications.

    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]

    +

    $ kubectl auth can-i VERB [TYPE | TYPE/NAME | NONRESOURCEURL]

    Flags

    @@ -5612,7 +5612,7 @@ applications.

    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

    +

    $ kubectl auth reconcile -f FILENAME

    Flags

    @@ -5676,7 +5676,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].
    @@ -5714,7 +5714,7 @@ applications.

    Copy files and directories to and from containers.

    Usage

    -

    $ cp <file-spec-src> <file-spec-dest>

    +

    $ kubectl cp <file-spec-src> <file-spec-dest>

    Flags

    @@ -5778,7 +5778,7 @@ applications.

    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)

    +

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

    Flags

    @@ -5862,7 +5862,7 @@ applications.

    Execute a command in a container.

    Usage

    -

    $ exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...]

    +

    $ kubectl exec (POD | TYPE/NAME) [-c CONTAINER] [flags] -- COMMAND [args...]

    Flags

    @@ -5965,7 +5965,7 @@ applications.

    Print the logs for a container in a pod or specified resource. If the pod has only one container, the container name is optional.

    Usage

    -

    $ logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]

    +

    $ kubectl logs [-f] [-p] (POD | TYPE/NAME) [-c CONTAINER]

    Flags

    @@ -6110,7 +6110,7 @@ applications.

    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]

    +

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

    Flags

    @@ -6170,7 +6170,7 @@ applications.

    Creates a proxy server or application-level gateway between localhost and the Kubernetes API Server. It also allows serving static content over specified HTTP path. All incoming data enters through one port and gets forwarded to the remote kubernetes API Server port, except for the path matching the static content path.

    Usage

    -

    $ proxy [--port=PORT] [--www=static-dir] [--www-prefix=prefix] [--api-prefix=prefix]

    +

    $ kubectl proxy [--port=PORT] [--www=static-dir] [--www-prefix=prefix] [--api-prefix=prefix]

    Flags

    @@ -6262,7 +6262,7 @@ applications.

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

    This command requires Metrics Server to be correctly configured and working on the server.

    Usage

    -

    $ top

    +

    $ kubectl top

    node

    @@ -6278,7 +6278,7 @@ applications.

    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]

    +

    $ kubectl top node [NAME | -l label]

    Flags

    @@ -6360,7 +6360,7 @@ applications.

    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]

    +

    $ kubectl top pod [NAME | -l label]

    Flags

    @@ -6438,19 +6438,19 @@ applications.

    Print the supported API versions on the server, in the form of "group/version"

    Usage

    -

    $ api-versions

    +

    $ kubectl api-versions

    certificate

    Modify certificate resources.

    Usage

    -

    $ certificate SUBCOMMAND

    +

    $ kubectl 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.

    Usage

    -

    $ approve (-f FILENAME | NAME)

    +

    $ kubectl certificate approve (-f FILENAME | NAME)

    Flags

    @@ -6502,7 +6502,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].
    @@ -6511,7 +6511,7 @@ applications.

    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)

    +

    $ kubectl certificate deny (-f FILENAME | NAME)

    Flags

    @@ -6563,7 +6563,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].
    @@ -6576,7 +6576,7 @@ applications.

    Display addresses of the master and services with label kubernetes.io/cluster-service=true To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

    Usage

    -

    $ cluster-info

    +

    $ kubectl cluster-info

    dump

    @@ -6602,7 +6602,7 @@ applications.

    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

    +

    $ kubectl cluster-info dump

    Flags

    @@ -6654,7 +6654,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].
    @@ -6667,7 +6667,7 @@ applications.

    Mark node as unschedulable.

    Usage

    -

    $ cordon NODE

    +

    $ kubectl cordon NODE

    Flags

    @@ -6711,7 +6711,7 @@ applications.

    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

    +

    $ kubectl drain NODE

    Flags

    @@ -6822,7 +6822,7 @@ applications.

  • Currently taint can only apply to node.

    • Usage

    -

    $ taint NODE NAME KEY_1=VAL_1:TAINT_EFFECT_1 ... KEY_N=VAL_N:TAINT_EFFECT_N

    +

    $ kubectl taint NODE NAME KEY_1=VAL_1:TAINT_EFFECT_1 ... KEY_N=VAL_N:TAINT_EFFECT_N

    Flags

    @@ -6874,7 +6874,7 @@ applications.

    - + @@ -6893,7 +6893,7 @@ applications.

    Mark node as schedulable.

    Usage

    -

    $ uncordon NODE

    +

    $ kubectl uncordon NODE

    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
    @@ -6924,7 +6924,7 @@ applications.

    alpha

    These commands correspond to alpha features that are not enabled in Kubernetes clusters by default.

    Usage

    -

    $ alpha

    +

    $ kubectl alpha

    debug

    @@ -6939,7 +6939,7 @@ applications.

    Tools for debugging Kubernetes resources

    Usage

    -

    $ debug NAME --image=image [ -- COMMAND [args...] ]

    +

    $ kubectl alpha debug NAME --image=image [ -- COMMAND [args...] ]

    Flags

    @@ -7047,7 +7047,7 @@ applications.

    Print the supported API resources on the server

    Usage

    -

    $ api-resources

    +

    $ kubectl api-resources

    Flags

    @@ -7150,9 +7150,9 @@ source $HOME/.bash_profile

    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

    +

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

    Usage

    -

    $ completion SHELL

    +

    $ kubectl completion SHELL

    config

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

    @@ -7163,7 +7163,7 @@ source $HOME/.bash_profile
  • Otherwise, ${HOME}/.kube/config is used and no merging takes place.

    • Usage

    -

    $ config SUBCOMMAND

    +

    $ kubectl config SUBCOMMAND

    current-context

    @@ -7173,7 +7173,7 @@ source $HOME/.bash_profile

    Displays the current-context

    Usage

    -

    $ current-context

    +

    $ kubectl config current-context

    delete-cluster

    @@ -7183,7 +7183,7 @@ source $HOME/.bash_profile

    Delete the specified cluster from the kubeconfig

    Usage

    -

    $ delete-cluster NAME

    +

    $ kubectl config delete-cluster NAME

    delete-context

    @@ -7193,7 +7193,7 @@ source $HOME/.bash_profile

    Delete the specified context from the kubeconfig

    Usage

    -

    $ delete-context NAME

    +

    $ kubectl config delete-context NAME

    get-clusters

    @@ -7203,7 +7203,7 @@ source $HOME/.bash_profile

    Display clusters defined in the kubeconfig.

    Usage

    -

    $ get-clusters

    +

    $ kubectl config get-clusters

    get-contexts

    @@ -7218,7 +7218,7 @@ source $HOME/.bash_profile

    Displays one or many contexts from the kubeconfig file.

    Usage

    -

    $ get-contexts [(-o|--output=)name)]

    +

    $ kubectl config get-contexts [(-o|--output=)name)]

    Flags

    @@ -7256,7 +7256,7 @@ source $HOME/.bash_profile

    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

    +

    $ kubectl config rename-context CONTEXT_NAME NEW_NAME

    set

    @@ -7284,7 +7284,7 @@ source $HOME/.bash_profile

    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

    +

    $ kubectl config set PROPERTY_NAME PROPERTY_VALUE

    Flags

    @@ -7300,7 +7300,7 @@ source $HOME/.bash_profile - +
    set-raw-bytes falseWhen writing a []byte PROPERTY_VALUE, write the given string directly without base64 decoding. When writing a []byte PROPERTY_VALUE, write the given string directly without base64 decoding.
    @@ -7329,7 +7329,7 @@ source $HOME/.bash_profile

    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] [--tls-server-name=example.com]

    +

    $ kubectl config set-cluster NAME [--server=server] [--certificate-authority=path/to/certificate/authority] [--insecure-skip-tls-verify=true] [--tls-server-name=example.com]

    Flags

    @@ -7359,7 +7359,7 @@ source $HOME/.bash_profile

    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]

    +

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

    Flags

    @@ -7441,7 +7441,7 @@ source $HOME/.bash_profile --username=basic_user --password=basic_password

    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] [--exec-command=exec_command] [--exec-api-version=exec_api_version] [--exec-arg=arg] [--exec-env=key=value]

    +

    $ kubectl config 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] [--exec-command=exec_command] [--exec-api-version=exec_api_version] [--exec-arg=arg] [--exec-env=key=value]

    Flags

    @@ -7512,7 +7512,7 @@ source $HOME/.bash_profile

    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

    +

    $ kubectl config unset PROPERTY_NAME

    use-context

    @@ -7522,7 +7522,7 @@ source $HOME/.bash_profile

    Sets the current-context in a kubeconfig file

    Usage

    -

    $ use-context CONTEXT_NAME

    +

    $ kubectl config use-context CONTEXT_NAME

    view

    @@ -7543,7 +7543,7 @@ source $HOME/.bash_profile

    Display merged kubeconfig settings or a specified kubeconfig file.

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

    Usage

    -

    $ view

    +

    $ kubectl config view

    Flags

    @@ -7595,7 +7595,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].
    @@ -7613,11 +7613,11 @@ source $HOME/.bash_profile

    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:

    -

    <type>.<fieldName>[.<fieldName>]

    +

    <type>.<fieldName>[.<fieldName>]

    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

    +

    $ kubectl explain RESOURCE

    Flags

    @@ -7652,20 +7652,20 @@ source $HOME/.bash_profile

    Print the list of flags inherited by all commands

    Usage

    -

    $ options

    +

    $ kubectl 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.

    The easiest way to discover and install plugins is via the kubernetes sub-project krew. To install krew, visithttps://github.com/kubernetes-sigs/krew/#installation

    Usage

    -

    $ plugin [flags]

    +

    $ kubectl 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-"

    Usage

    -

    $ list

    +

    $ kubectl plugin list

    Flags

    @@ -7694,7 +7694,7 @@ source $HOME/.bash_profile

    Print the client and server version information for the current context

    Usage

    -

    $ version

    +

    $ kubectl version

    Flags