Merge pull request #23305 from janetkuo/update-kubectl-help

Auto commit by PR queue bot

docs/man/man1/kubectl-autoscale.1

@@ -3,7 +3,7 @@
 
 .SH NAME
 .PP
-kubectl autoscale \- Auto\-scale a deployment or replication controller
+kubectl autoscale \- Auto\-scale a Deployment, ReplicaSet, or ReplicationController
 
 
 .SH SYNOPSIS
@@ -16,7 +16,7 @@ kubectl autoscale \- Auto\-scale a deployment or replication controller
 Creates an autoscaler that automatically chooses and sets the number of pods that run in a kubernetes cluster.
 
 .PP
-Looks up a deployment or replication controller by name and creates an autoscaler that uses this deployment or replication controller as a reference.
+Looks up a Deployment, ReplicaSet, 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.
 
 

docs/man/man1/kubectl-describe.1

@@ -27,11 +27,11 @@ will first check for an exact match on TYPE and NAME\_PREFIX. If no such resourc
 exists, it will output details for every resource that has a name prefixed with NAME\_PREFIX
 
 .PP
-Possible resource types include (case insensitive): pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-namespaces (ns), serviceaccounts, horizontalpodautoscalers (hpa),
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-endpoints (ep) or secrets.
+componentstatuses (cs), endpoints (ep), and secrets.
 
 
 .SH OPTIONS

docs/man/man1/kubectl-explain.1

@@ -16,11 +16,11 @@ kubectl explain \- Documentation of resources.
 Documentation of resources.
 
 .PP
-Possible resource types include: pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-resourcequotas (quota), namespaces (ns), horizontalpodautoscalers (hpa)
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-or endpoints (ep).
+componentstatuses (cs), endpoints (ep), and secrets.
 
 
 .SH OPTIONS

docs/man/man1/kubectl-expose.1

@@ -3,7 +3,7 @@
 
 .SH NAME
 .PP
-kubectl expose \- Take a replication controller, service or pod and expose it as a new Kubernetes Service
+kubectl expose \- Take a replication controller, service, or pod and expose it as a new Kubernetes Service
 
 
 .SH SYNOPSIS
@@ -13,15 +13,15 @@ kubectl expose \- Take a replication controller, service or pod and expose it as
 
 .SH DESCRIPTION
 .PP
-Take a replication controller, service, replica set, deployment or pod and expose it as a new Kubernetes service.
+Take a deployment, service, replica set, replication controller, or pod and expose it as a new Kubernetes service.
 
 .PP
-Looks up a replication controller, service, replica set, deployment or pod by name and uses the selector
+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 replica set will be exposed
+for that resource as the selector for a new service on the specified port. A deployment or replica set
-as a service only if it's selector is convertible to a selector that service supports, i.e. when the
+will be exposed as a service only if its selector is convertible to a selector that service supports,
-replica set selector contains only the matchLabels component. Note that if no port is specified
+i.e. when the selector contains only the matchLabels component. Note that if no port is specified via
-via \-\-port and the exposed resource has multiple ports, all will be re\-used by the new service. Also
+\-\-port and the exposed resource has multiple ports, all will be re\-used by the new service. Also if no
-if no labels are specified, the new service will re\-use the labels from the resource it exposes.
+labels are specified, the new service will re\-use the labels from the resource it exposes.
 
 
 .SH OPTIONS

docs/man/man1/kubectl-get.1

@@ -16,11 +16,11 @@ kubectl get \- Display one or many resources
 Display one or many resources.
 
 .PP
-Possible resource types include (case insensitive): pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-resourcequotas (quota), namespaces (ns), endpoints (ep),
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-horizontalpodautoscalers (hpa), serviceaccounts or secrets.
+componentstatuses (cs), endpoints (ep), and secrets.
 
 .PP
 By specifying the output as 'template' and providing a Go template as the value

docs/man/man1/kubectl-rollout-history.1

@@ -13,7 +13,7 @@ kubectl rollout history \- view rollout history
 
 .SH DESCRIPTION
 .PP
-view previous rollout revisions and configurations.
+View previous rollout revisions and configurations.
 
 
 .SH OPTIONS
@@ -128,6 +128,9 @@ view previous rollout revisions and configurations.
 # View the rollout history of a deployment
 kubectl rollout history deployment/abc
 
