更新集群

更新集群的 Kubernetes 版本的步骤

1. 比较集群控制层面的 Kubernetes 版本与节点的 Kubernetes 版本。

   • 使用以下命令获取集群控制层面的 Kubernetes 版本。

     kubectl version --short

   • 使用以下命令获取节点的 Kubernetes 版本。此命令会返回所有自我管理和托管的 Amazon EC2 和 Fargate 节点。每个 Fargate Pod 都作为其自身的节点列出。

     kubectl get nodes

   集群中的托管节点和 Fargate 节点的 Kubernetes 次要版本必须与控制层面的当前版本相同，然后才能将控制层面更新为新的 Kubernetes 版本。例如，如果您的控制层面运行的是版本 1.20，任意节点运行的是版本 1.19，请在将控制层面的 Kubernetes 版本更新为 1.21 之前，先将节点更新为版本 1.20。我们还建议您，在更新控制层面之前将自我管理节点更新为与控制层面相同的版本。有关更多信息，请参阅 更新托管节点组 和 自行管理节点的更新。要更新 Fargate 节点的版本，请删除节点所表示的 Pod，然后在更新控制层面后重新部署该 Pod。

2. Amazon EKS 集群上原定设置已启用 Pod 安全策略准入控制器。在升级集群前，请确保在更新之前已实施适当的 Pod 安全策略，以避免出现任何问题。您可以使用以下命令检查默认策略：

   kubectl get psp eks.privileged

   如果您收到以下错误，请参阅原定设置 Pod 安全策略，然后再继续操作。

   Error from server (NotFound): podsecuritypolicies.extensions "eks.privileged" not found

3. 如果您最初在 Kubernetes 1.17 或更早版本上部署了集群，那么您可能需要从 CoreDNS 清单中删除已停用的条款。

   1. 检查您的 CoreDNS 清单是否有一行仅包含词语 upstream。

      kubectl get configmap coredns -n kube-system -o jsonpath='{$.data.Corefile}' | grep upstream

      如果未返回任何输出，则说明您的清单没有此类行，您可以跳到下一步更新集群。如果返回了词语 upstream，则您需要删除该行。

   2. 编辑 configmap，删除文件顶部附近仅包含词语 upstream 的行。不要更改文件中的任何其他内容。删除该行后，保存更改。

      kubectl edit configmap coredns -n kube-system -o yaml

4. 使用 eksctl、Amazon Web Services Management Console 或 Amazon CLI 更新您的集群。

   重要

   • 由于 Amazon EKS 运行高度可用的控制层面，您可以一次只更新一个次要版本。请参阅 Kubernetes 版本和版本倾斜支持政策以了解此要求背后的原理。因此，如果您的当前版本为 1.19，并且您想要升级到 1.21，则必须先将集群升级到 1.20，然后再将它从 1.20 升级到 1.21。

   • 在更新之前，确保您的托管节点和 Fargate 节点上的 kubelet 与控制层面的 Kubernetes 版本相同。我们还建议，您的自我管理节点与控制层面的版本相同，尽管它们最多可以比控制层面的当前版本低一个版本。

   • 将集群更新到较新版本可能会覆盖自定义配置。

   eksctl

   此过程需要 eksctl 版本 0.84.0 或更高版本。可以使用以下命令来查看您的版本：

   eksctl version

   有关安装或更新 eksctl 的更多信息，请参阅 安装或升级 eksctl。

   使用以下命令将 Amazon EKS 控制层面的 Kubernetes 版本更新到比当前版本高的一个次要版本。将 <my-cluster>（包括 <>）替换为您的集群名称。

   eksctl upgrade cluster --name <my-cluster> --approve

   更新过程可能需要几分钟才能完成。

   Amazon Web Services Management Console

   1. 访问 https://console.aws.amazon.com/eks/home#/clusters 打开 Amazon EKS 控制台。

   2. 选择要更新的 Amazon EKS 集群的名称，然后选择 Update cluster version (更新集群版本)。

   3. 对于 Kubernetes version (Kubernetes 版本)，选择您的集群要更新到的版本并选择 Update (更新)。

   4. 对于 Cluster name (集群名称)，键入您的集群的名称并选择 Confirm (确认)。

      更新过程可能需要几分钟才能完成。

   Amazon CLI

   1. 使用以下 Amazon CLI 命令更新 Amazon EKS 集群。将 <example-values>（包括 <>）替换为您自己的值。

      aws eks update-cluster-version \
       --region <region-code> \
       --name <my-cluster> \
       --kubernetes-version <1.21>

      输出：

      {
          "update": {
              "id": "<b5f0ba18-9a87-4450-b5a0-825e6e84496f>",
              "status": "InProgress",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.21"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      ...
              "errors": []
          }
      }

   2. 使用以下命令监控集群更新的状态。使用上一命令返回的集群名称和更新 ID。当状态显示为 Successful 时，您的更新将完成。更新过程可能需要几分钟才能完成。

      aws eks describe-update \
        --region <region-code> \
        --name <my-cluster> \
        --update-id <b5f0ba18-9a87-4450-b5a0-825e6e84496f>

      输出：

      {
          "update": {
              "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
              "status": "Successful",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.21"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      ...
              "errors": []
          }
      }

