代理连接

    要通过代理连接使用多集群功能,您必须拥有至少两个集群,分别用作主集群和成员集群。您可以在安装 KubeSphere 之前或者之后将一个集群指定为主集群或成员集群。有关安装 KubeSphere 的更多信息,请参考在 Linux 上安装和。

    主集群为您提供中央控制平面,并且您只能指定一个主集群。

    如果已经安装了独立的 KubeSphere 集群,您可以编辑集群配置,将 的值设置为 host

    • 选项 A - 使用 Web 控制台:

      使用 admin 帐户登录控制台,然后进入集群管理页面上的 CRD,输入关键字 ClusterConfiguration,然后转到其详情页面。编辑 ks-installer 的 YAML 文件,方法类似于启用可插拔组件

    • 选项 B - 使用 Kubectl:

    ks-installer 的 YAML 文件中,搜寻到 multicluster,将 clusterRole 的值设置为 host,然后点击确定(如果使用 Web 控制台)使其生效:

    1. multicluster:
    2. clusterRole: host

    要设置主集群名称,请在 ks-installer 的 YAML 文件中的 multicluster.clusterRole 下添加 hostClusterName 字段:

    1. multicluster:
    2. clusterRole: host
    3. hostClusterName: <主集群名称>

    备注

    • 建议您在准备主集群的同时设置主集群名称。若您的主集群已在运行并且已经部署过资源,不建议您再去设置主集群名称。
    • 主集群名称只能包含小写字母、数字、连字符(-)或者半角句号(.),必须以小写字母或数字开头和结尾。

    您需要稍等片刻待该更改生效。

    在 Linux 上或者在现有 Kubernetes 集群上安装 KubeSphere 之前,您可以定义一个主集群。如果您想,需要使用 config-sample.yaml 文件。如果您想在现有 Kubernetes 集群上安装 KubeSphere,需要使用两个 YAML 文件,其中一个是 cluster-configuration.yaml

    要设置一个主集群,请在安装 KubeSphere 之前,将 config-sample.yamlcluster-configuration.yaml 文件中对应的 clusterRole 的值修改为 host

    1. multicluster:
    2. clusterRole: host

    要设置主集群名称,请在 config-sample.yamlcluster-configuration.yaml 文件中的 multicluster.clusterRole 下添加 hostClusterName 字段:

    1. multicluster:

    备注

    • 主集群名称只能包含小写字母、数字、连字符(-)或者半角句号(.),必须以小写字母或数字开头和结尾。

    信息

    您可以使用 kubectl 来获取安装日志以验证状态。运行以下命令,稍等片刻,如果主集群已准备就绪,您将看到成功的日志返回。

    1. kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f

    安装主集群后,将在 kubesphere-system 中创建一个名为 tower 的代理服务,其类型为 LoadBalancer

    如果集群中有可用的 LoadBalancer 插件,则可以看到 Tower 服务有相应的 EXTERNAL-IP 地址,该地址将由 KubeSphere 自动获取并配置代理服务地址,这意味着您可以跳过设置代理服务地址这一步。执行以下命令确认是否有 LoadBalancer 插件。

    1. kubectl -n kubesphere-system get svc

    命令输出结果可能如下所示:

    备注

    一般来说,主流公有云厂商会提供 LoadBalancer 解决方案,并且负载均衡器可以自动分配外部 IP。如果您的集群运行在本地环境中,尤其是在裸机环境中,可以使用 作为负载均衡器解决方案。

    1. 如果在 Tower 服务下没有显示相应的地址(EXTERNAL-IP 处于 pending 状态),则需要手动设置代理地址。例如,您有一个可用的公有 IP 地址 139.198.120.120,并且此 IP 地址的端口 8080 被转发到集群的端口 30721。执行以下命令来检查服务。

      1. kubectl -n kubesphere-system get svc

      命令输出结果可能如下所示:

      1. NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
      2. tower LoadBalancer 10.233.63.191 <pending> 8080:30721/TCP 16h
    2. proxyPublishAddress 的值添加到 ks-installer 的配置文件中,并按如下所示输入公有 IP 地址(此处示例 139.198.120.120)和端口号。

      • 选项 A - 使用 Web 控制台:

        使用 admin 帐户登录控制台,然后进入集群管理页面上的 CRD,输入关键字 ClusterConfiguration,然后转到其详情页面。编辑 ks-installer 的 YAML 文件,方法类似于启用可插拔组件

      • 选项 B - 使用 Kubectl:

        1. kubectl -n kubesphere-system edit clusterconfiguration ks-installer

      搜寻到 multicluster 并添加新行输入 proxyPublishAddress 来定义 IP 地址,以便访问 Tower。

      1. multicluster:
      2. clusterRole: host
      3. proxyPublishAddress: http://139.198.120.120:8080 # Add this line to set the address to access tower
    3. 保存配置并稍等片刻,或者您可以运行以下命令手动重启 ks-apiserver 使修改立即生效。

      为了通过主集群管理成员集群,您需要使它们之间的 jwtSecret 相同。因此,您首先需要在主集群中执行以下命令来获取它。

      如果已经安装了独立的 KubeSphere 集群,您可以编辑集群配置,将 clusterRole 的值设置为 member

      • 选项 A - 使用 Web 控制台:

        使用 admin 帐户登录控制台,然后进入集群管理页面上的 CRD,输入关键字 ClusterConfiguration,然后转到其详情页面。编辑 ks-installer 的 YAML 文件,方法类似于。

      • 选项 B - 使用 Kubectl:

        1. kubectl edit cc ks-installer -n kubesphere-system

      ks-installer 的 YAML 文件中对应输入上面所示的 jwtSecret

      1. authentication:
      2. jwtSecret: gfIwilcc0WjNGKJ5DLeksf2JKfcLgTZU

      向下滚动并将 clusterRole 的值设置为 member,然后点击确定(如果使用 Web 控制台)使其生效:

      1. multicluster:
      2. clusterRole: member

      您需要稍等片刻待该更改生效。

      在 Linux 上或者在现有 Kubernetes 集群上安装 KubeSphere 之前,您可以定义成员集群。如果您想在 Linux 上安装 KubeSphere,需要使用 config-sample.yaml 文件。如果您想,需要使用两个 YAML 文件,其中一个是 cluster-configuration.yaml。要设置成员集群,请在安装 KubeSphere 之前,在 config-sample.yamlcluster-configuration.yaml 文件中输入上方 jwtSecret 所对应的值,并将 clusterRole 的值修改为 member

      1. authentication:
      2. jwtSecret: gfIwilcc0WjNGKJ5DLeksf2JKfcLgTZU
      1. multicluster:
      2. clusterRole: member

      备注

      如果您在单节点集群上安装 KubeSphere (All-in-One),则不需要创建 config-sample.yaml 文件。这种情况下,您可以在安装 KubeSphere 之后设置成员集群。

      您可以使用 kubectl 来获取安装日志以验证状态。运行以下命令,稍等片刻,如果成员集群已准备就绪,您将看到成功的日志返回。

      1. kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
      1. admin 身份登录 KubeSphere 控制台,转到集群管理页面点击添加集群

      2. 导入集群页面输入要导入的集群的基本信息。您也可以点击右上角的编辑模式以 YAML 格式查看并编辑基本信息。编辑完成后,点击下一步

      3. 连接方式,选择集群连接代理,然后点击创建。主集群为代理部署 (Deployment) 生成的 YAML 配置文件会显示在控制台上。