Alauda Container Platform
  • 简体中文

    • 导入 Huawei Cloud CCE 集群（公有云）

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

    目录

    前提条件获取镜像仓库地址确定镜像仓库是否需要额外配置获取集群信息获取导入集群令牌导入集群网络配置后续操作Ingress（入站规则）和存储初始化FAQ导入集群后，添加节点按钮显示为灰色。如何添加节点？证书管理功能支持导入集群的哪些证书？此提供商特定导入路径的限制

    前提条件

    • 集群上的 Kubernetes 版本和参数符合标准 Kubernetes 集群组件版本和参数要求。

    • 确保集群类型为 Huawei Cloud CCE 集群，并且账号具有维护控制平面的权限。目前不支持 Turbo 集群。

    • Huawei Cloud CCE 集群创建后默认无法访问外部网络资源。导入集群前，请确保待导入集群可以访问平台访问地址。

    获取镜像仓库地址

    • 若要使用 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 'Test passed: The image registry uses certificates issued by trusted CA authorities. You do not need to execute the content in the "Trust Insecure Image Registry" section.'
else
    echo 'Test failed: The image registry does not support HTTPS or the certificate is not trusted. See the "Trust Insecure Image Registry" section for configuration.'
fi

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

    获取集群信息

    1. 确保与 Huawei Cloud 控制台的网络连通。

    2. 访问 Cloud Container Engine CCE 功能的集群管理页面；找到要导入的集群，然后点击集群名称进入详情页面。

    3. 如下图所示，按照导航找到下载 KubeConfig 文件按钮：Cluster Information - Connection Information - kubectl - Configuration，然后下载 KubeConfig 文件。

    获取导入集群令牌

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

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

    导入集群

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

    2. 点击 导入集群。

    3. 根据以下说明配置与 Image Registry 相关的参数。

      参数描述
      镜像仓库用于存储集群所需平台组件镜像的仓库。
      - 平台默认：部署 global 集群时配置的镜像仓库。
      - 私有仓库：用于存储平台所需组件的预构建仓库。请输入用于访问镜像仓库的私有镜像仓库地址、端口、用户名和密码。
      - 公有仓库：使用位于公有网络中的镜像仓库服务。使用前，请更新公有镜像仓库云凭证以获取仓库认证权限。
      集群信息提示：上传 KubeConfig 文件，平台将自动解析并填充信息。

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

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

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

    4. 点击 Parse KubeConfig File 按钮，并提交上一步下载的 KubeConfig 文件。平台将自动解析并填充与 Cluster Information 相关的参数。

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

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

      提示：

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

    网络配置

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

    后续操作

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

    导入集群后，如果需要使用 Ingress（入站规则）和存储相关功能，请参阅Huawei Cloud CCE 集群 Ingress 初始化配置和Huawei Cloud CCE 集群存储初始化配置。

    FAQ

    导入集群后，添加节点按钮显示为灰色。如何添加节点？

    不支持通过平台界面添加节点。请联系集群提供商添加节点。

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

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

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

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

    • 不支持检索审计数据。

    • 不支持 ETCD、Scheduler 和 Controller Manager 相关的监控信息。支持 APIServer 部分监控图表。

    • 无法检索 Kubernetes APIServer 证书以外的集群证书相关信息。