+# View the details of deployment revision 3
+kubectl rollout history deployment/abc \-\-revision=3
+
 .fi
 .RE
 

docs/man/man1/kubectl-rollout-undo.1

@@ -13,7 +13,7 @@ kubectl rollout undo \- undoes a previous rollout
 
 .SH DESCRIPTION
 .PP
-undo rolls back to a previous rollout.
+Rollback to a previous rollout.
 
 
 .SH OPTIONS
@@ -128,6 +128,9 @@ undo rolls back to a previous rollout.
 # Rollback to the previous deployment
 kubectl rollout undo deployment/abc
 
+# Rollback to deployment revision 3
+kubectl rollout undo deployment/abc \-\-to\-revision=3
+
 .fi
 .RE
 

docs/man/man1/kubectl-rollout.1

@@ -13,7 +13,7 @@ kubectl rollout \- rollout manages a deployment
 
 .SH DESCRIPTION
 .PP
-rollout manages a deployment using subcommands like "kubectl rollout undo deployment/abc"
+Manages a deployment using subcommands like "kubectl rollout undo deployment/abc"
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS

docs/man/man1/kubectl-scale.1

@@ -3,7 +3,7 @@
 
 .SH NAME
 .PP
-kubectl scale \- Set a new size for a Replication Controller, Job, or Deployment.
+kubectl scale \- Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 
 
 .SH SYNOPSIS
@@ -13,7 +13,7 @@ kubectl scale \- Set a new size for a Replication Controller, Job, or Deployment
 
 .SH DESCRIPTION
 .PP
-Set a new size for a Replication Controller, Job, or Deployment.
+Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 
 .PP
 Scale also allows users to specify one or more preconditions for the scale action.
@@ -151,8 +151,8 @@ scale is sent to the server.
 .RS
 
 .nf
-# Scale replication controller named 'foo' to 3.
+# Scale a replicaset named 'foo' to 3.
-kubectl scale \-\-replicas=3 rc/foo
+kubectl scale \-\-replicas=3 rs/foo
 
 # Scale a resource identified by type and name specified in "foo.yaml" to 3.
 kubectl scale \-\-replicas=3 \-f foo.yaml

docs/user-guide/kubectl/kubectl.md

@@ -80,7 +80,7 @@ kubectl
 * [kubectl api-versions](kubectl_api-versions.md)	 - Print the supported API versions on the server, in the form of "group/version".
 * [kubectl apply](kubectl_apply.md)	 - Apply a configuration to a resource by filename or stdin
 * [kubectl attach](kubectl_attach.md)	 - Attach to a running container.
-* [kubectl autoscale](kubectl_autoscale.md)	 - Auto-scale a deployment or replication controller
+* [kubectl autoscale](kubectl_autoscale.md)	 - Auto-scale a Deployment, ReplicaSet, or ReplicationController
 * [kubectl cluster-info](kubectl_cluster-info.md)	 - Display cluster info
 * [kubectl config](kubectl_config.md)	 - config modifies kubeconfig files
 * [kubectl convert](kubectl_convert.md)	 - Convert config files between different API versions
@@ -92,7 +92,7 @@ kubectl
 * [kubectl edit](kubectl_edit.md)	 - Edit a resource on the server
 * [kubectl exec](kubectl_exec.md)	 - Execute a command in a container.
 * [kubectl explain](kubectl_explain.md)	 - Documentation of resources.
-* [kubectl expose](kubectl_expose.md)	 - Take a replication controller, service or pod and expose it as a new Kubernetes Service
+* [kubectl expose](kubectl_expose.md)	 - Take a replication controller, service, or pod and expose it as a new Kubernetes Service
 * [kubectl get](kubectl_get.md)	 - Display one or many resources
 * [kubectl label](kubectl_label.md)	 - Update the labels on a resource
 * [kubectl logs](kubectl_logs.md)	 - Print the logs for a container in a pod.
@@ -104,11 +104,11 @@ kubectl
 * [kubectl rolling-update](kubectl_rolling-update.md)	 - Perform a rolling update of the given ReplicationController.
 * [kubectl rollout](kubectl_rollout.md)	 - rollout manages a deployment
 * [kubectl run](kubectl_run.md)	 - Run a particular image on the cluster.
