#导入 Amazon EKS 集群

使用此提供商专用操作步骤，将现有 Amazon EKS 集群作为第三方集群导入。除非有文档说明的提供商专用功能支持相应生命周期管理，否则外部提供商仍负责提供商基础设施，以及由提供商管理的 Kubernetes 和节点生命周期。

#前提条件

• 集群的 Kubernetes 版本和设置符合导入标准 Kubernetes 集群的版本兼容性要求。

• 镜像仓库必须支持 HTTPS，并提供由公共 CA 签发的有效 TLS 证书。

#准备环境

为遵循 AWS EKS 安全实践，请在 AWS CloudShell 中执行以下操作步骤。

1. 确保可以连接到 AWS Management Console。

2. 搜索 cloudshell，然后打开 CloudShell。

3. 确认所选地域与目标集群所在地域一致；如有需要，请切换地域。

4. CloudShell 准备就绪后，清空终端并运行：

   # List clusters in the current region and verify your permissions
   aws eks list-clusters
   
   # <region-code> is the region of the cluster, e.g., us-west-1
   # <my-cluster> is the cluster name from the previous output
   aws eks update-kubeconfig --region <region-code> --name <my-cluster>
   
   # The kubeconfig file is saved to "${HOME}/.kube/config"
   # Save its content to a file, then upload it to the platform for parsing
   cat "${HOME}/.kube/config"

5. 现在环境已准备就绪。后续步骤（例如获取集群信息和导入集群）中，请在 CloudShell 内运行针对目标集群的命令。

#获取集群信息

#获取导入令牌

公有云集群的 KubeConfig 不能直接用于导入。

如需获取集群导入令牌，请参阅如何获取集群信息？。

#导入集群

1. 在左侧导航中，前往集群管理 > 集群。

2. 点击导入集群。

3. 按如下方式配置参数。

   参数	说明
   镜像仓库	存储集群所需平台组件镜像的仓库。- 平台默认：部署 global 集群时配置的仓库。- 私有仓库：托管所需镜像的预置仓库。请提供私有仓库地址、端口、用户名和密码。- 公共仓库：公共互联网仓库。使用前，请按照更新公共仓库云凭据中的说明获取凭据。
   集群信息	提示：上传 kubeconfig 文件，让平台自动解析。集群端点：目标集群对外公开的外部 API 服务器地址。CA 证书：集群的 CA 证书。身份验证：使用上一步创建的、具有集群管理员权限的令牌。

4. 点击检查连通性，验证网络连接并自动检测集群类型。检测到的类型会以徽标形式显示在表单右上角。

5. 连通性检查通过后，点击导入，然后确认。

   提示：

   • 对于处于导入中状态的集群，点击详情图标，可在执行进度对话框（status.conditions）中查看进度。
   • 导入成功后，集群列表会显示关键信息。集群状态为正常，并且可以执行集群操作。

#网络配置

确保 global 集群与导入的集群之间网络连通。请参阅导入集群的网络配置。

#后续步骤

#初始化 Ingress 和存储

如果需要 Ingress 和存储功能，请参阅为 AWS EKS 初始化 Ingress和为 AWS EKS 初始化存储。

#常见问题

#导入后“添加节点”按钮被禁用。如何添加节点？

平台 UI 不支持添加节点。请通过集群提供商添加节点。

#导入的集群的证书管理支持哪些证书？

1. Kubernetes 证书：只能查看 API 服务器证书。其他 Kubernetes 证书不可见，也不会自动轮换。

2. 平台组件证书：可在平台中查看，并支持自动轮换。

#此提供商专属导入路径的限制

• 审计数据不可用。

• 不支持 ETCD、Scheduler 和 Controller Manager 指标；可使用部分 API 服务器图表。

• 除 Kubernetes API 服务器证书外，其他证书详细信息不可用。