kubeadm upgrade
kubeadm upgrade is a user-friendly command that wraps complex upgrading logic behind one command, with support
for both planning an upgrade and actually performing it. kubeadm upgrade can also be used for downgrading
cluster if necessary.
- kubeadm upgrade guidance
- kubeadm upgrade plan
- kubeadm upgrade apply
- kubeadm upgrade diff
- kubeadm upgrade node config
- What's next
kubeadm upgrade guidance
Every upgrade process might be a bit different, so we’ve documented each minor upgrade process individually. For more version-specific upgrade guidance, see the following resources:
- 1.6 to 1.7 upgrades
- 1.7.x to 1.7.y upgrades
- 1.7 to 1.8 upgrades
- 1.8.x to 1.8.y upgrades
- 1.8.x to 1.9.x upgrades
- 1.9.x to 1.9.y upgrades
- 1.9.x to 1.9.y HA cluster upgrades
In Kubernetes v1.11.0 and later, you can use kubeadm upgrade diff to see the changes that would be
applied to static pod manifests.
kubeadm upgrade plan
Check which versions are available to upgrade to and validate whether your current cluster is upgradeable.
Synopsis
Check which versions are available to upgrade to and validate whether your current cluster is upgradeable.
kubeadm upgrade plan [flags]
Options
| -h, --help | |
| help for plan | |
Options inherited from parent commands
| --allow-experimental-upgrades | |
| Show unstable versions of Kubernetes as an upgrade alternative and allow upgrading to an alpha/beta/release candidate versions of Kubernetes. | |
| --allow-release-candidate-upgrades | |
| Show release candidate versions of Kubernetes as an upgrade alternative and allow upgrading to a release candidate versions of Kubernetes. | |
| --config string | |
| Path to kubeadm config file. WARNING: Usage of a configuration file is experimental! | |
| --feature-gates string | |
| A set of key=value pairs that describe feature gates for various features.Options are: Auditing=true|false (ALPHA - default=false) CoreDNS=true|false (BETA - default=false) DynamicKubeletConfig=true|false (ALPHA - default=false) SelfHosting=true|false (ALPHA - default=false) StoreCertsInSecrets=true|false (ALPHA - default=false) |
|
| --ignore-preflight-errors stringSlice | |
| A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
| --print-config | |
| Specifies whether the configuration file that will be used in the upgrade should be printed or not. | |
kubeadm upgrade apply
Upgrade your Kubernetes cluster to the specified version.
Synopsis
Upgrade your Kubernetes cluster to the specified version.
kubeadm upgrade apply [version]
Options
| --dry-run | |
| Do not change any state, just output what actions would be performed. | |
| --etcd-upgrade Default: true | |
| Perform the upgrade of etcd. | |
| -f, --force | |
| Force upgrading although some requirements might not be met. This also implies non-interactive mode. | |
| -h, --help | |
| help for apply | |
| --image-pull-timeout duration Default: 15m0s | |
| The maximum amount of time to wait for the control plane pods to be downloaded. | |
| -y, --yes | |
| Perform the upgrade and do not prompt for confirmation (non-interactive mode). | |
Options inherited from parent commands
| --allow-experimental-upgrades | |
| Show unstable versions of Kubernetes as an upgrade alternative and allow upgrading to an alpha/beta/release candidate versions of Kubernetes. | |
| --allow-release-candidate-upgrades | |
| Show release candidate versions of Kubernetes as an upgrade alternative and allow upgrading to a release candidate versions of Kubernetes. | |
| --config string | |
| Path to kubeadm config file. WARNING: Usage of a configuration file is experimental! | |
| --feature-gates string | |
| A set of key=value pairs that describe feature gates for various features.Options are: Auditing=true|false (ALPHA - default=false) CoreDNS=true|false (BETA - default=false) DynamicKubeletConfig=true|false (ALPHA - default=false) SelfHosting=true|false (ALPHA - default=false) StoreCertsInSecrets=true|false (ALPHA - default=false) |
|
| --ignore-preflight-errors stringSlice | |
| A list of checks whose errors will be shown as warnings. Example: 'IsPrivilegedUser,Swap'. Value 'all' ignores errors from all checks. | |
| --kubeconfig string Default: "/etc/kubernetes/admin.conf" | |
| The KubeConfig file to use when talking to the cluster. | |
| --print-config | |
| Specifies whether the configuration file that will be used in the upgrade should be printed or not. | |
kubeadm upgrade diff
PLACEHOLDER FILE UNTIL WE GENERATE THE REAL THING. DO NOT REMOVE FROM 1.11 DOCS BRANCH
Synopsis
diff something or other
kubeadm upgrade node config
PLACEHOLDER FILE UNTIL WE GENERATE THE REAL THING. DO NOT REMOVE FROM 1.11 DOCS BRANCH
Synopsis
Downloads the kubelet configuration from the cluster ConfigMap kubelet-config-1.X, where X is the minor version of the kubelet.
What's next
- kubeadm config if you initialized your cluster using kubeadm v1.7.x or lower, to configure your cluster for
kubeadm upgrade