管理 Amazon EKS 附加组件

查看某个集群版本的可用附加组件名称。将 1.30 替换为您的集群版本。

eksctl utils describe-addon-versions --kubernetes-version 1.30 | grep AddonName

示例输出如下。

"AddonName": "aws-ebs-csi-driver",
                        "AddonName": "coredns",
                        "AddonName": "kube-proxy",
                        "AddonName": "vpc-cni",
                        "AddonName": "adot",
                        "AddonName": "dynatrace_dynatrace-operator",
                        "AddonName": "upbound_universal-crossplane",
                        "AddonName": "teleport_teleport",
                        "AddonName": "factorhouse_kpow",
                        [...]

查看要创建的附加组件的可用版本。将 1.30 替换为您的集群版本。将 name-of-addon 替换为您要查看其版本的附加组件的名称。该名称必须是前面步骤中返回的名称之一。

eksctl utils describe-addon-versions --kubernetes-version 1.30 --name name-of-addon | grep AddonVersion

以下输出是一个示例，显示了为名为 vpc-cni 的附加组件返回的内容。您可以看到该附加组件有多个可用版本。

"AddonVersions": [
    "AddonVersion": "v1.12.0-eksbuild.1",
    "AddonVersion": "v1.11.4-eksbuild.1",
    "AddonVersion": "v1.10.4-eksbuild.1",
    "AddonVersion": "v1.9.3-eksbuild.1",

创建 Amazon EKS 附加组件。将以下命令复制到您的设备。根据需要对该命令进行以下修改，然后运行修改后的命令：

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。

在左侧导航窗格中，选择 Clusters（集群），然后选择要为其创建附加组件的集群的名称。

选择附加组件选项卡。

选择获取更多附加组件。

在 Configure selected add-ons settings（配置选定的附加组件设置）页面上：

在查看和添加页面上，选择创建。附加组件安装完成后，您会看到您安装的附加组件。

确定哪些附加组件可用。您可以看到所有可用的附加组件及其类型和发布者。将 1.30 替换为您的集群版本。

aws eks describe-addon-versions --kubernetes-version 1.30 \
    --query 'addons[].{Name: addonName, Type: type}' --output table

示例输出如下。

-------------------------------------------------------
|                DescribeAddonVersions                |
+-------------------------------+---------------------+
|             Name              |        Type         |
+-------------------------------+---------------------+
|  aws-ebs-csi-driver           |  storage            |
|  coredns                      |  networking         |
|  kube-proxy                   |  networking         |
|  vpc-cni                      |  networking         |
|  adot                         |  observability      |
|  [...]                        |  [...]              |
+-------------------------------+---------------------+

您的输出可能会有所不同。在此输出示例中，有三个不同的 networking 类型的附加组件和五个发布者类型为 eks 的附加组件。

您可以看到每个附加组件的可用版本。将 1.30 替换为您的集群版本，将 vpc-cni 替换为上一步返回的附加组件名称。

aws eks describe-addon-versions --kubernetes-version 1.30 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

示例输出如下。

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

默认情况下，Defaultversion 列中值为 True 的版本是创建附加组件时使用的版本。

（可选）通过运行以下命令查找所选附加组件的配置选项：

aws eks describe-addon-configuration --addon-name vpc-cni --addon-version v1.12.0-eksbuild.1

{
    "addonName": "vpc-cni",
    "addonVersion": "v1.12.0-eksbuild.1",
    "configurationSchema": "{\"$ref\":\"#/definitions/VpcCni\",\"$schema\":\"http://json-schema.org/draft-06/schema#\",\"definitions\":{\"Cri\":{\"additionalProperties\":false,\"properties\":{\"hostPath\":{\"$ref\":\"#/definitions/HostPath\"}},\"title\":\"Cri\",\"type\":\"object\"},\"Env\":{\"additionalProperties\":false,\"properties\":{\"ADDITIONAL_ENI_TAGS\":{\"type\":\"string\"},\"AWS_VPC_CNI_NODE_PORT_SUPPORT\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_ENI_MTU\":{\"format\":\"integer\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_CONFIGURE_RPFILTER\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_CUSTOM_NETWORK_CFG\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_EXTERNALSNAT\":{\"format\":\"boolean\",\"type\":\"string\"},\"AWS_VPC_K8S_CNI_LOGLEVEL\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_LOG_FILE\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_RANDOMIZESNAT\":{\"type\":\"string\"},\"AWS_VPC_K8S_CNI_VETHPREFIX\":{\"type\":\"string\"},\"AWS_VPC_K8S_PLUGIN_LOG_FILE\":{\"type\":\"string\"},\"AWS_VPC_K8S_PLUGIN_LOG_LEVEL\":{\"type\":\"string\"},\"DISABLE_INTROSPECTION\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_METRICS\":{\"format\":\"boolean\",\"type\":\"string\"},\"DISABLE_NETWORK_RESOURCE_PROVISIONING\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_POD_ENI\":{\"format\":\"boolean\",\"type\":\"string\"},\"ENABLE_PREFIX_DELEGATION\":{\"format\":\"boolean\",\"type\":\"string\"},\"WARM_ENI_TARGET\":{\"format\":\"integer\",\"type\":\"string\"},\"WARM_PREFIX_TARGET\":{\"format\":\"integer\",\"type\":\"string\"}},\"title\":\"Env\",\"type\":\"object\"},\"HostPath\":{\"additionalProperties\":false,\"properties\":{\"path\":{\"type\":\"string\"}},\"title\":\"HostPath\",\"type\":\"object\"},\"Limits\":{\"additionalProperties\":false,\"properties\":{\"cpu\":{\"type\":\"string\"},\"memory\":{\"type\":\"string\"}},\"title\":\"Limits\",\"type\":\"object\"},\"Resources\":{\"additionalProperties\":false,\"properties\":{\"limits\":{\"$ref\":\"#/definitions/Limits\"},\"requests\":{\"$ref\":\"#/definitions/Limits\"}},\"title\":\"Resources\",\"type\":\"object\"},\"VpcCni\":{\"additionalProperties\":false,\"properties\":{\"cri\":{\"$ref\":\"#/definitions/Cri\"},\"env\":{\"$ref\":\"#/definitions/Env\"},\"resources\":{\"$ref\":\"#/definitions/Resources\"}},\"title\":\"VpcCni\",\"type\":\"object\"}}}"
}

输出是标准的 JSON 架构。

以下是适用于上述架构的 JSON 格式的有效配置值示例。

{
  "resources": {
    "limits": {
      "cpu": "100m"
    }
  }
}

以下是适用于上述架构的 YAML 格式的有效配置值示例。

  resources: 
    limits: 
      cpu: 100m    

确定该附加组件是否需要 IAM 权限。如果是，则需要（1）确定是否要使用 EKS 容器组身份或服务账户的 IAM 角色（IRSA），（2）确定要与附加组件一起使用的 IAM 角色的 ARN，以及（3）确定附加组件使用的 Kubernetes 服务账户的名称。您可以在文档中或使用 Amazon API 找到此信息，请参阅检索有关附加组件的 IAM 信息。

创建 Amazon EKS 附加组件。将以下命令复制到您的设备。根据需要对该命令进行以下修改，然后运行修改后的命令：

aws eks create-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
     <service-account-configuration> --configuration-values '{"resources":{"limits":{"cpu":"100m"}}}' --resolve-conflicts OVERWRITE

aws eks create-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    <service-account-configuration> --configuration-values 'file://example.yaml' --resolve-conflicts OVERWRITE

有关可用选项的完整列表，请参阅 Amazon EKS Command Line Reference（《Amazon EKS 命令行参考》）中的 create-addon。

确定集群上目前安装的附加组件和附加组件版本。将 my-cluster 替换为您的集群名称。

eksctl get addon --cluster my-cluster

示例输出如下。

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                v1.23.8-eksbuild.2
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0                v1.12.0-eksbuild.1,v1.11.4-eksbuild.1,v1.11.3-eksbuild.1,v1.11.2-eksbuild.1,v1.11.0-eksbuild.1

您的输出可能会有所不同，这取决于您的集群上安装的附加组件和版本。您可以看到，在前面的输出示例中，集群上的两个现有附加组件在 UPDATE AVAILABLE 列中有较新的版本可用。

更新附加组件。

有关更新附加组件的更多信息，请参阅 eksctl 文档中的 Addons（附加组件）。

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。

在左侧导航窗格中，选择 Clusters（集群），然后选择要为其配置附加组件的集群的名称。

选择附加组件选项卡。

选择附加组件框右上角的框，然后选择 Edit（编辑）。

在 Configure name of addon（配置 name of addon）页面上：

选择更新。

查看已安装的附加组件列表。将 my-cluster 替换为您的集群名称。

aws eks list-addons --cluster-name my-cluster

示例输出如下。

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni"
    ]
}

查看要更新的附加组件的当前版本。将 my-cluster 替换为您的集群名称，将 vpc-cni 替换为要更新的附加组件的名称。

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

示例输出如下。

v1.10.4-eksbuild.1

您可以看到该附加组件的哪些版本可用于您的集群版本。将 1.30 替换为您的集群版本，将 vpc-cni 替换为要更新的附加组件的名称。

aws eks describe-addon-versions --kubernetes-version 1.30 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

示例输出如下。

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

默认情况下，Defaultversion 列中值为 True 的版本是创建附加组件时使用的版本。

更新您的附加组件。将以下命令复制到您的设备。根据需要对该命令进行以下修改，然后运行修改后的命令。

aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts PRESERVE

检查更新的状态。将 my-cluster 替换为您的集群名称，将 vpc-cni 替换为您正在更新的附加组件的名称。

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

示例输出如下。

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "UPDATING",
[...]

当状态为 ACTIVE 时更新完成。