更新集群

更新集群的 Kubernetes 版本

1. 将群集控制平面的 Kubernetes 版本与节点的 Kubernetes 版本进行比较。

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

     kubectl version --short

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

     kubectl get nodes

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

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. 编辑配置映射，删除文件顶部附近的行，该行仅包含upstream。不要更改文件中的任何其他内容。删除该行后，保存更改。

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

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

   重要

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

   • 确保已运行kubelet在您更新之前，您的托管节点和 Fargate 节点的 Kubernetes 版本与您的控制平面相同。我们还建议您的自我管理节点与控制平面处于相同的版本，尽管它们最多可以落后于控制平面的当前版本。

   • 将集群从 1.16 更新到 1.17 将失败，如果您有AmazonFargate 豆荚具有kubelet较早于 1.16 的次要版本。在将集群从 1.16 更新到 1.17 之前，您需要回收您的 Fargate 窗格，以便它们的kubelet为 1.16，然后尝试将群集更新为 1.17。

   • 您可能需要更新某些已部署的资源，然后才能更新到 1.16。有关更多信息，请参阅 Kubernetes 1.16 更新先决条件。

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

   eksctl

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

   eksctl version

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

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

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

   更新需要几分钟时间才能完成。

   Amazon Web Services Management Console

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

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

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

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

      更新需要几分钟时间才能完成。

   Amazon CLI

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

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

      输出：

      {
          "update": {
              "id": "<b5f0ba18-9a87-4450-b5a0-825e6e84496f>",
              "status": "InProgress",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.20"
                  },
                  {
                      "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.20"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      ...
              "errors": []
          }
      }

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

   • 如果您将集群更新为 1.17 或更早版本，请参阅手动更新亚马逊 VPC CNI 加载项、手动更新 CoreDNS 附加组件, 和更新kube-proxy手动加载更新您的亚马逊 VPC CNI、CoreDNS 和kube-proxy附加组件。

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

   • 如果您已更新到 1.19 或更高版本，并且正在使用亚马逊 EKS 加载项，请在亚马逊 EKS 控制台中选择集群，然后选择在左窗格中更新的集群的名称。通知显示在控制台中，通知您有一个新版本可用于每个具有可用更新的插件。

     • 要更新附加组件，您可以选择立即更新，选择可用版本，然后选择更新。

     • 或者，您可以选择配置选项卡，然后选择附加项选项卡。如果附加组件有可用更新，则可选择立即更新，选择一个可用版本，然后选择更新。

   • 您也可以使用Amazon CLI更新VPC CNI、CoreDNS, 和kube-proxyAmazon EKS 附加组件。

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

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

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

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

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

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

8. 集群更新完成后，将节点更新到已更新集群的同一 Kubernetes 版本。有关更多信息，请参阅 自行管理的节点更新 或 更新托管节点组。Fargate 上推出的任何新舱都将有一个kubelet版本匹配您的集群版本。现有的 Fargate 舱不会更改。