-* [kubectl scale](kubectl_scale.md)	 - Set a new size for a Replication Controller, Job, or Deployment.
+* [kubectl scale](kubectl_scale.md)	 - Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 * [kubectl uncordon](kubectl_uncordon.md)	 - Mark node as schedulable
 * [kubectl version](kubectl_version.md)	 - Print the client and server version information.
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl.md?pixel)]()

docs/user-guide/kubectl/kubectl_autoscale.md

@@ -34,14 +34,14 @@ Documentation for other releases can be found at
 
 ## kubectl autoscale
 
-Auto-scale a deployment or replication controller
+Auto-scale a Deployment, ReplicaSet, or ReplicationController
 
 ### Synopsis
 
 
 Creates an autoscaler that automatically chooses and sets the number of pods that run in a kubernetes cluster.
 
-Looks up a deployment or replication controller by name and creates an autoscaler that uses this deployment or replication controller as a reference.
+Looks up a Deployment, ReplicaSet, 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.
 
 ```
@@ -110,7 +110,7 @@ kubectl autoscale rc foo --max=5 --cpu-percent=80
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_autoscale.md?pixel)]()

docs/user-guide/kubectl/kubectl_describe.md

@@ -49,11 +49,11 @@ $ 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
 
-Possible resource types include (case insensitive): pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-namespaces (ns), serviceaccounts, horizontalpodautoscalers (hpa),
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-endpoints (ep) or secrets.
+componentstatuses (cs), endpoints (ep), and secrets.
 
 ```
 kubectl describe (-f FILENAME | TYPE [NAME_PREFIX | -l label] | TYPE/NAME)
@@ -120,7 +120,7 @@ kubectl describe pods frontend
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_describe.md?pixel)]()

docs/user-guide/kubectl/kubectl_explain.md

@@ -41,11 +41,11 @@ Documentation of resources.
 
 Documentation of resources.
 
-Possible resource types include: pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-resourcequotas (quota), namespaces (ns), horizontalpodautoscalers (hpa)
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-or endpoints (ep).
+componentstatuses (cs), endpoints (ep), and secrets.
 
 ```
 kubectl explain RESOURCE
@@ -98,7 +98,7 @@ kubectl explain pods.spec.containers
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_explain.md?pixel)]()

docs/user-guide/kubectl/kubectl_expose.md

@@ -34,19 +34,19 @@ Documentation for other releases can be found at
 
 ## kubectl expose
 
-Take a replication controller, service or pod and expose it as a new Kubernetes Service
+Take a replication controller, service, or pod and expose it as a new Kubernetes Service
 
 ### Synopsis
 
 
-Take a replication controller, service, replica set, deployment or pod and expose it as a new Kubernetes service.
+Take a deployment, service, replica set, replication controller, or pod and expose it as a new Kubernetes service.
 
-Looks up a replication controller, service, replica set, deployment or pod by name and uses the selector
+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 replica set will be exposed
+for that resource as the selector for a new service on the specified port. A deployment or replica set
-as a service only if it's selector is convertible to a selector that service supports, i.e. when the
+will be exposed as a service only if its selector is convertible to a selector that service supports,
-replica set selector contains only the matchLabels component. Note that if no port is specified
+i.e. when the selector contains only the matchLabels component. Note that if no port is specified via
-via --port and the exposed resource has multiple ports, all will be re-used by the new service. Also
+--port and the exposed resource has multiple ports, all will be re-used by the new service. Also if no
-if no labels are specified, the new service will re-use the labels from the resource it exposes.
+labels are specified, the new service will re-use the labels from the resource it exposes.
 
 ```
 kubectl expose (-f FILENAME | TYPE NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type]
@@ -137,7 +137,7 @@ kubectl expose deployment nginx --port=80 --target-port=8000
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 19-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_expose.md?pixel)]()

docs/user-guide/kubectl/kubectl_get.md

@@ -41,11 +41,11 @@ Display one or many resources
 
 Display one or many resources.
 
-Possible resource types include (case insensitive): pods (po), services (svc),
+Possible resource types include (case insensitive): pods (po), services (svc), deployments,
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
-resourcequotas (quota), namespaces (ns), endpoints (ep),
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
-horizontalpodautoscalers (hpa), serviceaccounts or secrets.
+componentstatuses (cs), endpoints (ep), and secrets.
 
 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 resource(s).
