导入 Huawei Cloud CCE 集群(公有云)

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

前提条件

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

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

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

获取镜像仓库地址

  • 要使用全局集群部署中的平台部署的镜像仓库,请在全局集群的控制平面节点上执行以下命令以获取地址:
    if ! REGISTRY=$(kubectl get cm -n kube-public global-info -o jsonpath='{.data.registryAddress}'); then
        echo "Failed to read the registry address. Do not continue with an empty address." >&2
        exit 1
    fi
    if [ "$REGISTRY" = "cpaas-registry.cpaas-system" ]; then
        if ! REGISTRY=$(kubectl get registry.platform.alauda.io cpaas-registry -n cpaas-system -o jsonpath='{.spec.endpoints[0]}'); then
            echo "Failed to read the registry endpoint. Do not continue with an empty address or cpaas-registry.cpaas-system." >&2
            exit 1
        fi
        if [ -z "$REGISTRY" ]; then
            echo "Failed to resolve a real registry endpoint. Do not continue with an empty address or cpaas-registry.cpaas-system." >&2
            exit 1
        fi
    elif [ "$(kubectl get productbase -o jsonpath='{.items[].spec.registry.preferPlatformURL}')" != 'false' ]; then
        REGISTRY=$(kubectl get cm -n kube-public global-info -o jsonpath='{.data.platformURL}' | awk -F \// '{print $NF}')
    fi
    if [ -z "$REGISTRY" ]; then
        echo "Failed to resolve a registry address. Do not continue with an empty address." >&2
        exit 1
    fi
    echo "Image registry address is: $REGISTRY"

在镜像模式下,cpaas-registry.cpaas-system 是全局节点使用的逻辑名称。该命令读取第一个仓库端点,并输出 host[:port]。导入的节点会从该地址拉取镜像。即使平台 URL 优先,系统也会解析此逻辑名称。如果命令退出时发生错误,请停止操作。不要使用空地址或逻辑名称继续操作。如果集群已导入,请将输出的地址与 Sentry Pod 的镜像地址进行比较;如果两者不同,请使用 Pod 镜像地址。

  • 要使用外部镜像仓库,请手动设置 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 证书外,不支持获取集群证书相关信息。