先决条件

查看支持的硬件架构

请参阅支持的硬件架构。

克隆 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 协调与Kubernetes Operator 部署在同一命名空间中的MongoDBMultiCluster资源。

当您在 多集群快速 入门中运行 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 的要求

作为快速入门的一部分，您将在中央集群上部署MongoDB 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 工作流程，则无法使用 kubectlMongoDB 插件 ，该插件会自动配置 基于角色的访问权限控制 (RBAC) 并创建 kubeconfig 文件，允许中央集群与其成员集群通信。相反，您必须根据为 GitOps 配置资源中的过程和示例，手动配置或构建自己的自动化配置 RBAC 和kubeconfig文件。

以下先决条件部分描述了如何在不使用 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 工作流程，则无法使用 kubectlMongoDB 插件 自动配置 基于角色的访问权限控制 (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"

kubectl config --kubeconfig=kubeconfig set-cluster kind-e2e-cluster-1 --certificate-authority=<cluster-1-ca.crt>
kubectl config --kubeconfig=kubeconfig set-cluster kind-e2e-cluster-2 --certificate-authority=<cluster-2-ca.crt>
kubectl config --kubeconfig=kubeconfig set-credentials kind-e2e-cluster-1 --token=<cluster-1-token>
kubectl config --kubeconfig=kubeconfig set-credentials kind-e2e-cluster-2 --token=<cluster-2-token>