连接集群

要使用 eksctl 注册集群

1. 提供名称、提供程序和区域来注册集群。

   eksctl register cluster --name my-cluster --provider my-provider --region region-code

   这会在本地驱动器上创建两个文件：my-first-registered-cluster.yaml 和 eks-connector-binding.yaml 文件。必须在 3 天内将这两个文件应用到外部集群，否则注册过期。

2. 在集群的本机环境中应用 eks-connector-binding.yaml 文件：

   kubectl apply -f eks-connector-binding.yaml

要使用 Amazon CLI 注册集群

1. 对于 Connector 配置，请指定您的 Amazon EKS Connector 代理 IAM 角色。有关更多信息，请参阅Amazon EKS Connector 所需的 IAM 角色。

   aws eks register-cluster \
        --name my-first-registered-cluster \
        --connector-config roleArn=arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole,provider="OTHER" \
        --region AWS_REGION

   输出示例如下。

   {
       "cluster": {
           "name": "my-first-registered-cluster",
           "arn": "arn:aws:eks:region:111122223333:cluster/my-first-registered-cluster",
           "createdAt": 1627669203.531,
           "ConnectorConfig": {
               "activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx",
               "activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx",
               "activationExpiry": 1627672543.0,
               "provider": "OTHER",
               "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole"
           },
           "status": "CREATING"
       }
   }             

   您将在后续步骤中使用 region、activationId 和 activationCode 值。

2. 下载 Amazon EKS Connector YAML 文件。

   curl -o eks-connector.yaml https://amazon-eks.s3.us-west-2.amazonaws.com/eks-connector/manifests/eks-connector/latest/eks-connector.yaml

3. 编辑 Amazon EKS Connector YAML 文件以将 %AWS_REGION%、%EKS_ACTIVATION_ID%、%EKS_ACTIVATION_CODE% 的所有引用替换为注册命令输出结果中的 region、activationId 和 activationCode。

   以下示例命令可以替换这些值。

   sed -i "s~%AWS_REGION%~$AWS_REGION~g; s~%EKS_ACTIVATION_ID%~$EKS_ACTIVATION_ID~g; s~%EKS_ACTIVATION_CODE%~$(echo -n $EKS_ACTIVATION_CODE | base64)~g" eks-connector.yaml

要向控制台注册 Kubernetes 集群。

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

2. 选择 Add cluster（添加集群），然后选择 Register（注册）以打开配置页面。

3. 在 Configure cluster (配置集群) 部分，填写以下字段：

   • Name（名称）– 集群的唯一名称。

   • Provider（提供程序）– 选择以显示 Kubernetes 集群提供程序的下拉列表。如果您不了解具体的提供程序，请选择 Other（其他）。

   • EKS Connector 角色：选择用于连接集群的角色。

4. 选择 Register cluster（注册集群）。

5. 此时将显示集群概览页面。选择 Download YAML file（下载 YAML 文件），以将清单文件下载到本地驱动程序。

   重要

   • 这是您下载此文件的唯一机会。不要离开此页面，否则将无法访问此链接，届时您必须注销集群并从头开始此步骤。

   • 对于已注册集群，只能使用一次清单文件。如果从 Kubernetes 集群中删除资源，则必须重新注册集群并获取新的清单文件。

   继续执行下一步，以将清单文件应用于 Kubernetes 集群。