From aef8b53b6021a7e1f79a524cc95ea5fbf8317f35 Mon Sep 17 00:00:00 2001 From: chentanjun <2799194073@qq.com> Date: Wed, 8 Jan 2020 12:07:40 +0800 Subject: [PATCH] update zh-trans content/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md (#18350) --- .../kubeadm/kubeadm-upgrade.md | 414 ++++++++++++------ 1 file changed, 268 insertions(+), 146 deletions(-) diff --git a/content/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md b/content/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md index 1234bc453e..b0925b98d7 100644 --- a/content/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md +++ b/content/zh/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md @@ -1,154 +1,200 @@ --- -title: 将 kubeadm 集群从 v1.13 升级到 v1.14 -content_template: templates/task ---- - +--- + {{% capture overview %}} - -本页介绍了如何将 `kubeadm` 创建的 Kubernetes 集群从 1.13.x 版本升级到 1.14.x 版本，以及从版本 1.14.x 升级到 1.14.y ，其中 `y > x`。 + +本页介绍了如何将 `kubeadm` 创建的 Kubernetes 集群从 1.16.x 版本升级到 1.17.x 版本，以及从版本 1.17.x 升级到 1.17.y ，其中 `y > x`。 - +要查看 kubeadm 创建的有关旧版本集群升级的信息，请参考以下页面： + + +- [将 kubeadm 集群从 1.15 升级到 1.16](https://v1-16.docs.kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade/) +- [将 kubeadm 集群从 1.14 升级到 1.15](https://v1-15.docs.kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-15/) +- [将 kubeadm 集群从 1.13 升级到 1.14](https://v1-15.docs.kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-14/) + + +1. Upgrade worker nodes. +--> 高版本升级工作流如下： 1. 升级主控制平面节点。 1. 升级其他控制平面节点。 -1. 升级 worker 节点。 - -{{< note >}} - -随着 Kubernetes v1.14 的发布，用于升级 HA 和单个控制平面集群的 kubeadm 指令被合并到一个文档中。 -{{}} +1. 升级工作节点。 {{% /capture %}} {{% capture prerequisites %}} - -- 您需要有一个由 `kubeadm` 创建并运行着 1.13.0 或更高版本的 Kubernetes 集群。 + `kubeadm upgrade` does not touch your workloads, only components internal to Kubernetes, but backups are always a best practice. +--> +- 您需要有一个由 `kubeadm` 创建并运行着 1.16.0 或更高版本的 Kubernetes 集群。 - [禁用 Swap](https://serverfault.com/questions/684771/best-way-to-disable-swap-in-linux)。 -- 集群应使用静态的控制平面和 etcd pod。 -- 务必仔细认真阅读[发行说明](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG-1.14.md)。 +- 集群应使用静态的控制平面和 etcd pod 或者 外部 etcd。 +- 务必仔细认真阅读[发行说明](https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG-1.16.md)。 - 务必备份所有重要组件，例如存储在数据库中应用层面的状态。 `kubeadm upgrade` 不会影响您的工作负载，只会涉及 Kubernetes 内部的组件，但备份终究是好的。 - + ### 附加信息 - -- 升级后重新启动所有容器，因为容器 spec 的哈希值已更改。 -- 您只能从一个次版本升级到下一个次版本,或者同样次版本的补丁版。也就是说，升级时无法跳过版本。 + For example, you can upgrade from 1.y to 1.y+1, but not from 1.y to 1.y+2. +--> +- 升级后，因为容器 spec 哈希值已更改，所以所有容器都会重新启动。 +- 您只能从一个次版本升级到下一个次版本，或者同样次版本的补丁版。也就是说，升级时无法跳过版本。 例如，您只能从 1.y 升级到 1.y+1，而不能从 from 1.y 升级到 1.y+2。 {{% /capture %}} {{% capture steps %}} - + ## 确定要升级到哪个版本 - -1. 找到最新的稳定版 1.14: + {{< /tabs >}} +--> +1. 找到最新的稳定版 1.17: {{< tabs name="k8s_install_versions" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} apt update apt-cache policy kubeadm - # 在列表中查找最新的 1.14 版本 - # 它看起来应该是 1.14.x-00 ，其中 x 是最新的补丁 + # 在列表中查找最新的 1.17 版本 + # 它看起来应该是 1.17.x-00 ，其中 x 是最新的补丁 {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} yum list --showduplicates kubeadm --disableexcludes=kubernetes - # 在列表中查找最新的 1.14 版本 - # 它看起来应该是 1.14.x-00 ，其中 x 是最新的补丁 + # 在列表中查找最新的 1.17 版本 + # 它看起来应该是 1.17.x-0 ，其中 x 是最新的补丁 {{% /tab %}} {{< /tabs >}} - + ## 升级第一个控制平面节点 - + {{< /tabs >}} +--> 1. 在第一个控制平面节点上，升级 kubeadm : {{< tabs name="k8s_install_kubeadm_first_cp" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x + # 用最新的修补程序版本替换 1.17.x-00 中的 x apt-mark unhold kubeadm && \ - apt-get update && apt-get install -y kubeadm=1.14.x-00 && \ + apt-get update && apt-get install -y kubeadm=1.17.x-00 && \ apt-mark hold kubeadm {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x - yum install -y kubeadm-1.14.x-0 --disableexcludes=kubernetes + # 用最新的修补程序版本替换 1.17.x-0 中的 x + yum install -y kubeadm-1.17.x-0 --disableexcludes=kubernetes {{% /tab %}} {{< /tabs >}} - -1. 验证下载是否有效并具有预期版本： + ``` +--> +1. 验证 kubeadm 版本： ```shell kubeadm version ``` - + +1. 腾空控制平面节点： + + ```shell + kubectl drain $CP_NODE --ignore-daemonsets + ``` + + 1. 在主节点上，运行: ```shell sudo kubeadm upgrade plan ``` - + 您应该可以看到与下面类似的输出： ```shell @@ -158,44 +204,52 @@ are merged into a single document. --> [upgrade/config] Reading configuration from the cluster... [upgrade/config] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -oyaml' [upgrade] Fetching available versions to upgrade to - [upgrade/versions] Cluster version: v1.13.3 - [upgrade/versions] kubeadm version: v1.14.0 + [upgrade/versions] Cluster version: v1.16.0 + [upgrade/versions] kubeadm version: v1.17.0 Components that must be upgraded manually after you have upgraded the control plane with 'kubeadm upgrade apply': COMPONENT CURRENT AVAILABLE - Kubelet 2 x v1.13.3 v1.14.0 + Kubelet 1 x v1.16.0 v1.17.0 Upgrade to the latest version in the v1.13 series: COMPONENT CURRENT AVAILABLE - API Server v1.13.3 v1.14.0 - Controller Manager v1.13.3 v1.14.0 - Scheduler v1.13.3 v1.14.0 - Kube Proxy v1.13.3 v1.14.0 - CoreDNS 1.2.6 1.3.1 - Etcd 3.2.24 3.3.10 + API Server v1.16.0 v1.17.0 + Controller Manager v1.16.0 v1.17.0 + Scheduler v1.16.0 v1.17.0 + Kube Proxy v1.16.0 v1.17.0 + CoreDNS 1.6.2 1.6.5 + Etcd 3.3.15 3.4.3-0 You can now apply the upgrade by executing the following command: - kubeadm upgrade apply v1.14.0 + kubeadm upgrade apply v1.17.0 _____________________________________________________________________ ``` - + 此命令检查您的集群是否可以升级，并可以获取到升级的版本。 - + 1. 选择要升级到的版本，然后运行相应的命令。例如: ```shell - sudo kubeadm upgrade apply v1.14.x + sudo kubeadm upgrade apply v1.17.x ``` - + - 将 `x` 替换为您为此升级选择的修补程序版本。 - + 您应该可以看见与下面类似的输出： ```shell @@ -204,9 +258,9 @@ are merged into a single document. --> [upgrade/config] Making sure the configuration is correct: [upgrade/config] Reading configuration from the cluster... [upgrade/config] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -oyaml' - [upgrade/version] You have chosen to change the cluster version to "v1.14.0" - [upgrade/versions] Cluster version: v1.13.3 - [upgrade/versions] kubeadm version: v1.14.0 + [upgrade/version] You have chosen to change the cluster version to "v1.17.0" + [upgrade/versions] Cluster version: v1.16.0 + [upgrade/versions] kubeadm version: v1.17.0 [upgrade/confirm] Are you sure you want to proceed with the upgrade? [y/N]: y [upgrade/prepull] Will prepull images for components [kube-apiserver kube-controller-manager kube-scheduler etcd] [upgrade/prepull] Prepulling image for component etcd. @@ -226,7 +280,7 @@ are merged into a single document. --> [upgrade/prepull] Prepulled image for component kube-scheduler. [upgrade/prepull] Prepulled image for component kube-controller-manager. [upgrade/prepull] Successfully prepulled the images for all the control plane components - [upgrade/apply] Upgrading your Static Pod-hosted control plane to version "v1.14.0"... + [upgrade/apply] Upgrading your Static Pod-hosted control plane to version "v1.17.0"... Static pod: kube-apiserver-myhost hash: 6436b0d8ee0136c9d9752971dda40400 Static pod: kube-controller-manager-myhost hash: 8ee730c1a5607a87f35abb2183bf03f2 Static pod: kube-scheduler-myhost hash: 4b52d75cab61380f07c0c5a69fb371d4 @@ -266,8 +320,8 @@ are merged into a single document. --> [apiclient] Found 1 Pods for label selector component=kube-scheduler [upgrade/staticpods] Component "kube-scheduler" upgraded successfully! [upload-config] storing the configuration used in ConfigMap "kubeadm-config" in the "kube-system" Namespace - [kubelet] Creating a ConfigMap "kubelet-config-1.14" in namespace kube-system with the configuration for the kubelets in the cluster - [kubelet-start] Downloading configuration for the kubelet from the "kubelet-config-1.14" ConfigMap in the kube-system namespace + [kubelet] Creating a ConfigMap "kubelet-config-1.17" in namespace kube-system with the configuration for the kubelets in the cluster + [kubelet-start] Downloading configuration for the kubelet from the "kubelet-config-1.17" ConfigMap in the kube-system namespace [kubelet-start] Writing kubelet configuration to file "/var/lib/kubelet/config.yaml" [bootstrap-token] configured RBAC rules to allow Node Bootstrap tokens to post CSRs in order for nodes to get long term certificate credentials [bootstrap-token] configured RBAC rules to allow the csrapprover controller automatically approve CSRs from a Node Bootstrap Token @@ -275,105 +329,144 @@ are merged into a single document. --> [addons] Applied essential addon: CoreDNS [addons] Applied essential addon: kube-proxy - [upgrade/successful] SUCCESS! Your cluster was upgraded to "v1.14.0". Enjoy! + [upgrade/successful] SUCCESS! Your cluster was upgraded to "v1.17.0". Enjoy! [upgrade/kubelet] Now that your control plane is upgraded, please proceed with upgrading your kubelets if you haven't already done so. ``` - + 1. 手动升级你的 CNI 供应商插件。 - + find your CNI provider and see whether additional upgrade steps are required. + --> 您的容器网络接口（CNI）应该提供了程序自身的升级说明。 检查[插件](/docs/concepts/cluster-administration/addons/)页面查找您 CNI 所提供的程序，并查看是否需要其他升级步骤。 - + + 如果 CNI 提供程序作为 DaemonSet 运行，则在其他控制平面节点上不需要此步骤。 + + +1. 取消对控制面节点的保护 + + ```shell + kubectl uncordon $CP_NODE + ``` + + 1. 升级控制平面节点上的 kubelet 和 kubectl ： {{< tabs name="k8s_install_kubelet" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x + # 用最新的修补程序版本替换 1.17.x-00 中的 x apt-mark unhold kubelet kubectl && \ - apt-get update && apt-get install -y kubelet=1.14.x-00 kubectl=1.14.x-00 && \ + apt-get update && apt-get install -y kubelet=1.17.x-00 kubectl=1.17.x-00 && \ apt-mark hold kubelet kubectl {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x - yum install -y kubelet-1.14.x-0 kubectl-1.14.x-0 --disableexcludes=kubernetes + # 用最新的修补程序版本替换 1.17.x-00 中的 x + yum install -y kubelet-1.17.x-0 kubectl-1.17.x-0 --disableexcludes=kubernetes {{% /tab %}} {{< /tabs >}} - + 1. 重启 kubelet ```shell sudo systemctl restart kubelet ``` - -## 升级其他控制面板节点 + +## 升级其他控制平面节点 - + 1. 与第一个控制平面节点相同，但使用： ``` sudo kubeadm upgrade node experimental-control-plane ``` -instead of: +而不是： ``` sudo kubeadm upgrade apply ``` - + 也不需要 `sudo kubeadm upgrade plan` 。 - + ## 升级工作节点 - + 工作节点上的升级过程应该一次执行一个节点，或者一次执行几个节点，以不影响运行工作负载所需的最小容量。 - + ### 升级 kubeadm - + {{< /tabs >}} +--> 1. 在所有工作节点升级 kubeadm : {{< tabs name="k8s_install_kubeadm_worker_nodes" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x + # 用最新的修补程序版本替换 1.17.x-00 中的 x apt-mark unhold kubeadm && \ - apt-get update && apt-get install -y kubeadm=1.14.x-00 && \ + apt-get update && apt-get install -y kubeadm=1.17.x-00 && \ apt-mark hold kubeadm {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x - yum install -y kubeadm-1.14.x-0 --disableexcludes=kubernetes + # 用最新的修补程序版本替换 1.17.x-00 中的 x + yum install -y kubeadm-1.17.x-0 --disableexcludes=kubernetes {{% /tab %}} {{< /tabs >}} - -### 节点临界点 + +### 保护节点 - -1. 通过将节点标记为不可计划并逐出工作负载，为维护做好准备。运行： + ``` +--> +1. 通过将节点标记为不可调度并逐出工作负载，为维护做好准备。运行： ```shell kubectl drain $NODE --ignore-daemonsets ``` - + 您应该可以看见与下面类似的输出： ```shell @@ -401,90 +497,108 @@ without compromising the minimum required capacity for running your workloads. - node/ip-172-31-85-18 drained ``` - + ### 升级 kubelet 配置 - + Replace `x` with the patch version you picked for this ugprade. +--> 1. 升级 kubelet 配置: ```shell sudo kubeadm upgrade node config --kubelet-version v1.14.x ``` - + 用最新的修补程序版本替换 1.14.x-00 中的 x - + ### 升级 kubelet 与 kubectl - + {{< /tabs >}} +--> 1. 通过运行适用于您的 Linux 发行版包管理器升级 Kubernetes 软件包版本： {{< tabs name="k8s_kubelet_and_kubectl" >}} {{% tab name="Ubuntu, Debian or HypriotOS" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 xs + # 用最新的修补程序版本替换 1.17.x-00 中的 xs apt-mark unhold kubelet kubectl && \ - apt-get update && apt-get install -y kubelet=1.14.x-00 kubectl=1.14.x-00 && \ + apt-get update && apt-get install -y kubelet=1.17.x-00 kubectl=1.17.x-00 && \ apt-mark hold kubelet kubectl {{% /tab %}} {{% tab name="CentOS, RHEL or Fedora" %}} - # 用最新的修补程序版本替换 1.14.x-00 中的 x - yum install -y kubelet-1.14.x-0 kubectl-1.14.x-0 --disableexcludes=kubernetes + # 用最新的修补程序版本替换 1.17.x-00 中的 x + yum install -y kubelet-1.17.x-0 kubectl-1.17.x-0 --disableexcludes=kubernetes {{% /tab %}} {{< /tabs >}} - + ``` +--> 1. 重启 kubelet ```shell sudo systemctl restart kubelet ``` - -### 节点未临界点 + +### 取消对节点的保护 - + ``` +--> 1. 通过将节点标记为可调度，让节点重新上线: ```shell kubectl uncordon $NODE ``` - +``` +--> ## 验证集群的状态 在所有节点上升级 kubelet 后，通过从 kubectl 可以访问集群的任何位置运行以下命令，验证所有节点是否再次可用： @@ -493,24 +607,29 @@ kubectl get nodes kubectl get nodes ``` - -`STATUS` 列应显示所有节点为 `Ready` 状态，并且版本号已经被更新。 + +`STATUS` 应显示所有节点为 `Ready` 状态，并且版本号已经被更新。 {{% /capture %}} - +To recover from a bad state, you can also run `kubeadm upgrade --force` without changing the version that your cluster is running. +--> ## 从故障状态恢复 如果 `kubeadm upgrade` 失败并且没有回滚，例如由于执行期间意外关闭，您可以再次运行 `kubeadm upgrade`。 此命令是幂等的，并最终确保实际状态是您声明的所需状态。 要从故障状态恢复，您还可以运行 `kubeadm upgrade --force` 而不去更改集群正在运行的版本。 - +- Creates new certificate and key files of the API server and backs up old files if they're about to expire in 180 days. +--> ## 它是怎么工作的 `kubeadm upgrade apply` 做了以下工作： @@ -537,11 +657,13 @@ To recover from a bad state, you can also run `kubeadm upgrade --force` without - 应用新的 `kube-dns` 和 `kube-proxy` 清单，并强制创建所有必需的 RBAC 规则。 - 如果旧文件在 180 天后过期，将创建 API 服务器的新证书和密钥文件并备份旧文件。 - -`kubeadm upgrade node experimental-control-plane` 实验控制平面在其他控制平面节点上执行以下操作： +- Upgrades the static Pod manifests for the control plane components. +--> +`kubeadm upgrade node experimental-control-plane` 在其他控制平面节点上执行以下操作： - 从集群中获取 kubeadm `ClusterConfiguration`。 - 可选地备份 kube-apiserver 证书。 - 升级控制平面组件的静态 Pod 清单。 \ No newline at end of file