先决条件

查看支持的硬件架构

请参阅支持的硬件架构。

克隆 MongoDB Enterprise Kubernetes Operator 存储库

克隆 MongoDB Enterprise Kubernetes Operator 存储库：

git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git

设置环境变量

使用部署集群的集群名称设置环境变量，如下例所示：

export MDB_CENTRAL_CLUSTER_FULL_NAME="mdb-central"
export MDB_CLUSTER_1_FULL_NAME="mdb-1"
export MDB_CLUSTER_2_FULL_NAME="mdb-2"
export MDB_CLUSTER_3_FULL_NAME="mdb-3"

安装 Go 和 Helm

安装以下工具：

1. 安装 Go v1 。17 或更高版本。

2. 安装 Helm 。

了解 Kubernetes 角色和角色绑定

要使用多 Kubernetes 集群 MongoDB 部署，您必须拥有一组特定的 Kubernetes 角色、ClusterRoles 、 RoleBindings、ClusterRoleBindings 和 ServiceAccounts ，您可以通过以下任一方式进行配置：

• 按照多 Kubernetes 集群快速入门 进行操作，其中介绍了如何使用MongoDB 插件自动创建所需的对象，并将它们应用到多 Kubernetes 集群 MongoDB 部署中的相应集群。

• 使用 Helm 为每个成员集群配置所需的 Kubernetes 角色和服务帐户：

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_1_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_2_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_3_FULL_NAME \
    --namespace mongodb

• 手动创建 Kubernetes 对象 .yaml文件，并使用kubectl apply命令将所需的 Kubernetes 角色和服务帐户添加到多 Kubernetes 集群 MongoDB 部署中。这对于某些高度自动化的工作流程可能是必要的。 MongoDB 提供了示例配置文件。

  对于作用域为命名空间子集的自定义资源：

  • 中央集群的角色、角色绑定和服务帐户

  • 成员集群的角色、角色绑定和服务帐户

  对于范围为集群范围命名空间的自定义资源：

  • 中央集群的 ClusterRole、ClusterRoleBindings 和 ServiceAccounts

  • 成员集群的 ClusterRole、ClusterRoleBindings 和 ServiceAccounts

  每个文件定义多个资源。 为了支持您的部署，您必须替换以下字段中的占位符值：

  • subjects.namespace 在每个RoleBinding或ClusterRoleBinding资源中

  • metadata.namespace 在每个ServiceAccount资源中

  修改定义后，对每个文件运行以下命令来应用这些定义：

  kubectl apply -f <fileName>

设置部署范围

默认情况下，多集群 Kubernetes Operator 的作用域为以下 命名空间 在其中安装它。 Kubernetes Operator 协调与MongoDBMultiCluster Kubernetes Operator 部署在同一命名空间中的 资源。

当您在 多集群快速 入门中运行 MongoDB kubectl 插件 ，并且不修改kubectl mongodb 插件设置时，该插件：

• 创建一个名为mongodb-enterprise-operator-member-list的默认 ConfigMap，其中包含多 Kubernetes 集群 MongoDB 部署的所有成员集群。此名称是硬编码的，无法更改。请参阅已知问题。

• 创建 ServiceAccounts 、 角色、ClusterRoles 、 RoleBindings 和 ClusterRoleBindings 在中央集群和每个成员集群中。

• 为服务帐户应用正确的权限。

• 使用前面的设置创建多 Kubernetes 集群 MongoDB 部署。

一旦 Kubernetes Operator 创建了多 Kubernetes 集群 MongoDB 部署，Kubernetes Operator 就会开始监视MongoDB mongodb命名空间 中的 资源 。

要为 Kubernetes 操作符配置正确的权限以在子集或所有命名空间中进行部署，请运行以下命令并指定您希望 Kubernetes 操作符监视的命名空间。

kubectl mongodb multicluster setup \
  --central-cluster="${MDB_CENTRAL_CLUSTER_FULL_NAME}" \
  --member-clusters="${MDB_CLUSTER_1_FULL_NAME},${MDB_CLUSTER_2_FULL_NAME},${MDB_CLUSTER_3_FULL_NAME}" \
  --member-cluster-namespace="mongodb2" \
  --central-cluster-namespace="mongodb2" \
  --create-service-account-secrets \
  --cluster-scoped="true"

将多 Kubernetes 集群 MongoDB 部署安装到多个或所有 命名空间 时 ，您可以将 Kubernetes Operator 配置为：

