Merge pull request #25935 from carlory/deprecate-kubeadm-alpha-in-1.21
kubeadm: remove deprecated alpha commands
This commit is contained in:
		
						commit
						83879e9f7d
					
				| 
						 | 
				
			
			@ -26,5 +26,7 @@ To install kubeadm, see the [installation guide](/docs/setup/production-environm
 | 
			
		|||
* [kubeadm config](/docs/reference/setup-tools/kubeadm/kubeadm-config) if you initialized your cluster using kubeadm v1.7.x or lower, to configure your cluster for `kubeadm upgrade`
 | 
			
		||||
* [kubeadm token](/docs/reference/setup-tools/kubeadm/kubeadm-token) to manage tokens for `kubeadm join`
 | 
			
		||||
* [kubeadm reset](/docs/reference/setup-tools/kubeadm/kubeadm-reset) to revert any changes made to this host by `kubeadm init` or `kubeadm join`
 | 
			
		||||
* [kubeadm certs](/docs/reference/setup-tools/kubeadm/kubeadm-certs) to manage Kubernetes certificates
 | 
			
		||||
* [kubeadm kubeconfig](/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig) to manage kubeconfig files
 | 
			
		||||
* [kubeadm version](/docs/reference/setup-tools/kubeadm/kubeadm-version) to print the kubeadm version
 | 
			
		||||
* [kubeadm alpha](/docs/reference/setup-tools/kubeadm/kubeadm-alpha) to preview a set of features made available for gathering feedback from the community
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -1,48 +0,0 @@
 | 
			
		|||
 | 
			
		||||
### Synopsis
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
This command is not meant to be run on its own. See list of available subcommands.
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-h, --help</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">help for kubelet</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
### Options inherited from parent commands
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--rootfs string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">[EXPERIMENTAL] The path to the 'real' host root filesystem.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -1,48 +0,0 @@
 | 
			
		|||
 | 
			
		||||
### Synopsis
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
This command is not meant to be run on its own. See list of available subcommands.
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-h, --help</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">help for config</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
### Options inherited from parent commands
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--rootfs string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">[EXPERIMENTAL] The path to the 'real' host root filesystem.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -1,87 +0,0 @@
 | 
			
		|||
 | 
			
		||||
### Synopsis
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
Enable or update dynamic kubelet configuration for a Node, against the kubelet-config-1.X ConfigMap in the cluster, where X is the minor version of the desired kubelet version.
 | 
			
		||||
 | 
			
		||||
WARNING: This feature is still experimental, and disabled by default. Enable only if you know what you are doing, as it may have surprising side-effects at this stage.
 | 
			
		||||
 | 
			
		||||
Alpha Disclaimer: this command is currently alpha.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubeadm alpha kubelet config enable-dynamic [flags]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Examples
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
  # Enable dynamic kubelet configuration for a Node.
 | 
			
		||||
  kubeadm alpha phase kubelet enable-dynamic-config --node-name node-1 --kubelet-version 1.18.0
 | 
			
		||||
  
 | 
			
		||||
  WARNING: This feature is still experimental, and disabled by default. Enable only if you know what you are doing, as it
 | 
			
		||||
  may have surprising side-effects at this stage.
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-h, --help</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">help for enable-dynamic</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--kubeconfig string     Default: "/etc/kubernetes/admin.conf"</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations can be searched for an existing kubeconfig file.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--kubelet-version string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">The desired version for the kubelet</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--node-name string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">Name of the node that should enable the dynamic kubelet configuration</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
### Options inherited from parent commands
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--rootfs string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">[EXPERIMENTAL] The path to the 'real' host root filesystem.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -1,48 +0,0 @@
 | 
			
		|||
 | 
			
		||||
### Synopsis
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
This command is not meant to be run on its own. See list of available subcommands.
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-h, --help</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">help for selfhosting</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
### Options inherited from parent commands
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--rootfs string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">[EXPERIMENTAL] The path to the 'real' host root filesystem.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -1,99 +0,0 @@
 | 
			
		|||
 | 
			
		||||
### Synopsis
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
Convert static Pod files for control plane components into self-hosted DaemonSets configured via the Kubernetes API.
 | 
			
		||||
 | 
			
		||||
See the documentation for self-hosting limitations.
 | 
			
		||||
 | 
			
		||||
Alpha Disclaimer: this command is currently alpha.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubeadm alpha selfhosting pivot [flags]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Examples
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
  # Convert a static Pod-hosted control plane into a self-hosted one.
 | 
			
		||||
  
 | 
			
		||||
  kubeadm alpha phase self-hosting convert-from-staticpods
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--cert-dir string     Default: "/etc/kubernetes/pki"</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">The path where certificates are stored</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--config string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">Path to a kubeadm configuration file.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-f, --force</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">Pivot the cluster without prompting for confirmation</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-h, --help</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">help for pivot</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--kubeconfig string     Default: "/etc/kubernetes/admin.conf"</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">The kubeconfig file to use when talking to the cluster. If the flag is not set, a set of standard locations can be searched for an existing kubeconfig file.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">-s, --store-certs-in-secrets</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">Enable storing certs in secrets</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
### Options inherited from parent commands
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
<colgroup>
 | 
			
		||||
<col span="1" style="width: 10px;" />
 | 
			
		||||
<col span="1" />
 | 
			
		||||
</colgroup>
 | 
			
		||||
<tbody>
 | 
			
		||||
 | 
			
		||||
<tr>
 | 
			
		||||
<td colspan="2">--rootfs string</td>
 | 
			
		||||
</tr>
 | 
			
		||||
<tr>
 | 
			
		||||
<td></td><td style="line-height: 130%; word-wrap: break-word;">[EXPERIMENTAL] The path to the 'real' host root filesystem.</td>
 | 
			
		||||
</tr>
 | 
			
		||||
 | 
			
		||||
</tbody>
 | 
			
		||||
</table>
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -4,8 +4,6 @@
 | 
			
		|||
 | 
			
		||||
Kubeconfig file utilities.
 | 
			
		||||
 | 
			
		||||
Alpha Disclaimer: this command is currently alpha.
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
 | 
			
		||||
   <table style="width: 100%; table-layout: fixed;">
 | 
			
		||||
| 
						 | 
				
			
			@ -4,17 +4,16 @@
 | 
			
		|||
 | 
			
		||||
Output a kubeconfig file for an additional user.
 | 
			
		||||
 | 
			
		||||
Alpha Disclaimer: this command is currently alpha.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubeadm alpha kubeconfig user [flags]
 | 
			
		||||
kubeadm kubeconfig user [flags]
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Examples
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
  # Output a kubeconfig file for an additional user named foo using a kubeadm config file bar
 | 
			
		||||
  kubeadm alpha kubeconfig user --client-name=foo --config=bar
 | 
			
		||||
  kubeadm kubeconfig user --client-name=foo --config=bar
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Options
 | 
			
		||||
| 
						 | 
				
			
			@ -9,34 +9,7 @@ weight: 90
 | 
			
		|||
 from the community. Please try it out and give us feedback!
 | 
			
		||||
{{< /caution >}}
 | 
			
		||||
 | 
			
		||||
## kubeadm alpha kubeconfig user {#cmd-phase-kubeconfig}
 | 
			
		||||
 | 
			
		||||
The `user` subcommand can be used for the creation of kubeconfig files for additional users.
 | 
			
		||||
 | 
			
		||||
{{< tabs name="tab-kubeconfig" >}}
 | 
			
		||||
{{< tab name="kubeconfig" include="generated/kubeadm_alpha_kubeconfig.md" />}}
 | 
			
		||||
{{< tab name="user" include="generated/kubeadm_alpha_kubeconfig_user.md" />}}
 | 
			
		||||
{{< /tabs >}}
 | 
			
		||||
 | 
			
		||||
## kubeadm alpha kubelet config {#cmd-phase-kubelet}
 | 
			
		||||
 | 
			
		||||
Use the following command to enable the DynamicKubeletConfiguration feature.
 | 
			
		||||
 | 
			
		||||
{{< tabs name="tab-kubelet" >}}
 | 
			
		||||
{{< tab name="kubelet" include="generated/kubeadm_alpha_kubelet.md" />}}
 | 
			
		||||
{{< tab name="enable-dynamic" include="generated/kubeadm_alpha_kubelet_config_enable-dynamic.md" />}}
 | 
			
		||||
{{< /tabs >}}
 | 
			
		||||
 | 
			
		||||
## kubeadm alpha selfhosting pivot {#cmd-selfhosting}
 | 
			
		||||
 | 
			
		||||
The subcommand `pivot` can be used to convert a static Pod-hosted control plane into a self-hosted one.
 | 
			
		||||
 | 
			
		||||
[Documentation](/docs/setup/production-environment/tools/kubeadm/self-hosting/)
 | 
			
		||||
 | 
			
		||||
{{< tabs name="selfhosting" >}}
 | 
			
		||||
{{< tab name="selfhosting" include="generated/kubeadm_alpha_selfhosting.md" />}}
 | 
			
		||||
{{< tab name="pivot" include="generated/kubeadm_alpha_selfhosting_pivot.md" />}}
 | 
			
		||||
{{< /tabs >}}
 | 
			
		||||
Currently there are no experimental commands under `kubeadm alpha`.
 | 
			
		||||
 | 
			
		||||
## {{% heading "whatsnext" %}}
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -0,0 +1,21 @@
 | 
			
		|||
---
 | 
			
		||||
title: kubeadm kubeconfig
 | 
			
		||||
content_type: concept
 | 
			
		||||
weight: 90
 | 
			
		||||
---
 | 
			
		||||
 | 
			
		||||
`kubeadm kubeconfig` provides utilities for managing kubeconfig files.
 | 
			
		||||
 | 
			
		||||
## kubeadm kubeconfig {#cmd-kubeconfig}
 | 
			
		||||
 | 
			
		||||
{{< tabs name="tab-kubeconfig" >}}
 | 
			
		||||
{{< tab name="overview" include="generated/kubeadm_kubeconfig.md" />}}
 | 
			
		||||
{{< /tabs >}}
 | 
			
		||||
 | 
			
		||||
## kubeadm kubeconfig user {#cmd-kubeconfig-user}
 | 
			
		||||
 | 
			
		||||
This command can be used to output a kubeconfig file for an additional user.
 | 
			
		||||
 | 
			
		||||
{{< tabs name="tab-kubeconfig-user" >}}
 | 
			
		||||
{{< tab name="user" include="generated/kubeadm_kubeconfig_user.md" />}}
 | 
			
		||||
{{< /tabs >}}
 | 
			
		||||
		Loading…
	
		Reference in New Issue