使用 Amazon VPC CNI plugin for Kubernetes Amazon EKS 附加组件

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

kubectl describe daemonset aws-node --namespace kube-system | grep amazon-k8s-cni: | cut -d : -f 3

示例输出如下。

v1.12.6-eksbuild.2

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

$ aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni --query addon.addonVersion --output text

如果返回来的是版本号，则表明您的集群上安装有 Amazon EKS 类型的附加组件，而且此流程中其余的步骤，您也不需要走完。如果返回来的是一个错误，则表明您的集群上没有安装 Amazon EKS 类型的附加组件。要安装，就需完成此流程中其余的步骤。

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

kubectl get daemonset aws-node -n kube-system -o yaml > aws-k8s-cni-old.yaml

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

aws eks create-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version v1.17.1-eksbuild.1 \
    --service-account-role-arn arn:aws:iam::111122223333:role/AmazonEKSVPCCNIRole

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

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

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

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

示例输出如下。

v1.17.1-eksbuild.1

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

（可选）将 cni-metrics-helper 安装到您的集群。它会抓取弹性网络接口和 IP 地址信息，在集群级别聚合这些信息，并将指标发布到 Amazon CloudWatch。有关更多信息，请参阅 GitHub 上的 cni-metrics-helper。

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

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

示例输出如下。

v1.12.6-eksbuild.2

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

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

kubectl get daemonset aws-node -n kube-system -o yaml > aws-k8s-cni-old.yaml

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

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

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni

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

示例输出如下。

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "ACTIVE",
        "addonVersion": "v1.17.1-eksbuild.1",
        "health": {
            "issues": []
        },
        "addonArn": "arn:aws:eks:region:111122223333:addon/my-cluster/vpc-cni/74c33d2f-b4dc-8718-56e7-9fdfa65d14a9",
        "createdAt": "2023-04-12T18:25:19.319000+00:00",
        "modifiedAt": "2023-04-12T18:40:28.683000+00:00",
        "serviceAccountRoleArn": "arn:aws:iam::111122223333:role/AmazonEKSVPCCNIRole",
        "tags": {},
        "configurationValues": "{\"env\":{\"AWS_VPC_K8S_CNI_EXTERNALSNAT\":\"true\"}}"
    }
}

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

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

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

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

kubectl describe daemonset aws-node --namespace kube-system | grep amazon-k8s-cni: | cut -d : -f 3

示例输出如下。

v1.12.6-eksbuild.2

输出可能不包含版本号。

备份当前设置，以便在更新版本后可以配置相同设置。

kubectl get daemonset aws-node -n kube-system -o yaml > aws-k8s-cni-old.yaml

要查看可用版本并熟悉要更新到的版本中的更改，请参阅 GitHub 上的 releases。请注意，我们建议更新到最新可用版本表中列出的相同 major.minor.patch 版本，即使 GitHub 上提供了更新版本。表中列出的构建版本并未在 GitHub 上列出的自行管理版本中指定。通过完成以下选项之一中的任务来更新您的版本：

确认新版本现已安装在集群上。

kubectl describe daemonset aws-node --namespace kube-system | grep amazon-k8s-cni: | cut -d : -f 3

示例输出如下。

v1.17.1

（可选）将 cni-metrics-helper 安装到您的集群。它会抓取弹性网络接口和 IP 地址信息，在集群级别聚合这些信息，并将指标发布到 Amazon CloudWatch。有关更多信息，请参阅 GitHub 上的 cni-metrics-helper。