平台中心
首页 / 平台管理 / 集群管理 / 集群 / 纳管集群 / 接入集群 / 接入 AWS EKS 集群

接入 AWS EKS 集群

支持将已部署的 AWS EKS（Amazon Elastic Kubernetes Service）集群接入平台统一管理。

前提条件

准备操作环境

为遵守 AWS EKS 的安全规范，接下来的步骤都需要使用 Cloud Shell 操作。

  1. 确保与 Amazon AWS Console 的网络互通。

  2. 在搜索栏输入 cloudshell 关键词，打开 Cloud Shell 功能页 。

  3. 检查当前所在的地区是否是接入集群所在的地区，有必要的话需要先切换到集群所在地区。

  4. 等待 Cloud Shell 就绪后，清空命令行，执行如下命令：

# 获得当前地区的集群列表，也检查当前账号是否有足够的权限
aws eks list-clusters

# <region-code> 为集群所在地区的代码，如 us-west-1
# <my-cluster> 为打算接入的集群名称，可从上一条命令的输出中获得
aws eks update-kubeconfig --region <region-code> --name <my-cluster>

# KubeConfig 文件已经保存在 "${HOME}/.kube/config" 路径下
# 可将其内容保存为文件，之后上传给本平台解析
cat "${HOME}/.kube/config"
  1. 至此环境准备就绪。后续 获取集群信息、接入集群 等步骤中，在接入集群环境上执行的命令都应在 Cloud Shell 中执行。

获取集群信息

获取接入集群令牌

公有云集群的 KubeConfig 文件无法被直接用于接入集群。

请参考常见问题 如何获取集群信息？ 获取接入集群令牌。

接入集群

  1. 在左侧导航栏中，单击 集群管理 > 集群。

  2. 单击 接入集群。

  3. 参照以下说明，配置相关参数。

    参数 说明
    镜像仓库 存储集群所需平台组件镜像的仓库。
    - 平台默认：部署 global 时配置的镜像仓库。
    - 私有仓库：提前搭建的并存放平台所需组件的镜像仓库。需输入访问镜像仓库的 私有镜像仓库地址、端口、用户名、密码。
    - 公共仓库：使用位于公网的镜像仓库服务，使用前，您需首先参考 更新公网镜像仓库云凭证 以获取仓库认证权限。
    集群信息 提示：请上传 KubeConfig 文件，由平台自动解析并填写。

    集群地址：接入集群对外暴露 API Server 的访问地址，用于平台访问接入集群的 API Server。

    CA 证书：接入集群的 CA 证书。

    认证方式：接入集群的认证方式，需要使用上一步创建的具备 集群管理权限 的 令牌（Token）进行认证。

  4. 单击 检查连通性 以检查与接入集群的网络连通性并自动识别接入集群的类型，集群类型将以表单右上角角标的形式展现。

  5. 连通性检查通过后，单击 接入，并确认。

    提示：

    • 单击处于 接入中 状态的集群右侧的 图标，可在弹出的 执行进度 对话框中，查看集群的执行进度（status.conditions）。
    • 集群接入成功后，在集群列表可查看集群的关键信息，集群的状态显示为正常，并可执行集群相关操作。

网络相关配置

为确保 global 集群与被接入集群网络互通，您须参考 接入集群网络相关配置 。

后续操作

部署插件

集群接入成功后，您可前往 插件管理 选择为集群部署必须的插件，包括监控组件、日志采集组件、日志存储组件等。

提示：部署 Prometheus 监控组件时，请先进行 EKS 集群部署 Prometheus 监控组件网络相关配置 。

纳管集群下命名空间

接入集群后，您可通过基于集群 创建项目 ，或通过 添加项目关联集群 的方式将集群添加至已有项目，可将新接入的集群关联至项目。

进而，通过 导入命名空间 操作，将集群下已有的 Kubernetes 命名空间纳入到平台的项目下进行管理。

Ingress（入站规则）及存储初始化

接入集群后，若需使用 Ingress （入站规则）及存储相关功能，请参考 AWS EKS 集群 Ingress 初始化配置 、 AWS EKS 集群存储初始化配置 。

常见问题

接入集群后添加节点按钮置灰，如何添加节点？

不支持在平台界面添加节点，请于联系集群供应商添加。

接入集群的证书管理功能支持哪些证书？

  1. Kubernetes 证书：所有接入集群仅支持在平台证书管理界面查看 APIServer 证书信息，不支持查看其他 Kubernetes 证书且不支持自动轮换。

  2. 平台组件证书：所有接入集群可在平台证书管理界面查看平台组件证书信息且支持自动轮换。

还有哪些功能不支持接入的 AWS EKS 集群？