Deprecate kubectl stop command

Added deprecation warning for stop.
This commit is contained in:
hurf 2015-07-29 17:19:18 +08:00
parent dde72229dc
commit 35cac3c4e7
4 changed files with 19 additions and 9 deletions

View File

@ -3,7 +3,7 @@
.SH NAME .SH NAME
.PP .PP
kubectl stop \- Gracefully shut down a resource by name or filename. kubectl stop \- Deprecated: Gracefully shut down a resource by name or filename.
.SH SYNOPSIS .SH SYNOPSIS
@ -13,7 +13,11 @@ kubectl stop \- Gracefully shut down a resource by name or filename.
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
Gracefully shut down a resource by name or filename. Deprecated: Gracefully shut down a resource by name or filename.
.PP
stop command is deprecated, all its functionalities are covered by delete command.
See 'kubectl delete \-\-help' for more details.
.PP .PP
Attempts to shut down and delete a resource that supports graceful termination. Attempts to shut down and delete a resource that supports graceful termination.

View File

@ -97,10 +97,10 @@ kubectl
* [kubectl rolling-update](kubectl_rolling-update.md) - Perform a rolling update of the given ReplicationController. * [kubectl rolling-update](kubectl_rolling-update.md) - Perform a rolling update of the given ReplicationController.
* [kubectl run](kubectl_run.md) - Run a particular image on the cluster. * [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. * [kubectl scale](kubectl_scale.md) - Set a new size for a Replication Controller.
* [kubectl stop](kubectl_stop.md) - Gracefully shut down a resource by name or filename. * [kubectl stop](kubectl_stop.md) - Deprecated: Gracefully shut down a resource by name or filename.
* [kubectl version](kubectl_version.md) - Print the client and server version information. * [kubectl version](kubectl_version.md) - Print the client and server version information.
###### Auto generated by spf13/cobra at 2015-07-14 00:11:42.96000791 +0000 UTC ###### Auto generated by spf13/cobra at 2015-07-29 09:18:59.541696918 +0000 UTC
<!-- BEGIN MUNGE: GENERATED_ANALYTICS --> <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

View File

@ -33,12 +33,15 @@ Documentation for other releases can be found at
## kubectl stop ## kubectl stop
Gracefully shut down a resource by name or filename. Deprecated: Gracefully shut down a resource by name or filename.
### Synopsis ### Synopsis
Gracefully shut down a resource by name or filename. Deprecated: Gracefully shut down a resource by name or filename.
stop command is deprecated, all its functionalities are covered by delete command.
See 'kubectl delete --help' for more details.
Attempts to shut down and delete a resource that supports graceful termination. Attempts to shut down and delete a resource that supports graceful termination.
If the resource is scalable it will be scaled to 0 before deletion. If the resource is scalable it will be scaled to 0 before deletion.
@ -108,7 +111,7 @@ $ kubectl stop -f path/to/resources
* [kubectl](kubectl.md) - kubectl controls the Kubernetes cluster manager * [kubectl](kubectl.md) - kubectl controls the Kubernetes cluster manager
###### Auto generated by spf13/cobra at 2015-07-14 00:11:42.957441942 +0000 UTC ###### Auto generated by spf13/cobra at 2015-07-29 09:18:59.539597953 +0000 UTC
<!-- BEGIN MUNGE: GENERATED_ANALYTICS --> <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

View File

@ -27,7 +27,10 @@ import (
) )
const ( const (
stop_long = `Gracefully shut down a resource by name or filename. stop_long = `Deprecated: Gracefully shut down a resource by name or filename.
stop command is deprecated, all its functionalities are covered by delete command.
See 'kubectl delete --help' for more details.
Attempts to shut down and delete a resource that supports graceful termination. Attempts to shut down and delete a resource that supports graceful termination.
If the resource is scalable it will be scaled to 0 before deletion.` If the resource is scalable it will be scaled to 0 before deletion.`
@ -50,7 +53,7 @@ func NewCmdStop(f *cmdutil.Factory, out io.Writer) *cobra.Command {
}{} }{}
cmd := &cobra.Command{ cmd := &cobra.Command{
Use: "stop (-f FILENAME | RESOURCE (NAME | -l label | --all))", Use: "stop (-f FILENAME | RESOURCE (NAME | -l label | --all))",
Short: "Gracefully shut down a resource by name or filename.", Short: "Deprecated: Gracefully shut down a resource by name or filename.",
Long: stop_long, Long: stop_long,
Example: stop_example, Example: stop_example,
Run: func(cmd *cobra.Command, args []string) { Run: func(cmd *cobra.Command, args []string) {