@@ -132,7 +132,7 @@ kubectl get rc/web service/frontend pods/web-pod-13je7
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_get.md?pixel)]()

docs/user-guide/kubectl/kubectl_rollout.md

@@ -39,7 +39,7 @@ rollout manages a deployment
 ### Synopsis
 
 
-rollout manages a deployment using subcommands like "kubectl rollout undo deployment/abc"
+Manages a deployment using subcommands like "kubectl rollout undo deployment/abc"
 
 ```
 kubectl rollout SUBCOMMAND
@@ -87,7 +87,7 @@ kubectl rollout undo deployment/abc
 * [kubectl rollout resume](kubectl_rollout_resume.md)	 - Resume a paused resource
 * [kubectl rollout undo](kubectl_rollout_undo.md)	 - undoes a previous rollout
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 21-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_rollout.md?pixel)]()

docs/user-guide/kubectl/kubectl_rollout_history.md

@@ -39,7 +39,7 @@ view rollout history
 ### Synopsis
 
 
-view previous rollout revisions and configurations.
+View previous rollout revisions and configurations.
 
 ```
 kubectl rollout history (TYPE NAME | TYPE/NAME) [flags]
@@ -50,6 +50,9 @@ kubectl rollout history (TYPE NAME | TYPE/NAME) [flags]
 ```
 # View the rollout history of a deployment
 kubectl rollout history deployment/abc
+
+# View the details of deployment revision 3
+kubectl rollout history deployment/abc --revision=3
 ```
 
 ### Options
@@ -90,7 +93,7 @@ kubectl rollout history deployment/abc
 
 * [kubectl rollout](kubectl_rollout.md)	 - rollout manages a deployment
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 21-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_rollout_history.md?pixel)]()

docs/user-guide/kubectl/kubectl_rollout_undo.md

@@ -39,7 +39,7 @@ undoes a previous rollout
 ### Synopsis
 
 
-undo rolls back to a previous rollout.
+Rollback to a previous rollout.
 
 ```
 kubectl rollout undo (TYPE NAME | TYPE/NAME) [flags]
@@ -50,6 +50,9 @@ kubectl rollout undo (TYPE NAME | TYPE/NAME) [flags]
 ```
 # Rollback to the previous deployment
 kubectl rollout undo deployment/abc
+
+# Rollback to deployment revision 3
+kubectl rollout undo deployment/abc --to-revision=3
 ```
 
 ### Options
@@ -90,7 +93,7 @@ kubectl rollout undo deployment/abc
 
 * [kubectl rollout](kubectl_rollout.md)	 - rollout manages a deployment
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 21-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_rollout_undo.md?pixel)]()

docs/user-guide/kubectl/kubectl_scale.md

@@ -34,12 +34,12 @@ Documentation for other releases can be found at
 
 ## kubectl scale
 
-Set a new size for a Replication Controller, Job, or Deployment.
+Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 
 ### Synopsis
 
 
-Set a new size for a Replication Controller, Job, or Deployment.
+Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 
 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
@@ -53,8 +53,8 @@ kubectl scale [--resource-version=version] [--current-replicas=count] --replicas
 ### Examples
 
 ```
-# Scale replication controller named 'foo' to 3.
+# Scale a replicaset named 'foo' to 3.
-kubectl scale --replicas=3 rc/foo
+kubectl scale --replicas=3 rs/foo
 
 # Scale a resource identified by type and name specified in "foo.yaml" to 3.
 kubectl scale --replicas=3 -f foo.yaml
@@ -112,7 +112,7 @@ kubectl scale --replicas=3 job/cron
 
 * [kubectl](kubectl.md)	 - kubectl controls the Kubernetes cluster manager
 
-###### Auto generated by spf13/cobra on 2-Mar-2016
+###### Auto generated by spf13/cobra on 22-Mar-2016
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_scale.md?pixel)]()

pkg/kubectl/cmd/autoscale.go

