简化地多集群安装[实验性]

本指南描述了如何使用一种简化的实验性方式来配置一个跨多个 Kubernetes 集群的 Istio 网格。 我们希望在将来的版本中继续开发这项功能，因此非常期待您对这个流程进行反馈。

在此我们集中讨论如何连接多集群网格的细节，有关其它背景信息，请参考多集群部署模型。 我们将展示如何将同一网络上的两个集群与另一个网络上的第三个集群连接起来。

使用本指南中展示的方法会导致 Istio 控制平面的实例部署在网格中的每个集群中。 尽管这是一种常见配置，但其他更复杂的拓扑也是可能的，只是需要使用一些手动的过程来完成，此处不再赘述。

开始之前

此处我们描述的过程主要针对相对干净的未部署过 Istio 的集群。 我们在将来能将支持扩展到现有集群。

为了便于说明，本指南假定您已经创建了三个 Kubernetes 集群：

• 一个在 network-east 网络上的名为 cluster-east-1 的集群。
• 一个在 network-east 网络上的名为 cluster-east-2 的集群。
• 一个在 network-west 网络上的名为 cluster-west-1 的集群。

这些集群应当尚未安装 Istio。前两个集群在同一个网络，并可直连，而第三个集群在另一个网络。 请查看平台设置说明，以了解针对您的特定环境的任何特殊说明。

初步准备

您需要执行一些一次性步骤才能设置多集群网格：

1. 确保您的所有集群都被包含在您的 Kubernetes 配置文件中，并为它们创建了上下文配置。完成后，您的配置文件应该包含类似如下内容：

   kind: Config
   apiVersion: v1
   clusters:
   - cluster:
     name: cluster-east-1
   - cluster:
     name: cluster-east-2
   - cluster:
     name: cluster-west-1
   contexts:
   - context:
       cluster: cluster-east-1
     name: context-east-1
   - context:
       cluster: cluster-east-2
     name: context-east-2
   - context:
       cluster: cluster-west-1
     name: context-west-1
   

2. 决定您的多集群网格的名字。推荐使用一些短小好记的：

   $ export MESH_ID=mymeshname
   

3. 决定组织名以用于创建用来让集群互相通信的根证书和中间证书。这通常可以从您的组织的 DNS 名中得来：

   $ export ORG_NAME=mymeshname.mycompanyname.com
   

4. 创建一个工作目录，用于存储在集群启动过程中产生的若干文件：

   $ export WORKDIR=mydir
   $ mkdir -p ${WORKDIR}
   $ cd ${WORKDIR}
   

5. 下载设置脚本 到您的工作目录。 该脚本负责创建必要的证书以启用跨集群通信，它为您准备了默认配置文件，并将在每个集群中部署和配置 Istio。

6. 最后，运行下载的脚本以准备网格。这会创建一个将用于保护网格中群集之间的通信安全的根密钥和证书，以及用于控制所有群集上部署的 Istio 的配置的 base.yaml 文件：

   $ ./setup-mesh.sh prep-mesh
   

   请注意此步骤不会对集群产生任何影响，它只是在您的工作目录里创建了若干文件。

定制 Istio

上面的网格准备工作在您的工作目录里创建了一个名为 base.yaml 的文件。 这个文件定义了基本的 IstioControlPlane 配置，它用于将 Istio 部署到您的集群中（下面就会提到）。 您可以定制 base.yaml 文件，以精确控制 Istio 将被如何部署到所有的集群中。

只有这些值不应该被修改：

values.gateway.istio-ingressgateway.env.ISTIO_MESH_NETWORK
values.global.controlPlaneSecurityEnabled
values.global.multiCluster.clusterName
values.global.network
values.global.meshNetworks
values.pilot.meshNetworks=

这些值是通过以下步骤自动设置的，任何手动设置都会导致数据丢失。

创建网格

通过编辑在您的工作目录中的 topology.yaml 文件来指定哪些集群将被包含在网格中。 为这三个集群都添加一个条目，使文件如下所示：

mesh_id: mymeshname
contexts:
  context-east-1:
    network: network-east
  context-east-2:
    network: network-east
  context-west-1:
    network: network-west

该拓扑文件保存了网格的名字，以及网络的上下文映射。当文件保存后，您就可以开始创建网格了。 这将部署 Istio 到每个集群，并配置每个势力以互相安全通信：

$ ./setup-mesh.sh apply

想要往网格中添加或删除集群，只需要对应地更新该拓扑文件并重新应用这些更改。

清理

您可以使用以下命令从所有的已知集群中删除 Istio：

$ ./setup-mesh.sh teardown