/ /

複数のKubernetesクラスターでの配置

Docs Home

/ /

Enterprise Kubernetes 演算子

複数のKubernetesクラスターでの配置

Docs Home

管理

Kubernetes 演算子（非推奨）

Enterprise Kubernetes 演算子

複数のKubernetesクラスターでの配置

マルチ Kubernetes クラスターでのレプリカセットの配置

MongoDB Enterprise Kubernetes演算子は非推奨です。新しい MongoDB Controls for Kubernetes Operator が、 MongoDB Enterprise Kubernetes Operator に置き換わります。Kubernetes Operator 用のドライバーの最初のバージョンは、 Enterprise Kubernetes Operatorの v1.33 と機能的に同等です。この変更の詳細と、新しい演算子への移行に関するガイダンスについては、最初の新しいバージョンのリリースノートを参照してください。MongoDB Enterprise Kubernetes Operator の今後のリリースは予定されません。各バージョンは、既存の 1 年間のサポートポリシーに従ってサポートが終了します。継続的なサポートについては、 Kubernetes Operator 用のコントロールに移行してください。

この手順を使用して、マルチ Kubernetes クラスター MongoDB 配置のノード Kubernetes クラスターに新しいレプリカセットを作成します。

この手順により、ステートメントセット構成のオーバーライドなど、レプリカセットリソースのさまざまな設定を設定できます。この手順を使用する代わりに、マルチKubernetes-クラスタークイックスタートを使用できます。これにより、デフォルト設定でマルチ Kubernetes クラスター MongoDB 配置が作成されます。

始める前に:

マルチ Kubernetes クラスター配置について説明します。
マルチ Kubernetes クラスターのサービスとツールのリストを確認します。
Kubernetes 演算子をマルチ Kubernetes クラスター MongoDB 配置にインストールします。「マルチ Kubernetes クラスタークイックスタート」を参照してください。
前提条件を完了します。

リソースの配置`MongoDBMultiCluster`

この TLS-Encrypted Connectionsタブでは、次の手順を使用できます。

MongoDBMultiClusterリソースを配置
MongoDBMultiClusterリソースの TLS 証明書を更新する

これらの手順により、レプリカセット内の MongoDB ホスト間、およびクライアントアプリケーションと MongoDB 配置間で TLS暗号化接続を確立します。

開始する前に、 TLS暗号化の有効な証明書が必要です。

リソースの配置`MongoDBMultiCluster`

リソースの TLS`MongoDBMultiCluster` 証明書のシークレットを作成します。

kubectlコマンドを実行して、 MongoDBMultiClusterリソース証明書を保存する新しいシークレットを作成します。

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
  --namespace=<metadata.namespace> \
  create secret tls <prefix>-<metadata.name>-cert \
  --cert=<resource-tls-cert> \
  --key=<resource-tls-key>

注意

シークレットの前に<prefix>-<metadata.name>を付ける必要があります。

たとえば、配置をmy-deployment mdbと呼び出し、プレフィックスをに設定する場合は、クライアント TLS 通信の TLS シークレットにmdb-my-deployment-cert という名前を付ける必要があります。また、内部クラスター認証用のTLSシークレット（有効になっている場合） mdb-my-deployment-clusterfileに名前を付ける必要があります。

ConfigMap を作成して、CA を`MongoDBMultiCluster` リソースにリンクします。

kubectlコマンドを実行して、 CAをMongoDBMultiClusterリソースにリンクします。 MongoDBMultiClusterリソースに対して常にca-pemという名前を付ける必要があるCA証明書ファイルを指定します。

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
  --namespace=<metadata.namespace> \
  create configmap custom-ca -from-file=ca-pem=<your-custom-ca-file>

演算子クラスターの名前空間を使用するように `kubectl` を構成します。

まだ実行していない場合は、次のコマンドを実行して、デフォルトの名前空間内の演算子クラスターですべての kubectl コマンドを実行します。

kubectl config use-context $MDB_CENTRAL_CLUSTER_FULL_NAME
kubectl config set-context $(kubectl config current-context) \
  --namespace=mongodb

サンプルリソースをコピーして貼り付けます。

サンプルレプリカセットのYAMLファイルをコピーし、新しいテキストファイルに貼り付けます。
必要なレプリカセット構成に合わせてファイルの設定を変更します。

