使用 CoreDNS Amazon EKS 附加组件

查看集群上当前安装的附加组件版本。

kubectl describe deployment coredns --namespace kube-system | grep coredns: | cut -d : -f 3

输出示例如下。

v1.8.7-eksbuild.4

查看集群上当前安装的附加组件类型。根据您创建集群时使用的工具，您的集群上目前可能没有安装 Amazon EKS 附加组件类型。将 my-cluster 替换为您集群的名称。

aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text

如果返回版本号，则表明您的集群上安装有 Amazon EKS 附加组件类型，且您不需要完成此过程的其余步骤。如果返回错误，则表明您的集群上安装有 Amazon EKS 类型的附加组件。完成此过程的其余步骤以进行安装。

保存您当前安装的附加组件的配置。

kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml

使用 Amazon CLI 创建附加组件。如果要使用 Amazon Web Services Management Console 或 eksctl 来创建附加组件，请参阅 创建附加组件 并指定 coredns 为附加组件名称。将以下命令复制到您的设备。根据需要对该命令进行以下修改，然后运行修改后的命令。

aws eks create-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.9.3-eksbuild.2

如果您对当前附加组件应用的自定义设置与 Amazon EKS 附加组件的默认设置相冲突，则创建可能会失败。如果创建失败，您会收到一条可以帮助您解决问题的错误信息。或者，您可以将 --resolve-conflicts OVERWRITE 添加到前面的命令中。这样一来，附加组件会覆盖任何现有的自定义设置。创建附加组件后，您可以使用自定义设置对其进行更新。

确认您的集群的 Kubernetes 版本的附加组件最新版本已添加到您的集群。将 my-cluster 替换为您的集群名称。

aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text

附加组件创建可能需要几秒钟才能完成。

输出示例如下。

v1.9.3-eksbuild.2

如果您在创建 Amazon EKS 附加组件之前对原始附加组件进行了自定义设置，则请使用您在上一步中保存的配置，以使用您的自定义设置更新 Amazon EKS 附加组件。

查看集群上当前安装的附加组件版本。将 my-cluster 替换为您的集群名称。

aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query "addon.addonVersion" --output text

输出示例如下。

v1.8.7-eksbuild.4

如果返回的版本与最新版本表中集群的 Kubernetes 版本的版本相同，则您的集群上已经安装了最新版本，且您无需完成此过程的其余部分。如果您在输出中收到错误信息而不是版本号，则您的集群上没有安装 Amazon EKS 类型的附加组件。您需要先创建附加组件，然后才能使用此过程对其进行更新。

保存您当前安装的附加组件的配置。

kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml

使用 Amazon CLI 更新您的附加组件。如果您想要使用 Amazon Web Services Management Console 或 eksctl 更新附加组件，则请参阅更新附加组件。将以下命令复制到您的设备。根据需要对该命令进行以下修改，然后运行修改后的命令。

确认附加组件版本已更新。将 my-cluster 替换为您的集群名称。

aws eks describe-addon --cluster-name my-cluster --addon-name coredns

可能需要几秒钟才能完成更新。

输出示例如下。

{
    "addon": {
        "addonName": "coredns",
        "clusterName": "my-cluster",
        "status": "ACTIVE",
        "addonVersion": "v1.9.3-eksbuild.2",
        "health": {
            "issues": []
        },
        "addonArn": "arn:aws:eks:region:111122223333:addon/my-cluster/coredns/d2c34f06-1111-2222-1eb0-24f64ce37fa4",
        "createdAt": "2023-03-01T16:41:32.442000+00:00",
        "modifiedAt": "2023-03-01T18:16:54.332000+00:00",
        "tags": {},
        "configurationValues": "{\"replicaCount\":3}"
    }
}

确认已在集群上安装自行管理类型的附加组件。将 my-cluster 替换为您集群的名称。

aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text

如果返回错误消息，则表明集群上安装有自行管理类型的附加组件。完成此过程的其余步骤。如果返回版本号，则表明集群上安装有 Amazon EKS 类型的附加组件。要更新附加组件的 Amazon EKS 类型，请使用 更新 Amazon EKS 附加组件 中的过程，而不是此过程。如果不熟悉这些附加组件类型之间的区别，请参阅 Amazon EKS 附加组件。

查看集群上当前安装的容器映像版本。

kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3

输出示例如下。

v1.8.7-eksbuild.2

如果您的当前 CoreDNS 版本是 v1.5.0 或更高版本，但早于 CoreDNS 版本表中列出的版本，请跳过此步骤。如果您的当前版本低于 1.5.0，则需要修改 ConfigMap，以使 CoreDNS 使用转发附加组件，而不是代理附加组件。

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

检索您当前的 CoreDNS 映像版本：

kubectl describe deployment coredns -n kube-system | grep Image
 

输出示例如下。

918309763551.dkr.ecr.region-code.amazonaws.com.cn/eks/coredns:v1.8.7-eksbuild.2

如果您要更新到 CoreDNS 1.8.3 或更高版本，则需要将 endpointslices 权限添加到 system:coredns Kubernetes clusterrole。

kubectl edit clusterrole system:coredns -n kube-system

在文件中的 rules 部分的现有权限行下添加以下行。

...
- apiGroups:
  - discovery.k8s.io
  resources:
  - endpointslices
  verbs:
  - list
  - watch
...

通过来更新 CoreDNS 附加组件，将 918309763551 和 region-code 替换为上一步中返回的输出值。将 v1.9.3-eksbuild.2 替换为您的 Kubernetes 版本的最新版本表中列出的 CoreDNS 版本。

kubectl set image deployment.apps/coredns -n kube-system  coredns=918309763551.dkr.ecr.region-code.amazonaws.com.cn/eks/coredns:v1.9.3-eksbuild.2

输出示例如下。

deployment.apps/coredns image updated

再次检查容器映像版本，确认它已更新到您在上一步中指定的版本。

kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3

输出示例如下。

v1.9.3-eksbuild.2