Alauda Container Platform
  • 简体中文

    • 导入 Tencent Cloud TKE 集群

    使用此提供商专用操作步骤，将现有的 Tencent Cloud TKE 专用集群或托管集群作为第三方集群导入。除非有记录在案的提供商专用功能支持相应的生命周期管理，否则外部提供商仍负责提供商基础设施以及提供商管理的 Kubernetes 和节点生命周期。

    TIP

    有关提供商集群类型的详细信息，请参阅提供商指南。

    目录

    前提条件获取镜像仓库地址确定镜像仓库是否需要额外配置获取 KubeConfig导入集群网络配置常见问题导入集群后，“添加节点”按钮置灰。如何添加节点？导入集群的证书管理功能支持哪些证书？此提供商特定导入路径的限制

    前提条件

    获取镜像仓库地址

    • 要使用在 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 "Image registry address is: $REGISTRY"

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

      REGISTRY=<external image registry address>  # Valid examples: registry.example.cn:60080 or 192.168.134.43
echo "Image registry address is: $REGISTRY"

    确定镜像仓库是否需要额外配置

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

      REGISTRY=<image registry address obtained from the "Obtain Image Registry Address" section>

if curl -s -o /dev/null --retry 3 --retry-delay 5 -- "https://${REGISTRY}/v2/"; then
    echo 'Verification passed: The image registry uses a certificate issued by a trusted CA. It is not necessary to execute the content in the "Trust Unsafe Image Registry" section.'
else
    echo 'Verification failed: The image registry does not support HTTPS or the certificate is not trusted. See the "Trust Unsafe Image Registry" section for configuration.'
fi

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

    获取 KubeConfig

    1. 登录 Tencent Cloud 容器服务管理平台。

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

    3. 根据实际客户网络选择公网访问或内网访问，然后下载 Kubeconfig 并将其保存到本地计算机。

    导入集群

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

    2. 单击导入集群。

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

      参数描述
      镜像仓库用于存储集群所需平台组件镜像的仓库。- 平台默认：在 global 集群部署期间配置的镜像仓库。- 私有仓库：用于存储平台所需组件镜像的预构建仓库。请输入用于访问镜像仓库的私有镜像仓库地址、端口、用户名和密码。- 公共仓库：使用位于公网的镜像仓库服务。使用前，请更新公共仓库云凭证以获取仓库身份验证权限。
      集群信息提示：可以手动填写，也可以通过 KubeConfig 文件上传，由平台自动解析并填写。解析 KubeConfig 文件：上传获取的 KubeConfig 文件后，平台将自动解析并填写集群信息，您可以修改自动填写的信息。集群地址：集群对外暴露的 API Server 访问地址，平台使用此地址访问集群的 API Server。CA 证书：集群的 CA 证书。注意：手动输入时，需要输入经过 Base64 解码的证书。身份验证方式：访问集群的身份验证方式，需要使用具有集群管理权限的 token（Token）或证书身份验证（客户端证书和密钥）。

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

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

      提示：

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

    网络配置

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

    常见问题

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

    TKE Dedicated 集群和TKE Managed 集群均不支持通过平台界面添加节点。请在提供商后端添加节点，或联系集群提供商。

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

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

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

    此提供商特定导入路径的限制

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

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

    • TKE Managed 集群和TKE Dedicated 集群均不支持获取集群证书相关信息，但 Kubernetes APIServer 证书除外。