1 # This example provides statefulSet overrides per cluster.
2 
3 apiVersion: mongodb.com/v1
4 kind: MongoDBMultiCluster
5 metadata:
6   name: multi-replica-set
7 spec:
8   version: 6.0.0-ent
9   type: ReplicaSet
10   duplicateServiceObjects: false
11   credentials: my-credentials
12   opsManager:
13     configMapRef:
14       name: my-project
15   clusterSpecList:
16     - clusterName: cluster1.example.com
17       members: 2
18       statefulSet:
19         spec:
20           template:
21             spec:
22               containers:
23                 # Example of custom sidecar containers. Remove it before using the file in production.
24                 - name: sidecar1
25                   image: busybox
26                   command: [ "sleep" ]
27                   args: [ "infinity" ]
28           # Use the following settings to override the default storage size of the "data" Persistent Volume.
29           volumeClaimTemplates:
30             - metadata:
31                 name: data
32               spec:
33                 resources:
34                   requests:
35                     storage: 1Gi
36     - clusterName: cluster2.example.com
37       members: 1
38       statefulSet:
39         spec:
40           template:
41             spec:
42               containers:
43                 # Example of custom sidecar containers. Remove it before using the file in production.
44                 - name: sidecar2
45                   image: busybox
46                   command: [ "sleep" ]
47                   args: [ "infinity" ]
48           volumeClaimTemplates:
49             - metadata:
50                 name: data
51               spec:
52                 resources:
53                   requests:
54                     storage: 1Gi
55     - clusterName: cluster3.example.com
56       members: 1
57       statefulSet:
58         spec:
59           template:
60             spec:
61               containers:
62                 # Example of custom sidecar containers. Remove it before using the file in production.
63                 - name: sidecar3
64                   image: busybox
65                   command: [ "sleep" ]
66                   args: [ "infinity" ]
67           volumeClaimTemplates:
68             - metadata:
69                 name: data
70               spec:
71                 resources:
72                   requests:
73                     storage: 1Gi
74 
75 ...

設定を希望する値に変更します。

キー	タイプ	説明	例
`metadata.name`	string	`MongoDBMultiCluster`リソースのラベル。リソース名は 44 文字以下にする必要があります。 `metadata.name`Kubernetesドキュメントで、「と名前」も参照してください。	`multi-replica-set`
`spec.version`	string	この`MongoDBMultiCluster`リソースが実行する MongoDB のバージョン。形式は、 MongoDB Community Editionでは `X.Y.Z`、Enterprise エディションでは `X.Y.Z-ent` です。重要:互換性のあるMongoDB Serverバージョンを選択していることを確認してください。互換性のあるバージョンは、 MongoDBデータベースリソースが使用する基本イメージによって異なります。 MongoDB のバージョン管理の詳細については、MongoDB マニュアルの「 MongoDBのバージョン管理」を参照してください。	`6.0.0-ent`
`spec` `.opsManager` `.configMapRef` `.name`	string	MongoDB Ops Manager接続構成を含む ConfigMap の名前。`spec.cloudManager.configMapRef.name` 設定はこの設定のエイリアスであり、代わりに使用できます。この値は、作成するリソースと同じ名前空間に存在する必要があります。重要: Kubernetes Operator は ConfigMap への変更を追跡し、`MongoDB` リソースの状態を調整します。	`<my-project>`
`spec` `.clusterSpecList` `.clusterName`	string	`MongoDBMultiCluster`リソース内のクラスターの名前。	`cluster1.example.com`
`spec` `.clusterSpecList` `.members`	integer	このクラスター内のメンバーの数。	`2`
`spec` `.clusterSpecList` `.statefulSet` `.spec`	コレクション	任意。マルチ Kubernetes クラスターMongoDBデプロイ内のクラスターの各ステートメントに対して、StatusSet オーバーライドの構成を提供します。`clusterSpecList` の下で個々のクラスターレベルで指定すると、複数の Kubernetes クラスターMongoDBデプロイのステートメントを使用するグローバル構成が上書きされます。「マルチKubernetes-クラスターリソース仕様」と「 StateftSet v1 アプリKubernetesドキュメント」を参照してください。	例を参照してください。
`spec` `.clusterSpecList` `.statefulSet` `.spec` `.volumeClaimTemplates` `.spec`	コレクション	任意。指定すると、データを保存する永続ボリュームの VolumeClaimtemplates のデフォルトのストレージサイズのクラスターごとの上書きを提供します。	例を参照してください。
`spec.credentials`	string	Operator がと通信するための MongoDB Ops ManagerAPI認証情報として作成KubernetesMongoDB Ops Manager したシークレットの名前。認証情報を保持するMongoDB Ops Manager Kubernetes Secretオブジェクトは、作成するリソースと同じ名前空間に存在する必要があります。重要: Kubernetes Operator は、シークレットへの変更を追跡し、`MongoDB` リソースの状態を調整します。	`<mycredentials>`
`spec.type`	string	作成する`MongoDB`リソースのタイプ。このフィールドでサポートされている値は`ReplicaSet`のみです。「制限」を参照してください。	`ReplicaSet`