5. 集群更新完成后，将节点更新为与已更新的集群相同的 Kubernetes 版本。有关更多信息，请参阅 自行管理节点的更新 或 更新托管节点组。在 Fargate 上启动的任何新 Pod 都将具有与您的集群版本匹配的 kubelet 版本。现有 Fargate Pod 不会更改。

6. （可选）如果您在更新集群之前将 Kubernetes Cluster Autoscaler 部署到了集群，请将 Cluster Autoscaler 更新为与您升级后的 Kubernetes 主版本和次要版本匹配的最新版本。

   1. 在 Web 浏览器中打开 Cluster Autoscaler 版本页面，找到与您集群的 Kubernetes 主版本和次要版本相匹配的 Cluster Autoscaler。例如，如果您集群的 Kubernetes 版本是 1.21，则查找以 1.21 开头的最新 Cluster Autoscaler 版本。记录该版本的语义版本号 (<1.21.n>) 以在下一步中使用。

   2. 使用以下命令，将 Cluster Autoscaler 映像标签设置为您在上一步中记录的版本。如有必要，将 1.21.n 替换为您自己的值。

      kubectl -n kube-system set image deployment.apps/cluster-autoscaler cluster-autoscaler=public.ecr.aws/bitnami/cluster-autoscaler:v1.21.n

7. （仅限于具有 GPU 节点的集群）如果您的集群具有带 GPU 支持（例如，p3.2xlarge）的节点组，则您必须使用以下命令在您的集群上更新“适用于 Kubernetes 的 NVIDIA 设备插件”DaemonSet。

   kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/v0.9.0/nvidia-device-plugin.yml

8. 更新 VPC CNI、CoreDNS 和 kube-proxy 附加组件。

   • 如果您将集群更新为 1.17 或更早版本，请参阅 更新 Amazon VPC CNI 自行管理附加组件、更新 CoreDNS 自行管理附加组件 和 更新 kube-proxy 自行管理的附加组件 以更新您的 Amazon VPC CNI、CoreDNS 和 kube-proxy 附加组件。

   • 如果您将集群更新为 1.18，则可以添加 Amazon EKS 附加组件。有关更多信息，请参阅 添加 Amazon VPC CNI Amazon EKS 附加组件、添加 CoreDNS Amazon EKS 附加组件 或 添加 kube-proxy Amazon EKS 附加组件。要了解有关 Amazon EKS 附加组件的详情，请参阅 Amazon EKS 附加组件。

   • 如果您已更新到 1.19 或更高版本，并且正在使用 Amazon EKS 附加组件，请在 Amazon EKS 控制台中选择 Clusters（集群），然后在左侧导航窗格中选择要更新的集群的名称。控制台中会显示通知，告诉您有一个新版本可用于每个具有可用更新的附加组件。要更新附加组件，请选择 Configuration（配置）选项卡，然后选择 Add-ons（附加组件）选项卡。在具有可用更新的附加组件的其中一个框中，选择 Update now（立即更新），选择一个可用版本，然后选择 Update（更新）。

   • 此外，您也可以使用 Amazon CLI 或 eksctl 更新 Amazon VPC CNI、CoreDNS 和 kube-proxy Amazon EKS 附加组件。