@@ -31,7 +31,7 @@ import (
 const (
 	autoscaleLong = `Creates an autoscaler that automatically chooses and sets the number of pods that run in a kubernetes cluster.
 
-Looks up a deployment or replication controller by name and creates an autoscaler that uses this deployment or replication controller as a reference.
+Looks up a Deployment, ReplicaSet, 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.`
 
 	autoscaleExample = `# Auto scale a deployment "foo", with the number of pods between 2 to 10, target CPU utilization at a default value that server applies:
@@ -45,7 +45,7 @@ func NewCmdAutoscale(f *cmdutil.Factory, out io.Writer) *cobra.Command {
 	filenames := []string{}
 	cmd := &cobra.Command{
 		Use:     "autoscale (-f FILENAME | TYPE NAME | TYPE/NAME) [--min=MINPODS] --max=MAXPODS [--cpu-percent=CPU] [flags]",
-		Short:   "Auto-scale a deployment or replication controller",
+		Short:   "Auto-scale a Deployment, ReplicaSet, or ReplicationController",
 		Long:    autoscaleLong,
 		Example: autoscaleExample,
 		Run: func(cmd *cobra.Command, args []string) {

pkg/kubectl/cmd/describe.go

@@ -49,11 +49,7 @@ $ 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
 
-Possible resource types include (case insensitive): pods (po), services (svc),
+` + kubectl.PossibleResourceTypes
-replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
-persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota),
-namespaces (ns), serviceaccounts, horizontalpodautoscalers (hpa),
-endpoints (ep) or secrets.`
 	describe_example = `# Describe a node
 kubectl describe nodes kubernetes-minion-emt8.c.myproject.internal
 

pkg/kubectl/cmd/explain.go

@@ -36,11 +36,7 @@ kubectl explain pods.spec.containers`
 
 	explainLong = `Documentation of resources.
 
-Possible resource types include: pods (po), services (svc),
+` + kubectl.PossibleResourceTypes
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
-resourcequotas (quota), namespaces (ns), horizontalpodautoscalers (hpa)
-or endpoints (ep).`
 )
 
 // NewCmdExplain returns a cobra command for swagger docs

pkg/kubectl/cmd/expose.go

