直接连接
如果 Host 集群(简称 H 集群)的任何节点都能访问 Member 集群(简称 M 集群)的 kube-apiserver 地址,您可以采用直接连接。当 M 集群的 kube-apiserver 地址可以暴露给外网,或者 H 集群和 M 集群在同一私有网络或子网中时,此方法均适用。
要通过直接连接使用多集群功能,您必须拥有至少两个集群,分别用作 H 集群和 M 集群。您可以在安装 KubeSphere 之前或者之后将一个集群指定为 H 集群或 M 集群。有关安装 KubeSphere 的更多信息,请参考在 Linux 上安装和在 Kubernetes 上安装。
准备 Host 集群
Host 集群为您提供中央控制平面,并且您只能指定一个 Host 集群。
如果已经安装了独立的 KubeSphere 集群,您可以编辑集群配置,将 clusterRole
的值设置为 host
。
-
选项 A - 使用 Web 控制台:
使用
admin
帐户登录控制台,然后进入集群管理页面上的自定义资源 CRD,输入关键字ClusterConfiguration
,然后转到其详情页面。编辑ks-installer
的 YAML 文件,方法类似于启用可插拔组件。 -
选项 B - 使用 Kubectl:
kubectl edit cc ks-installer -n kubesphere-system
在 ks-installer
的 YAML 文件中,搜寻到 multicluster
,将 clusterRole
的值设置为 host
,然后点击更新(如果使用 Web 控制台)使其生效:
multicluster:
clusterRole: host
您需要稍等片刻待该更改生效。
在 Linux 上或者在现有 Kubernetes 集群上安装 KubeSphere 之前,您可以定义一个 Host 集群。如果您想在 Linux 上安装 KubeSphere,需要使用 config-sample.yaml
文件。如果您想在现有 Kubernetes 集群上安装 KubeSphere,需要使用两个 YAML 文件,其中一个是 cluster-configuration.yaml
。要设置一个 Host 集群,请在安装 KubeSphere 之前,将 config-sample.yaml
或 cluster-configuration.yaml
文件中对应的 clusterRole
的值修改为 host
。
multicluster:
clusterRole: host
备注
config-sample.yaml
文件。这种情况下,您可以在安装 KubeSphere 之后设置 Host 集群。您可以使用 kubectl 来获取安装日志以验证状态。运行以下命令,稍等片刻,如果 Host 集群已准备就绪,您将看到成功的日志返回。
kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
准备 Member 集群
为了通过 Host 集群管理 Member 集群,您需要使它们之间的 jwtSecret
相同。因此,您首先需要在 Host 集群中执行以下命令来获取它。
kubectl -n kubesphere-system get cm kubesphere-config -o yaml | grep -v "apiVersion" | grep jwtSecret
命令输出结果可能如下所示:
jwtSecret: "gfIwilcc0WjNGKJ5DLeksf2JKfcLgTZU"
如果已经安装了独立的 KubeSphere 集群,您可以编辑集群配置,将 clusterRole
的值设置为 member
。
-
选项 A - 使用 Web 控制台:
使用
admin
帐户登录控制台,然后进入集群管理页面上的自定义资源 CRD,输入关键字ClusterConfiguration
,然后转到其详情页面。编辑ks-installer
的 YAML 文件,方法类似于启用可插拔组件。 -
选项 B - 使用 Kubectl:
kubectl edit cc ks-installer -n kubesphere-system
在 ks-installer
的 YAML 文件中对应输入上面所示的 jwtSecret
:
authentication:
jwtSecret: gfIwilcc0WjNGKJ5DLeksf2JKfcLgTZU
向下滚动并将 clusterRole
的值设置为 member
,然后点击更新(如果使用 Web 控制台)使其生效:
multicluster:
clusterRole: member
您需要稍等片刻待该更改生效。
在 Linux 上或者在现有 Kubernetes 集群上安装 KubeSphere 之前,您可以定义 Member 集群。如果您想在 Linux 上安装 KubeSphere,需要使用 config-sample.yaml
文件。如果您想在现有 Kubernetes 集群上安装 KubeSphere,需要使用两个 YAML 文件,其中一个是 cluster-configuration.yaml
。要设置 Member 集群,请在安装 KubeSphere 之前,在 config-sample.yaml
或 cluster-configuration.yaml
文件中输入上方 jwtSecret
所对应的值,并将 clusterRole
的值修改为 member
。
authentication:
jwtSecret: gfIwilcc0WjNGKJ5DLeksf2JKfcLgTZU
multicluster:
clusterRole: member
备注
config-sample.yaml
文件。这种情况下,您可以在安装 KubeSphere 之后设置 Member 集群。您可以使用 kubectl 来获取安装日志以验证状态。运行以下命令,稍等片刻,如果 Member 集群已准备就绪,您将看到成功的日志返回。
kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f
导入 Member 集群
-
以
admin
身份登录 KubeSphere 控制台,转到集群管理页面点击添加集群。 -
在导入集群页面,输入要导入的集群的基本信息。您也可以点击右上角的编辑模式以 YAML 格式查看并编辑基本信息。编辑完成后,点击下一步。
-
在连接方式,选择直接连接 Kubernetes 集群,复制 Member 集群的 KubeConfig 内容并粘贴至文本框。您也可以点击右上角的编辑模式以 YAML 格式编辑 Member 集群的 KubeConfig。
备注
请确保 Host 集群的任何节点都能访问 KubeConfig 中的server
地址。 -
点击创建,然后等待集群初始化完成。
反馈
这篇文章对您有帮助吗?
感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。