#导入腾讯云 TKE 集群

将已有的腾讯云 TKE 专属集群或腾讯云 TKE 托管集群导入平台，实现统一管理。

#前提条件

• 集群上的 Kubernetes 版本及参数满足导入标准 Kubernetes 集群的组件版本及参数要求。

• 镜像仓库必须支持 HTTPS 访问，并提供由公有证书机构颁发的有效 TLS 证书。

#获取镜像仓库地址

• 若使用平台部署的镜像仓库（在 global 集群部署时配置），请在global 集群的控制节点执行以下命令获取地址：

  if [ "$(kubectl get productbase -o jsonpath='{.items[].spec.registry.preferPlatformURL}')" = 'false' ]; then
      REGISTRY=$(kubectl get cm -n kube-public global-info -o jsonpath='{.data.registryAddress}')
  else
      REGISTRY=$(kubectl get cm -n kube-public global-info -o jsonpath='{.data.platformURL}' | awk -F \// '{print $NF}')
  fi
  echo "镜像仓库地址为: $REGISTRY"

• 若使用外部镜像仓库，请手动设置 REGISTRY 变量。

  REGISTRY=<外部镜像仓库地址>  # 有效示例：registry.example.cn:60080 或 192.168.134.43
  echo "镜像仓库地址为: $REGISTRY"

#判断镜像仓库是否需要额外配置

1. 执行以下命令判断指定镜像仓库是否支持 HTTPS 访问且使用受信任 CA 颁发的证书：

   REGISTRY=<从“获取镜像仓库地址”部分获得的镜像仓库地址>
   
   if curl -s -o /dev/null --retry 3 --retry-delay 5 -- "https://${REGISTRY}/v2/"; then
       echo '验证通过：镜像仓库使用受信任 CA 颁发的证书，无需执行“信任不安全镜像仓库”部分内容。'
   else
       echo '验证失败：镜像仓库不支持 HTTPS 或证书不受信任，请参考“信任不安全镜像仓库”部分进行配置。'
   fi

2. 若验证失败，请参考 FAQ 如何信任不安全的镜像仓库？。

#获取 KubeConfig

1. 登录腾讯云容器服务管理平台。

2. 在 集群详情 > 基础信息 中查看 集群 APIServer 信息。

3. 根据客户实际网络选择 互联网访问 或 内网访问，然后下载 Kubeconfig 并保存至本地电脑。

#导入集群

1. 在左侧导航栏点击 集群管理 > 集群。

2. 点击 导入集群。

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

   参数	说明
   镜像仓库	集群所需平台组件镜像的存储仓库。- 平台默认：global 部署时配置的镜像仓库。- 私有仓库：预先搭建的存储平台所需组件镜像的仓库，需填写访问镜像仓库的私有镜像仓库地址、端口、用户名及密码。- 公共仓库：使用公网的镜像仓库服务，使用前需先参考更新公共仓库云凭证获取仓库认证权限。
   集群信息	提示：可手动填写，也可上传 KubeConfig 文件，由平台自动解析填写。解析 KubeConfig 文件：上传获取的 KubeConfig 文件后，平台会自动解析并填写集群信息，可对自动填写的信息进行修改。集群地址：集群对外暴露的 API Server 访问地址，平台通过该地址访问集群的 API Server。CA 证书：集群的 CA 证书。注意：手动输入时需输入 Base64 解码后的证书。认证方式：访问集群的认证方式，需使用带有集群管理权限的token（令牌）或证书认证（客户端证书和密钥）。

4. 点击 检查连通性，验证与待导入集群的网络连通性，并自动识别待导入集群类型。集群类型会以徽章形式显示在表单右上角。

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

   提示：

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

#网络配置

确保 global 集群与待导入集群之间的网络连通性。必须参考导入集群的网络配置。

#常见问题

#导入集群后，“添加节点”按钮变灰，如何添加节点？

TKE 专属集群和TKE 托管集群均不支持通过平台界面添加节点，请在后台添加或联系集群提供方添加。

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

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

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

#导入的 TKE 托管集群 和 TKE 专属集群 还不支持哪些功能？

• TKE 托管集群不支持获取审计数据。

• TKE 托管集群不支持 ETCD、Scheduler、Controller Manager 相关监控信息，但支持部分 APIServer 监控图表。

• TKE 托管集群和TKE 专属集群均不支持获取除 Kubernetes APIServer 证书外的集群证书相关信息。