`MongoDBMultiCluster`リソース配置に追加で許容される設定を追加します。

また、オブジェクト仕様に任意の設定を追加することもできます。「マルチ Kubernetes クラスターリソース仕様」を参照してください。

このレプリカセット構成ファイルを`.yaml` 拡張子で保存します。

レプリカセットの配置を開始します。

任意のディレクトリで、次の Kubernetes コマンドを呼び出してレプリカセットを作成します。

kubectl apply -f <replica-set-conf>.yaml

マルチ Kubernetes クラスター MongoDB 配置のステータスを追跡します。

MongoDBMultiClusterリソースのステータスを確認するには、演算子クラスターで次のコマンドを使用します。

kubectl get mdbmc <resource-name> -o yaml -w

-w （監視）フラグが設定されている場合、構成が変更されると、ステータスフェーズがRunning状態に達するまで出力が直ちに更新されます。リソース配置ステータスの詳細については、「 Kubernetes 演算子のトラブルシューティング」を参照してください。

リソースの TLS`MongoDBMultiCluster` 証明書を更新する

次の手順で、 TLS証明書を定期的に更新します。

`MongoDBMultiCluster`リソースのシークレットを更新します。

次のkubectl コマンドを実行して、MongoDBMultiCluster リソースの証明書を保存する既存のシークレットを更新します。

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
--namespace=<metadata.namespace> \
create secret tls <prefix>-<metadata.name>-cert \
--cert=<resource-tls-cert> \
--key=<resource-tls-key> \
--dry-run=client \
-o yaml |
kubectl apply -f -

この手順では、レプリカセット内の MongoDB ホスト間、およびクライアント・アプリケーションと MongoDB 配置間の接続は暗号化されません。

リソースの配置`MongoDBMultiCluster`

演算子クラスターの名前空間を使用するように `kubectl` を構成します。

まだ実行していない場合は、次のコマンドを実行して、デフォルトの名前空間内の演算子クラスターですべての kubectl コマンドを実行します。

kubectl config use-context $MDB_CENTRAL_CLUSTER_FULL_NAME
kubectl config set-context $(kubectl config current-context) \
  --namespace=mongodb

サンプルリソースをコピーして貼り付けます。

サンプルレプリカセットのYAMLファイルをコピーし、新しいテキストファイルに貼り付けます。
必要なレプリカセット構成に合わせてファイルの設定を変更します。

1 # This example provides statefulSet overrides per cluster.
2 
3 apiVersion: mongodb.com/v1
4 kind: MongoDBMultiCluster
5 metadata:
6   name: multi-replica-set
7 spec:
8   version: 6.0.0-ent
9   type: ReplicaSet
10   duplicateServiceObjects: false
11   credentials: my-credentials
12   opsManager:
13     configMapRef:
14       name: my-project
15   clusterSpecList:
16     - clusterName: cluster1.example.com
17       members: 2
18       statefulSet:
19         spec:
20           template:
21             spec:
22               containers:
23                 # Example of custom sidecar containers. Remove it before using the file in production.
24                 - name: sidecar1
25                   image: busybox
26                   command: [ "sleep" ]
27                   args: [ "infinity" ]
28           # Use the following settings to override the default storage size of the "data" Persistent Volume.
29           volumeClaimTemplates:
30             - metadata:
31                 name: data
32               spec:
33                 resources:
34                   requests:
35                     storage: 1Gi
36     - clusterName: cluster2.example.com
37       members: 1
38       statefulSet:
39         spec:
40           template:
41             spec:
42               containers:
43                 # Example of custom sidecar containers. Remove it before using the file in production.
44                 - name: sidecar2
45                   image: busybox
46                   command: [ "sleep" ]
47                   args: [ "infinity" ]
48           volumeClaimTemplates:
49             - metadata:
50                 name: data
51               spec:
52                 resources:
53                   requests:
54                     storage: 1Gi
55     - clusterName: cluster3.example.com
56       members: 1
57       statefulSet:
58         spec:
59           template:
60             spec:
61               containers:
62                 # Example of custom sidecar containers. Remove it before using the file in production.
63                 - name: sidecar3
64                   image: busybox
65                   command: [ "sleep" ]
66                   args: [ "infinity" ]
67           volumeClaimTemplates:
68             - metadata:
69                 name: data
70               spec:
71                 resources:
72                   requests:
73                     storage: 1Gi
74 
75 ...