• 监视多个命名空间中的资源

• 监视所有命名空间中的资源

WATCH_NAMESPACE: "$namespace1,$namespace2,$namespace3"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="$namespace1,$namespace2,$namespace3"

WATCH_NAMESPACE: "*"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="*"

规划外部连接：是否应该使用服务网格？

服务网格可实现不同 Kubernetes 集群中部署的副本集成员之间的集群间通信。使用服务网格可大幅简化创建多 Kubernetes 集群 MongoDB 部署的过程，是跨多个 Kubernetes 集群部署 MongoDB 的推荐方法。但是，如果您的 IT 组织不使用服务网格，您可以在没有服务网格的多 Kubernetes 集群 MongoDB 部署中部署副本集。

根据您的环境，执行以下操作：

• 如果可以使用服务网格，请安装 Istio。

• 如果无法使用服务网格：

  1. 查看Kubernetes Operator 如何建立连接？

  2. 通过外部域和 DNS 区域启用外部连接。

  3. 在没有服务网格的情况下部署多 Kubernetes 集群。

检查集群间的连接

按照此过程中的步骤验证是否可跨 Kubernetes 集群访问服务FQDN 。

在此示例中，您将部署 sample-service.yaml 中定义的示例应用程序 跨两个 Kubernetes 集群。

kubectl create --context="${CTX_CLUSTER_1}" namespace sample
kubectl create --context="${CTX_CLUSTER_2}" namespace sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l service=helloworld1 \
   -n sample
kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l service=helloworld2 \
   -n sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l version=v1 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_1}" \
   -n sample \
   -l app=helloworld

kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l version=v2 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_2}" \
   -n sample \
   -l app=helloworld

kubectl run  --context="${CTX_CLUSTER_1}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld2.sample:5000/hello

Hello version: v2, instance: helloworld-v2-758dd55874-6x4t8

kubectl run --context="${CTX_CLUSTER_2}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld1.sample:5000/hello

Hello version: v1, instance: helloworld-v1-758dd55874-6x4t8

查看部署 Ops Manager 的要求

作为快速入门的一部分，您将在中央集群上部署 Ops Manager 资源。

准备 TLS 加密连接

如果计划使用MongoDB TLS 加密来保护多 Kubernetes 集群 部署，请完成以下任务以启用内部集群身份验证，并为成员集群和 助手生成 TLS MongoDB Agent证书：

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
--namespace=<metadata.namespace> \

curl https://raw.githubusercontent.com/mon  mongodb-enterprise-kubernetes/master/tools/multicluster/setup_tl  -o  setup_tls.sh

选择 GitOps 或 kubectl MongoDB 插件

您可以选择创建和维护在 GitOps 环境中部署MongoDBMultiCluster资源所需的资源文件。

如果使用 GitOps 工作流程，则无法使用 kubectl mongodb 插件 ，该插件会自动配置 基于角色的访问控制 (RBAC) 并创建 kubeconfig 文件，允许中央集群与其成员集群通信。相反，您必须根据 为kubeconfig GitOps 配置资源中 的过程和示例，手动配置或构建自己的自动化配置 RBAC 和 文件。

以下先决条件部分描述了如何在不使用 GitOps的情况下安装 kubectl MongoDB 插件，或者在使用 GitOps的情况下为 GitOps 配置资源。

安装 kubectl MongoDB 插件

使用kubectl mongodb插件可以：

• 设置多 Kubernetes 集群部署

• 运行自动和手动灾难恢复

要安装kubectl mongodb插件：

tar -zxvf kubectl-mongodb_<version>_darwin_amd64.tar.gz

mv kubectl-mongodb /usr/local/bin/kubectl-mongodb

kubectl mongodb multicluster setup
kubectl mongodb multicluster recover

为 GitOps 配置资源

如果使用 GitOps 工作流程，则无法使用 kubectl mongodb 插件 自动配置 基于角色的访问控制 (RBAC) 或允许中央集群与其成员集群通信的 kubeconfig 文件。相反，您必须手动配置和应用以下资源文件，或根据以下信息构建自己的自动化。

要为 GitOps 配置 RBAC 和kubeconfig ：

apiVersion: v1
kind: ConfigMap
data:
  cluster1: ""
  cluster2: ""
metadata:
  namespace: <namespace>
  name: mongodb-enterprise-operator-member-list
  labels:
    multi-cluster: "true"