@@ -37,14 +37,14 @@ type ExposeOptions struct {
 }
 
 const (
-	expose_long = `Take a replication controller, service, replica set, deployment or pod and expose it as a new Kubernetes service.
+	expose_long = `Take a deployment, service, replica set, replication controller, or pod and expose it as a new Kubernetes service.
 
-Looks up a replication controller, service, replica set, deployment or pod by name and uses the selector 
+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 replica set will be exposed 
+for that resource as the selector for a new service on the specified port. A deployment or replica set
-as a service only if it's selector is convertible to a selector that service supports, i.e. when the
+will be exposed as a service only if its selector is convertible to a selector that service supports,
-replica set selector contains only the matchLabels component. Note that if no port is specified
+i.e. when the selector contains only the matchLabels component. Note that if no port is specified via
-via --port and the exposed resource has multiple ports, all will be re-used by the new service. Also
+--port and the exposed resource has multiple ports, all will be re-used by the new service. Also if no 
-if no labels are specified, the new service will re-use the labels from the resource it exposes.`
+labels are specified, the new service will re-use the labels from the resource it exposes.`
 
 	expose_example = `# Create a service for a replicated nginx, which serves on port 80 and connects to the containers on port 8000.
 kubectl expose rc nginx --port=80 --target-port=8000
@@ -73,7 +73,7 @@ func NewCmdExposeService(f *cmdutil.Factory, out io.Writer) *cobra.Command {
 
 	cmd := &cobra.Command{
 		Use:     "expose (-f FILENAME | TYPE NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [--external-ip=external-ip-of-service] [--type=type]",
-		Short:   "Take a replication controller, service or pod and expose it as a new Kubernetes Service",
+		Short:   "Take a replication controller, service, or pod and expose it as a new Kubernetes Service",
 		Long:    expose_long,
 		Example: expose_example,
 		Run: func(cmd *cobra.Command, args []string) {

pkg/kubectl/cmd/get.go

@@ -38,11 +38,7 @@ type GetOptions struct {
 const (
 	get_long = `Display one or many resources.
 
-Possible resource types include (case insensitive): pods (po), services (svc),
+` + kubectl.PossibleResourceTypes + `
-replicationcontrollers (rc), nodes (no), events (ev), componentstatuses (cs),
-limitranges (limits), persistentvolumes (pv), persistentvolumeclaims (pvc),
-resourcequotas (quota), namespaces (ns), endpoints (ep),
-horizontalpodautoscalers (hpa), serviceaccounts or secrets.
 
 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 resource(s).`

pkg/kubectl/cmd/rollout/rollout.go

@@ -24,7 +24,7 @@ import (
 )
 
 const (
-	rollout_long    = `rollout manages a deployment using subcommands like "kubectl rollout undo deployment/abc"`
+	rollout_long    = `Manages a deployment using subcommands like "kubectl rollout undo deployment/abc"`
 	rollout_example = `# Rollback to the previous deployment
 kubectl rollout undo deployment/abc`
 	rollout_valid_resources = `Valid resource types include:

pkg/kubectl/cmd/rollout/rollout_history.go

@@ -35,9 +35,12 @@ type HistoryOptions struct {
 }
 
 const (
-	history_long    = `view previous rollout revisions and configurations.`
+	history_long    = `View previous rollout revisions and configurations.`
 	history_example = `# View the rollout history of a deployment
-kubectl rollout history deployment/abc`
+kubectl rollout history deployment/abc
+
+# View the details of deployment revision 3
+kubectl rollout history deployment/abc --revision=3`
 )
 
 func NewCmdRolloutHistory(f *cmdutil.Factory, out io.Writer) *cobra.Command {

pkg/kubectl/cmd/rollout/rollout_undo.go

@@ -42,9 +42,12 @@ type UndoOptions struct {
 }
 
 const (
-	undo_long    = `undo rolls back to a previous rollout.`
+	undo_long    = `Rollback to a previous rollout.`
 	undo_example = `# Rollback to the previous deployment
-kubectl rollout undo deployment/abc`
+kubectl rollout undo deployment/abc
+
+# Rollback to deployment revision 3
+kubectl rollout undo deployment/abc --to-revision=3`
 )
 
 func NewCmdRolloutUndo(f *cmdutil.Factory, out io.Writer) *cobra.Command {

pkg/kubectl/cmd/scale.go

@@ -37,14 +37,14 @@ type ScaleOptions struct {
 }
 
 const (
-	scale_long = `Set a new size for a Replication Controller, Job, or Deployment.
+	scale_long = `Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.
 
 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.`
-	scale_example = `# Scale replication controller named 'foo' to 3.
+	scale_example = `# Scale a replicaset named 'foo' to 3.
-kubectl scale --replicas=3 rc/foo
+kubectl scale --replicas=3 rs/foo
 
 # Scale a resource identified by type and name specified in "foo.yaml" to 3.
 kubectl scale --replicas=3 -f foo.yaml
@@ -67,7 +67,7 @@ func NewCmdScale(f *cmdutil.Factory, out io.Writer) *cobra.Command {
 		Use: "scale [--resource-version=version] [--current-replicas=count] --replicas=COUNT (-f FILENAME | TYPE NAME)",
 		// resize is deprecated
 		Aliases: []string{"resize"},
-		Short:   "Set a new size for a Replication Controller, Job, or Deployment.",
+		Short:   "Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job.",
 		Long:    scale_long,
 		Example: scale_example,
 		Run: func(cmd *cobra.Command, args []string) {

pkg/kubectl/kubectl.go

@@ -28,7 +28,15 @@ import (
 	"k8s.io/kubernetes/pkg/api/unversioned"
 )
 
-const kubectlAnnotationPrefix = "kubectl.kubernetes.io/"
+const (
+	kubectlAnnotationPrefix = "kubectl.kubernetes.io/"
+	// TODO: auto-generate this
+	PossibleResourceTypes = `Possible resource types include (case insensitive): pods (po), services (svc), deployments,
+replicasets (rs), replicationcontrollers (rc), nodes (no), events (ev), limitranges (limits),
+persistentvolumes (pv), persistentvolumeclaims (pvc), resourcequotas (quota), namespaces (ns),
+serviceaccounts, ingresses (ing), horizontalpodautoscalers (hpa), daemonsets (ds), configmaps,
+componentstatuses (cs), endpoints (ep), and secrets.`
+)
 
 type NamespaceInfo struct {
 	Namespace string