設定を希望する値に変更します。

キー	タイプ	説明	例
`metadata.name`	string	`MongoDBMultiCluster`リソースのラベル。リソース名は 44 文字以下にする必要があります。 `metadata.name`Kubernetesドキュメントで、「と名前」も参照してください。	`multi-replica-set`
`spec.version`	string	この`MongoDBMultiCluster`リソースが実行する MongoDB のバージョン。形式は、 MongoDB Community Editionでは `X.Y.Z`、Enterprise エディションでは `X.Y.Z-ent` です。重要:互換性のあるMongoDB Serverバージョンを選択していることを確認してください。互換性のあるバージョンは、 MongoDBデータベースリソースが使用する基本イメージによって異なります。 MongoDB のバージョン管理の詳細については、MongoDB マニュアルの「 MongoDBのバージョン管理」を参照してください。	`6.0.0-ent`
`spec` `.opsManager` `.configMapRef` `.name`	string	MongoDB Ops Manager接続構成を含む ConfigMap の名前。`spec.cloudManager.configMapRef.name` 設定はこの設定のエイリアスであり、代わりに使用できます。この値は、作成するリソースと同じ名前空間に存在する必要があります。重要: Kubernetes Operator は ConfigMap への変更を追跡し、`MongoDB` リソースの状態を調整します。	`<my-project>`
`spec` `.clusterSpecList` `.clusterName`	string	`MongoDBMultiCluster`リソース内のクラスターの名前。	`cluster1.example.com`
`spec` `.clusterSpecList` `.members`	integer	このクラスター内のメンバーの数。	`2`
`spec` `.clusterSpecList` `.statefulSet` `.spec`	コレクション	任意。マルチ Kubernetes クラスターMongoDBデプロイ内のクラスターの各ステートメントに対して、StatusSet オーバーライドの構成を提供します。`clusterSpecList` の下で個々のクラスターレベルで指定すると、複数の Kubernetes クラスターMongoDBデプロイのステートメントを使用するグローバル構成が上書きされます。「マルチKubernetes-クラスターリソース仕様」と「 StateftSet v1 アプリKubernetesドキュメント」を参照してください。	例を参照してください。
`spec` `.clusterSpecList` `.statefulSet` `.spec` `.volumeClaimTemplates` `.spec`	コレクション	任意。指定すると、データを保存する永続ボリュームの VolumeClaimtemplates のデフォルトのストレージサイズのクラスターごとの上書きを提供します。	例を参照してください。
`spec.credentials`	string	Operator がと通信するための MongoDB Ops ManagerAPI認証情報として作成KubernetesMongoDB Ops Manager したシークレットの名前。認証情報を保持するMongoDB Ops Manager Kubernetes Secretオブジェクトは、作成するリソースと同じ名前空間に存在する必要があります。重要: Kubernetes Operator は、シークレットへの変更を追跡し、`MongoDB` リソースの状態を調整します。	`<mycredentials>`
`spec.type`	string	作成する`MongoDB`リソースのタイプ。このフィールドでサポートされている値は`ReplicaSet`のみです。「制限」を参照してください。	`ReplicaSet`

`MongoDBMultiCluster`リソース配置に追加で許容される設定を追加します。

また、オブジェクト仕様に任意の設定を追加することもできます。「マルチ Kubernetes クラスターリソース仕様」を参照してください。

このレプリカセット構成ファイルを`.yaml` 拡張子で保存します。

レプリカセットの配置を開始します。

任意のディレクトリで、次の Kubernetes コマンドを呼び出してレプリカセットを作成します。

kubectl apply -f <replica-set-conf>.yaml

マルチ Kubernetes クラスター MongoDB 配置のステータスを追跡します。

