群集链接是群集和另一群集之间的单向关系。

您可以使用 DC/OS CLI dcos cluster link 和 dcos cluster unlink 命令以及 cluster link API. 来添加和移除从一个群集到另一个群集的链接。设置链接后，您可以使用 CLI 或 UI 在群集之间轻松切换。如果已经使用 SSO 提供程序设置链接，您不需要提供凭证即可切换群集。

您必须以超级用户身份登录或具有相应的群集链接权限以查看、添加和删除链接以及授予权限以查看链接的群集。

启用使用 SSO 访问群集链接

作为超级用户：

配置 OpenID IDP.
1. 确保在 Google Dev 控制台中的 授权 JavaScript 源 和 授权重定向 URL 字段中均提供两个群集 URL。
2. 提供 OIDC 名称，如“google-idp”。
3. 配置 OIDC 时，确保两个群集使用相同的 Client-Id 和 Client-Secret
为每个用户提供查看服务和链接群集的权限：
1. 选择 组织 -> 用户。
2. 选择用户。
3. 单击 添加权限。
4. 在右上方，单击 插入权限字符串。
5. 粘贴权限：
```
dcos:adminrouter:ops:mesos full
dcos:adminrouter:ops:slave full
dcos:adminrouter:service:marathon full
dcos:service:marathon:marathon:services:/ full
dcos:cluster:linker:* read
```
6. 单击 添加权限。

添加群集链接

要添加指向另一个群集的链接，运行 dcos cluster link 命令，提供群集的 URL 以链接至：

dcos cluster link <dcos-url>
Choose the login method and provider to enable switching to this linked cluster::
1) Provider 1
2) Provider 2
(1-2):

查看链接的群集

要查看所有链接的群集，运行 dcos cluster list 命令。如果群集已链接，但未设置，其状态为 UNCONFIGURED. 如果群集已链接和附加，其状态为 AVAILABLE. 另请参阅查看连接的群集.

删除群集的链接

要删除链接，运行dcos cluster unlink 命令并提供已链接群集的名称或 ID。例如：

dcos cluster unlink <linked-cluster>

切换群集

您可以使用 CLI 或 UI 在链接的群集之间切换。使用 CLI 切换群集时，新群集将成为 CLI 的活动群集。使用 UI 切换群集时，新群集将成为您在 UI 中看到的群集。如果在 CLI 中切换群集，它不会更改 UI 中的群集；同样，在 UI 中切换，不会影响 CLI 中附加的群集。

从 DC/OS CLI 切换到链接的群集

运行 dcos cluster attach 命令并提供链接群集的名称或 ID：

dcos cluster attach <linked-cluster>

要运行 dcos cluster list，<linked-cluster> 的名称旁就会有一个星号。

从 DC/OS UI 切换到链接的群集

从左侧导航菜单，选择 群集 > 链接的群集。

图 1 - 链接的群集链接
在 DC/OS UI 的右上角，单击群集名称右侧的向下箭头。

图 2 - 打开群集菜单
选择 切换群集。

图 3 - 切换群集
单击要切换到的群集名称。

图 4 - 切换到链接的群集

作为超级用户切换群集

如果您以超级用户身份登录，则也可以在“链接的群集”选项卡中直接切换到链接的群集。

选择 群集 -> 链接的群集。
在最右边，点击垂直省略号，然后选择切换。

图 5 - 切换到链接的群集

链接和切换群集示例

以超级用户操作员通过 CLI 链接群集

使用 cluster-a 提供程序设置群集 dcos-user
```
dcos cluster setup --provider=dcos-users https://cluster-a.us-west-2.elb.amazonaws.com
```
响应请求您验证群集证书捆绑包中的指纹，其必须通过响应接受。yes. CLI 提示提供超级用户凭证。提供凭证。
使用 cluster-b 提供程序设置 dcos-user
```
dcos cluster setup --provider=dcos-users https://cluster-b.us-west-2.elb.amazonaws.com
```
响应请求您验证群集证书捆绑包中的指纹，其必须通过响应接受。yes. CLI 提示提供超级用户凭证。提供凭证。

附加到群集 cluster-a 并列示。

dcos cluster attach cluster-a
dcos cluster list
      NAME                    CLUSTER ID                 STATUS   VERSION                                         URL
 cluster-b  34ddd64a-9301-40b1-bb6a-201ec55a0d80  AVAILABLE  1.12-dev   https://cluster-b.us-west-2.elb.amazonaws.com
cluster-a*  584d3e8f-c5c2-4c86-b180-ff3c1f15b0d5  AVAILABLE  1.12-dev  https://cluster-a.us-west-2.elb.amazonaws.com

从群集 cluster-b 链接到群集 cluster-a.

dcos cluster link https://cluster-b.us-west-2.elb.amazonaws.com

CLI 提示您选择用于切换的登录提供程序。

Choose the login method and provider to enable switching to this linked cluster:
1) Log in using a standard DC/OS user account (username and password)
2) Log in using OpenID Connect (Google IDP)
(1-2):

选择 Google IDP (2)。如果群集链接成功，则无响应。
```
(1-2): 2
```
附加到群集 cluster-b.
```
$ dcos cluster attach cluster-b
```

从群集 cluster-a 链接到群集 cluster-b.

dcos cluster link https://cluster-a.us-west-2.elb.amazonaws.com

CLI 提示选择用于切换的登录提供程序。

Choose the login method and provider to enable switching to this linked cluster:
1) Log in using a standard DC/OS user account (username and password)
2) Log in using OpenID Connect (Google IDP)
(1-2):

选择 Google IDP (2)。
```
(1-2): 2
```

列出群集。

dcos cluster list
      NAME                    CLUSTER ID                 STATUS   VERSION                                         URL
cluster-b*  34ddd64a-9301-40b1-bb6a-201ec55a0d80  AVAILABLE  1.12-dev   https://cluster-b.us-west-2.elb.amazonaws.com
 cluster-a  584d3e8f-c5c2-4c86-b180-ff3c1f15b0d5  AVAILABLE  1.12-dev  https://cluster-a.us-west-2.elb.amazonaws.com

操作员设置链接后，您可使用 UI 或 CLI 在群集之间切换。

使用 UI 和 Google SSO 切换群集

您可以使用 Google OpenID 提供程序轻松切换到已设置的链接群集。

作为外部用户，使用 Google 凭证登录群集的 DC/OS UI cluster-a

图 6 - Google 登录
在 DC/OS UI 的右上角，单击群集名称右侧的向下箭头。

图 7 - 切换群集
单击 切换群集。

使用 CLI 和 Google SSO 切换群集