scottk/kubernetes
1
0
Fork 0
mirror of https://github.com/optim-enterprises-bv/kubernetes.git synced 2025-11-03 19:58:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12421 from jlowdermilk/replace-help-text

Browse Source 
Clarify help text of kubectl replace
This commit is contained in:
Marek Grabowski
2015-08-10 16:34:17 +02:00
parent 5f9cefc1d8 1956484816
commit 9ddcfb7d54
3 changed files with 19 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
docs/man/man1/kubectl-replace.1
View File

@@ -16,7 +16,9 @@ kubectl replace \- Replace a resource by filename or stdin.
Replace a resource by filename or stdin. Replace a resource by filename or stdin.
.PP .PP
JSON and YAML formats are accepted. 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
.PP .PP
Please refer to the models in Please refer to the models in
@@ -162,6 +164,9 @@ $ kubectl replace \-f ./pod.json
// Replace a pod based on the JSON passed into stdin. // Replace a pod based on the JSON passed into stdin.
$ cat pod.json | kubectl replace \-f \- $ cat pod.json | kubectl replace \-f \-
// Update a single\-container pod's image version (tag) to v4
kubectl get pod mypod \-o yaml | sed 's/\\(image: myimage\\):.*$/\\1:v4/' | kubectl replace \-f \-
// Force replace, delete and then re\-create the resource // Force replace, delete and then re\-create the resource
kubectl replace \-\-force \-f ./pod.json kubectl replace \-\-force \-f ./pod.json

9
docs/user-guide/kubectl/kubectl_replace.md
View File

@@ -40,7 +40,9 @@ Replace a resource by filename or stdin.
Replace a resource by filename or stdin. Replace a resource by filename or stdin.
JSON and YAML formats are accepted. JSON and YAML formats are accepted. If replacing an existing resource, the
complete resource spec must be provided. This can be obtained by
$ kubectl get TYPE NAME -o yaml
Please refer to the models in https://htmlpreview.github.io/?https://github.com/GoogleCloudPlatform/kubernetes/HEAD/docs/api-reference/definitions.html to find if a field is mutable. Please refer to the models in https://htmlpreview.github.io/?https://github.com/GoogleCloudPlatform/kubernetes/HEAD/docs/api-reference/definitions.html to find if a field is mutable.
@@ -57,6 +59,9 @@ $ kubectl replace -f ./pod.json
// Replace a pod based on the JSON passed into stdin. // Replace a pod based on the JSON passed into stdin.
$ cat pod.json | kubectl replace -f - $ cat pod.json | kubectl replace -f -
// Update a single-container pod's image version (tag) to v4
kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*$/\1:v4/' | kubectl replace -f -
// Force replace, delete and then re-create the resource // Force replace, delete and then re-create the resource
kubectl replace --force -f ./pod.json kubectl replace --force -f ./pod.json
``` ```
@@ -106,7 +111,7 @@ kubectl replace --force -f ./pod.json
* [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-08-05 14:22:30.872347131 +0000 UTC ###### Auto generated by spf13/cobra at 2015-08-09 17:46:44.43991637 +0000 UTC
<!-- BEGIN MUNGE: GENERATED_ANALYTICS --> <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_replace.md?pixel)]() [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_replace.md?pixel)]()

7
pkg/kubectl/cmd/replace.go
View File

@@ -34,7 +34,9 @@ import (
const ( const (
replace_long = `Replace a resource by filename or stdin. replace_long = `Replace a resource by filename or stdin.
JSON and YAML formats are accepted. JSON and YAML formats are accepted. If replacing an existing resource, the
complete resource spec must be provided. This can be obtained by
$ kubectl get TYPE NAME -o yaml
Please refer to the models in https://htmlpreview.github.io/?https://github.com/GoogleCloudPlatform/kubernetes/HEAD/docs/api-reference/definitions.html to find if a field is mutable.` Please refer to the models in https://htmlpreview.github.io/?https://github.com/GoogleCloudPlatform/kubernetes/HEAD/docs/api-reference/definitions.html to find if a field is mutable.`
replace_example = `// Replace a pod using the data in pod.json. replace_example = `// Replace a pod using the data in pod.json.
@@ -43,6 +45,9 @@ $ kubectl replace -f ./pod.json
// Replace a pod based on the JSON passed into stdin. // Replace a pod based on the JSON passed into stdin.
$ cat pod.json | kubectl replace -f - $ cat pod.json | kubectl replace -f -
// Update a single-container pod's image version (tag) to v4
kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*$/\1:v4/' | kubectl replace -f -
// Force replace, delete and then re-create the resource // Force replace, delete and then re-create the resource
kubectl replace --force -f ./pod.json` kubectl replace --force -f ./pod.json`
) )