MongoDBMultiClusterリソースのステータスを確認するには、演算子クラスターで次のコマンドを使用します。

kubectl get mdbmc <resource-name> -o yaml -w

戻る

クイックスタート

サービスメトリクスなしの配置

1	# This example provides statefulSet overrides per cluster.
2
3	apiVersion: mongodb.com/v1
4	kind: MongoDBMultiCluster
5	metadata:
6	name: multi-replica-set
7	spec:
8	version: 6.0.0-ent
9	type: ReplicaSet
10	duplicateServiceObjects: false
11	credentials: my-credentials
12	opsManager:
13	configMapRef:
14	name: my-project
15	clusterSpecList:
16	- clusterName: cluster1.example.com
17	members: 2
18	statefulSet:
19	spec:
20	template:
21	spec:
22	containers:
23	# Example of custom sidecar containers. Remove it before using the file in production.
24	- name: sidecar1
25	image: busybox
26	command: [ "sleep" ]
27	args: [ "infinity" ]
28	# Use the following settings to override the default storage size of the "data" Persistent Volume.
29	volumeClaimTemplates:
30	- metadata:
31	name: data
32	spec:
33	resources:
34	requests:
35	storage: 1Gi
36	- clusterName: cluster2.example.com
37	members: 1
38	statefulSet:
39	spec:
40	template:
41	spec:
42	containers:
43	# Example of custom sidecar containers. Remove it before using the file in production.
44	- name: sidecar2
45	image: busybox
46	command: [ "sleep" ]
47	args: [ "infinity" ]
48	volumeClaimTemplates:
49	- metadata:
50	name: data
51	spec:
52	resources:
53	requests:
54	storage: 1Gi
55	- clusterName: cluster3.example.com
56	members: 1
57	statefulSet:
58	spec:
59	template:
60	spec:
61	containers:
62	# Example of custom sidecar containers. Remove it before using the file in production.
63	- name: sidecar3
64	image: busybox
65	command: [ "sleep" ]
66	args: [ "infinity" ]
67	volumeClaimTemplates:
68	- metadata:
69	name: data
70	spec:
71	resources:
72	requests:
73	storage: 1Gi
74
75	...

リソースの配置MongoDBMultiCluster

リソースの TLSMongoDBMultiCluster 証明書のシークレットを作成します。

注意

ConfigMap を作成して、CA をMongoDBMultiCluster リソースにリンクします。

演算子クラスターの名前空間を使用するように kubectl を構成します。

サンプル リソースをコピーして貼り付けます。

設定を希望する値に変更します。

MongoDBMultiClusterリソース配置に追加で許容される設定を追加します。

このレプリカセット構成ファイルを.yaml 拡張子で保存します。

レプリカセットの配置を開始します。

マルチ Kubernetes クラスター MongoDB 配置のステータスを追跡します。

リソースの TLSMongoDBMultiCluster 証明書を更新する

MongoDBMultiClusterリソースのシークレットを更新します。

リソースの配置MongoDBMultiCluster

演算子クラスターの名前空間を使用するように kubectl を構成します。

サンプル リソースをコピーして貼り付けます。

設定を希望する値に変更します。

MongoDBMultiClusterリソース配置に追加で許容される設定を追加します。

このレプリカセット構成ファイルを.yaml 拡張子で保存します。

レプリカセットの配置を開始します。

マルチ Kubernetes クラスター MongoDB 配置のステータスを追跡します。

リソースの配置`MongoDBMultiCluster`

リソースの TLS`MongoDBMultiCluster` 証明書のシークレットを作成します。

ConfigMap を作成して、CA を`MongoDBMultiCluster` リソースにリンクします。

演算子クラスターの名前空間を使用するように `kubectl` を構成します。

サンプルリソースをコピーして貼り付けます。

`MongoDBMultiCluster`リソース配置に追加で許容される設定を追加します。

このレプリカセット構成ファイルを`.yaml` 拡張子で保存します。

リソースの TLS`MongoDBMultiCluster` 証明書を更新する

`MongoDBMultiCluster`リソースのシークレットを更新します。

リソースの配置`MongoDBMultiCluster`

演算子クラスターの名前空間を使用するように `kubectl` を構成します。

サンプルリソースをコピーして貼り付けます。

`MongoDBMultiCluster`リソース配置に追加で許容される設定を追加します。

このレプリカセット構成ファイルを`.yaml` 拡張子で保存します。