Skip to content

Commit 1eabaee

Browse files
authored
Add link to kubectl convert (#40737)
* added also to chinesed translations, rebased and squashed * revert chinese update
1 parent ef686eb commit 1eabaee

File tree

1 file changed

+17
-5
lines changed

1 file changed

+17
-5
lines changed

content/en/docs/reference/using-api/deprecation-guide.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -379,14 +379,26 @@ to locate use of deprecated APIs.
379379
* Update custom integrations and controllers to call the non-deprecated APIs
380380
* Change YAML files to reference the non-deprecated APIs
381381

382-
You can use the `kubectl-convert` command (`kubectl convert` prior to v1.20)
383-
to automatically convert an existing object:
382+
You can use the `kubectl convert` command to automatically convert an existing object:
384383

385-
`kubectl-convert -f <file> --output-version <group>/<version>`.
384+
`kubectl convert -f <file> --output-version <group>/<version>`.
386385

387386
For example, to convert an older Deployment to `apps/v1`, you can run:
388387

389-
`kubectl-convert -f ./my-deployment.yaml --output-version apps/v1`
388+
`kubectl convert -f ./my-deployment.yaml --output-version apps/v1`
390389

391-
Note that this may use non-ideal default values. To learn more about a specific
390+
This conversion may use non-ideal default values. To learn more about a specific
392391
resource, check the Kubernetes [API reference](/docs/reference/kubernetes-api/).
392+
393+
{{< note >}}
394+
The `kubectl convert` tool is not installed by default, although
395+
in fact it once was part of `kubectl` itself. For more details, you can read the
396+
[deprecation and removal issue](https://github.com/kubernetes/kubectl/issues/725)
397+
for the built-in subcommand.
398+
399+
To learn how to set up `kubectl convert` on your computer, visit the page that is right for your
400+
operating system:
401+
[Linux](/docs/tasks/tools/install-kubectl-linux/#install-kubectl-convert-plugin),
402+
[macOS](/docs/tasks/tools/install-kubectl-macos/#install-kubectl-convert-plugin), or
403+
[Windows](/docs/tasks/tools/install-kubectl-windows/#install-kubectl-convert-plugin).
404+
{{< /note >}}

0 commit comments

Comments
 (0)