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

項目一覧

MongoDBMultiClusterリソースの配置

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

この手順により、ステートメントセット構成のオーバーライドなど、レプリカセットリソースのさまざまな設定を設定できます。この手順を使用する代わりに、 Multi-Kubernetes-Cluster クイックスタートを使用して、デフォルト設定で複数の 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 文字以下にする必要があります。 Kubernetesドキュメントで、「 `metadata.name`との名前も参照してください。	`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	ConfigMap MongoDB Ops Managerの名前接続構成の場合`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`	コレクション	任意。ステートフルセットの構成を提供します MongoDB のマルチ Kubernetes クラスター配置で、クラスターの各StatusSets に対しての上書きを適用します。`clusterSpecList`の下で個々のクラスターレベルで指定されると、複数の Kubernetes クラスター MongoDB 配置全体の Atlas App Services のグローバル構成が上書きされます。「マルチKubernetes-クラスターリソース仕様」と「 StatefunctionSet v1 アプリ Kubernetes ドキュメント」を参照してください。	例を参照してください。
`spec` `.clusterSpecList` `.statefulSet` `.spec` `.volumeClaimTemplates` `.spec`	コレクション	任意。指定すると、 VolumeClaim テンプレートのデフォルトのストレージサイズのクラスターごとの上書きが行われます。、データを保存する永続ボリュームの場合	例を参照してください。
`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	ConfigMap MongoDB Ops Managerの名前接続構成の場合`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`	コレクション	任意。ステートフルセットの構成を提供します MongoDB のマルチ Kubernetes クラスター配置で、クラスターの各StatusSets に対しての上書きを適用します。`clusterSpecList`の下で個々のクラスターレベルで指定されると、複数の Kubernetes クラスター MongoDB 配置全体の Atlas App Services のグローバル構成が上書きされます。「マルチKubernetes-クラスターリソース仕様」と「 StatefunctionSet v1 アプリ Kubernetes ドキュメント」を参照してください。	例を参照してください。
`spec` `.clusterSpecList` `.statefulSet` `.spec` `.volumeClaimTemplates` `.spec`	コレクション	任意。指定すると、 VolumeClaim テンプレートのデフォルトのストレージサイズのクラスターごとの上書きが行われます。、データを保存する永続ボリュームの場合	例を参照してください。
`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

戻る

クイックスタート

サービスメッシュのないマルチ Kubernetes クラスターでのレプリカセットの配置

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` 拡張子で保存します。