前提条件

サポートされているハードウェア アーキテクチャの確認

サポートされているハードウェア アーキテクチャを参照してください。

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 1v.17 以降をインストールします。

2. Helm をインストールします。

Kubernetes のロールとロール バインディングの理解

マルチ Kubernetes クラスターMongoDBデプロイを使用するには、 Kubernetesロール、 ClusterRoles 、RoleBindings、 ClusterRoleBindings 、および ServiceAccount の特定のセットが必要です。これらは、次のいずれかの方法で構成できます。

• 「 マルチKubernetes-クラスター クイック スタート 」では、 を使用して必要なオブジェクトを自動的に作成し、それをマルチ KubernetesMongoDB クラスター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 クラスターの MongoDB 配置に必要な Kubernetes ロールとサービス アカウントを追加します。 これは、特定の高度に自動化されたワークフローで必要になる場合があります。 MongoDB はサンプル構成ファイルを提供します。

  名前空間のサブセットにスコープが設定されたカスタム リソースの場合:

  • 中央クラスターのロール、ロール バインディング、サービス アカウント

  • ノードクラスターのロール、ロールバインディング、サービスアカウント

  クラスター全体の名前空間にスコープが設定されたカスタム リソースの場合:

  • 中央クラスターの ClusterRoles、ClusterRoleBindings、ServiceAccounts

  • ノードクラスターの ClusterRoles、ClusterRoleBindings、ServiceAccounts

  各ファイルは複数のリソースを定義します。 配置をサポートするには、次のフィールドのプレースホルダー値を置き換える必要があります。

  • subjects.namespace 各RoleBindingまたはClusterRoleBindingリソース

  • metadata.namespace 各ServiceAccountリソース

  定義を変更したら、各ファイルに対して次のコマンドを実行してそれらを適用します。

  kubectl apply -f <fileName>

配置のスコープを設定する

デフォルトでは 、マルチクラスターKubernetes Operator は、それがインストールされている名前空間にスコープが設定されています。 Kubernetes Operator は、MongoDBMultiCluster Kubernetes Operator と同じ名前空間に配置された リソースを調整します。

マルチクラスター クイック スタート の一部として MongoDB kubernetes プラグイン を実行し、kubectl mongodb プラグイン設定を変更しない場合、プラグインは次のようになります。

• MongoDB のマルチ配置のすべてのノードクラスターを含む、 mongodb-enterprise-operator-member-listという名前のデフォルトの ConfigMap を作成します。 この名前はハードコードされており、変更することはできません。 「既知の問題点 」を参照してください。

• 中央クラスターと各ノード クラスターで、 ServiceAccounts 、Roles、ClusterRoles 、RoleBindings、ClusterRoleBindings を作成します。

• サービス アカウントに適切な権限を適用します。

• 前述の設定を使用して、マルチ Kubernetes クラスター MongoDB 配置を作成します。

Kubernetes Operator が マルチ Kubernetes クラスターMongoDBデプロイを作成すると、 Kubernetes OperatorMongoDB はmongodb 名前空間内の リソースの監視を開始します。

サブセットまたはすべての名前空間に配置するための正しい権限で Kubernetes Operator を構成するには、次のコマンドを実行し、Kubernetes Operator が監視する名前空間を指定します。

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演算子を次のように構成できます。

• 複数の名前空間でリソースを監視する

• すべての名前空間でリソースを監視する

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 配置の作成が大幅に簡素化され、MongoDB を複数の Kubernetes クラスターに配置する推奨方法になります。 ただし、IT 組織でサービス メトリクスを使用していない場合は、Kubernetes クラスターの MongoDB 配置にレプリカセットを使用せずに配置できます。

環境に応じて、次の操作を行います。

• サービス メトリクスを使用できる場合は、 Istio をインストールします。

• サービス メトリクスを使用できない場合

  1. 「 Kubernetes Operator はどのように接続を確立しますか 」セクションを確認します。

  2. 外部ドメインと DNS ゾーンを介して外部接続を有効にします。

  3. サービス メトリクスなしで マルチ Kubernetes クラスターをデプロイします。

クラスター間の接続を確認

この手順の手順に従って、Kubernetes クラスター全体でサービスFQDNにアクセスできることを確認します。

この例では 、 sample-service.YAML で定義されたサンプルアプリケーションを 2 つの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

MongoDB Ops Managerの配置要件の確認

クイック スタートの一部として、中央クラスターにMongoDB Ops Managerリソースを配置します。

TLS 暗号化接続の準備をする

TLS暗号化を使用して複数の Kubernetes クラスター MongoDB 配置を保護する場合は、次のタスクを実行して内部クラスター認証を有効にし、ノードクラスターと MongoDB Agent のTLS証明書を生成します。

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

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

GitOps または kubernetes MongoDB プラグインを選択する

GitOps 環境でMongoDBMultiClusterリソースの配置に必要なリソース ファイルを作成して維持することを選択できます。

GitOps ワークフローを使用する場合、 kubernetl mongodbプラグイン は使用できません。このプラグインは、ロールベースのアクセス制御（RBAC）を自動的に構成し、中央クラスターがそのノード クラスターと通信できるようにする kubeconfigファイルを作成します。代わりに、 GitOps のリソース構成 の手順と例に基づいて、RBAC とkubeconfig ファイルを構成するための独自のオートメーションを手動で構成またはビルドする必要があります。

次の前提条件セクションでは、GitOps を使用しない場合は kubernetl MongoDB プラグインをインストールする方法、または GitOps を使用する場合は GitOps 用のリソースを構成する方法について説明します。

kubernetes 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 ワークフローを使用する場合は、 kubernetl 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"