384 lines
22 KiB
Plaintext
384 lines
22 KiB
Plaintext
When you run the generator for the kubectl command ref docs,
|
|
you get a set of markdown files in
|
|
kubernetes-incubator/reference-docs/gen-kubectldocs/generators/build/documents.
|
|
|
|
This file is a diff of the build/documents directory for 1.11
|
|
and the build/documents directory for 1.12.
|
|
|
|
|
|
diff -r v1_11/_generated_apply.md v1_12/_generated_apply.md
|
|
56c56
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
62a63
|
|
> server-dry-run | | false | If true, request will be sent to server with dry-run flag, which means the modifications won't be persisted. This is an alpha feature and flag.
|
|
105a107
|
|
> allow-missing-template-keys | | true | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
|
|
108c110
|
|
< output | o | yaml | Output format. One of: yaml|json.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
110a113
|
|
> 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].
|
|
154c157
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_auth.md v1_12/_generated_auth.md
|
|
105c105
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
106a107,108
|
|
> remove-extra-permissions | | false | If true, removes extra permissions added to roles
|
|
> remove-extra-subjects | | false | If true, removes extra subjects added to rolebindings
|
|
|
|
|
|
diff -r v1_11/_generated_autoscale.md v1_12/_generated_autoscale.md
|
|
41c41
|
|
< output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_certificate.md v1_12/_generated_certificate.md
|
|
70c70
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_cluster-info.md v1_12/_generated_cluster-info.md
|
|
67c67
|
|
< output | o | json | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | json | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath-file|jsonpath.
|
|
|
|
|
|
diff -r v1_11/_generated_completion.md v1_12/_generated_completion.md
|
|
24c24
|
|
< >bdocs-tab:example Installing bash completion on Linux ## Load the kubectl completion code for bash into the current shell
|
|
---
|
|
> >bdocs-tab:example Installing bash completion on Linux ## If bash-completion is not installed on Linux, please install the 'bash-completion' package ## via your distribution's package manager. ## Load the kubectl completion code for bash into the current shell
|
|
|
|
|
|
diff -r v1_11/_generated_config.md v1_12/_generated_config.md
|
|
12,13c12,13
|
|
< 1. If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.
|
|
< 2. If $KUBECONFIG environment variable is set, then it is used a list of paths (normal path delimitting rules for your system). These paths are merged. When a value is modified, it is modified in the file that defines the stanza. When a value is created, it is created in the first file that exists. If no files in the chain exist, then it creates the last file in the list.
|
|
---
|
|
> 1. If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.
|
|
> 2. If $KUBECONFIG environment variable is set, then it is used as a list of paths (normal path delimitting rules for your system). These paths are merged. When a value is modified, it is modified in the file that defines the stanza. When a value is created, it is created in the first file that exists. If no files in the chain exist, then it creates the last file in the list.
|
|
246c246
|
|
< `$ set-context NAME [--cluster=cluster_nickname] [--user=user_nickname] [--namespace=namespace]`
|
|
---
|
|
> `$ set-context [NAME | --current] [--cluster=cluster_nickname] [--user=user_nickname] [--namespace=namespace]`
|
|
249a250,256
|
|
> ### Flags
|
|
>
|
|
> Name | Shorthand | Default | Usage
|
|
> ---- | --------- | ------- | -----
|
|
> current | | false | Modify the current context
|
|
>
|
|
>
|
|
414c421
|
|
< output | o | yaml | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | yaml | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_convert.md v1_12/_generated_convert.md
|
|
44,45c44,45
|
|
< output | o | yaml | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
< output-version | | | Output the formatted object with the given group version (for ex: 'extensions/v1beta1').)
|
|
---
|
|
> output | o | yaml | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
> output-version | | | Output the formatted object with the given group version (for ex: 'extensions/v1beta1').
|
|
|
|
|
|
diff -r v1_11/_generated_create.md v1_12/_generated_create.md
|
|
111c111
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
217c217
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
251c251
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
261a262,273
|
|
> >bdocs-tab:example Create a job
|
|
>
|
|
> ```bdocs-tab:example_shell
|
|
> kubectl create job my-job --image=busybox
|
|
> ```
|
|
>
|
|
> >bdocs-tab:example Create a job with command
|
|
>
|
|
> ```bdocs-tab:example_shell
|
|
> kubectl create job my-job --image=busybox -- date
|
|
> ```
|
|
>
|
|
273c285
|
|
< `$ job NAME [--from=CRONJOB]`
|
|
---
|
|
> `$ job NAME [--image=image --from=cronjob/name] -- [COMMAND] [args...]`
|
|
283a296
|
|
> image | | | Image name to run.
|
|
358c371
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
373c386
|
|
< kubectl create priorityclass default-priority --value=1000 --description="high priority"
|
|
---
|
|
> kubectl create priorityclass high-priority --value=1000 --description="high priority"
|
|
400c413
|
|
< output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
441c454
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
530c543
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
664c677
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
795c808
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
829c842
|
|
< output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
864c877
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
898c911
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_edit.md v1_12/_generated_edit.md
|
|
56c56
|
|
< output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_expose.md v1_12/_generated_expose.md
|
|
59c59
|
|
< `$ 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]`
|
|
---
|
|
> `$ 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]`
|
|
77c77
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_label.md v1_12/_generated_label.md
|
|
68c68
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_logs.md v1_12/_generated_logs.md
|
|
76d75
|
|
< interactive | | false | If true, prompt the user for input when required.
|
|
|
|
|
|
diff -r v1_11/_generated_patch.md v1_12/_generated_patch.md
|
|
57c57
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_plugin.md v1_12/_generated_plugin.md
|
|
8c8
|
|
< Runs a command-line plugin.
|
|
---
|
|
> Provides utilities for interacting with plugins.
|
|
10c10
|
|
< Plugins are subcommands that are not part of the major command-line distribution and can even be provided by third-parties. Please refer to the documentation and examples for more information about how to install and write your own 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.
|
|
14c14,38
|
|
< `$ plugin NAME`
|
|
---
|
|
> `$ plugin [flags]`
|
|
>
|
|
>
|
|
>
|
|
> ------------
|
|
>
|
|
> ## <em>list</em>
|
|
>
|
|
>
|
|
>
|
|
> List all available plugin files on a user's PATH.
|
|
>
|
|
> Available plugin files are those that are: - executable - anywhere on the user's PATH - begin with "kubectl-"
|
|
>
|
|
> ### Usage
|
|
>
|
|
> `$ list`
|
|
>
|
|
>
|
|
>
|
|
> ### Flags
|
|
>
|
|
> Name | Shorthand | Default | Usage
|
|
> ---- | --------- | ------- | -----
|
|
> name-only | | false | If true, display only the binary name of each plugin, rather than its full path
|
|
|
|
|
|
diff -r v1_11/_generated_port-forward.md v1_12/_generated_port-forward.md
|
|
17a18,23
|
|
> >bdocs-tab:example Listen on ports 5000 and 6000 locally, forwarding data to/from ports 5000 and 6000 in a pod selected by the service
|
|
>
|
|
> ```bdocs-tab:example_shell
|
|
> kubectl port-forward service/myservice 5000 6000
|
|
> ```
|
|
>
|
|
|
|
|
|
diff -r v1_11/_generated_proxy.md v1_12/_generated_proxy.md
|
|
59a60
|
|
> keepalive | | 0s | keepalive specifies the keep-alive period for an active network connection. Set to 0 to disable keepalive.
|
|
|
|
|
|
diff -r v1_11/_generated_replace.md v1_12/_generated_replace.md
|
|
54c54
|
|
< output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_rolling-update.md v1_12/_generated_rolling-update.md
|
|
60c60
|
|
< output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_rollout.md v1_12/_generated_rollout.md
|
|
61a62
|
|
> allow-missing-template-keys | | true | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
|
|
62a64
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
64a67
|
|
> 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].
|
|
92a96
|
|
> allow-missing-template-keys | | true | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
|
|
93a98
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
94a100
|
|
> 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].
|
|
122a129
|
|
> allow-missing-template-keys | | true | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
|
|
123a131
|
|
> output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
124a133
|
|
> 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].
|
|
155a165
|
|
> timeout | | 0s | The length of time to wait before ending watch, zero means never. Any other values should contain a corresponding time unit (e.g. 1s, 2m, 3h).
|
|
194a205
|
|
> allow-missing-template-keys | | true | If true, ignore any errors in templates when a field or map key is missing in the template. Only applies to golang and jsonpath output formats.
|
|
196a208
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
197a210
|
|
> 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].
|
|
|
|
|
|
diff -r v1_11/_generated_run-container.md v1_12/_generated_run-container.md
|
|
27c27
|
|
< kubectl run hazelcast --image=nginx --labels="app=hazelcast,env=prod"
|
|
---
|
|
> kubectl run hazelcast --image=hazelcast --labels="app=hazelcast,env=prod"
|
|
|
|
|
|
diff -r v1_11/_generated_run.md v1_12/_generated_run.md
|
|
27c27
|
|
< kubectl run hazelcast --image=nginx --labels="app=hazelcast,env=prod"
|
|
---
|
|
> kubectl run hazelcast --image=hazelcast --labels="app=hazelcast,env=prod"
|
|
|
|
|
|
diff -r v1_11/_generated_scale.md v1_12/_generated_scale.md
|
|
57c57
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_set.md v1_12/_generated_set.md
|
|
180c180
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|go-template-file|templatefile|template|go-template|jsonpath|jsonpath-file.
|
|
241c241
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
282c282
|
|
< output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
329c329
|
|
< output | o | | Output format. One of: json|yaml|name|templatefile|template|go-template|go-template-file|jsonpath-file|jsonpath.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|
|
|
|
|
|
diff -r v1_11/_generated_version.md v1_12/_generated_version.md
|
|
25c25
|
|
< client | c | false | Client version only (no server required).
|
|
---
|
|
> client | | false | Client version only (no server required).
|
|
|
|
|
|
diff -r v1_11/_generated_wait.md v1_12/_generated_wait.md
|
|
5a6
|
|
> >bdocs-tab:example Wait for the pod "busybox1" to contain the status condition of type "Ready".
|
|
6a8,10
|
|
> ```bdocs-tab:example_shell
|
|
> kubectl wait --for=condition=Ready pod/busybox1
|
|
> ```
|
|
7a12
|
|
> >bdocs-tab:example Wait for the pod "busybox1" to be deleted, with a timeout of 60s, after having issued the "delete" command.
|
|
8a14,26
|
|
> ```bdocs-tab:example_shell
|
|
> kubectl delete pod/busybox1
|
|
> kubectl wait --for=delete pod/busybox1 --timeout=60s
|
|
> ```
|
|
>
|
|
>
|
|
> Experimental: Wait for a specific condition on one or many resources.
|
|
>
|
|
> The command takes multiple resources and waits until the specified condition is seen in the Status field of every given resource.
|
|
>
|
|
> Alternatively, the command can wait for the given set of resources to be deleted by providing the "delete" keyword as the value to the --for flag.
|
|
>
|
|
> A successful message will be printed to stdout indicating when the specified condition has been met. One can use -o option to change to output destination.
|
|
24c42
|
|
< output | o | | Output format. One of: json|yaml|name|go-template|go-template-file|templatefile|template|jsonpath|jsonpath-file.
|
|
---
|
|
> output | o | | Output format. One of: json|yaml|name|template|go-template|go-template-file|templatefile|jsonpath|jsonpath-file.
|