クラスター構成ファイル
Overview
mongocli
コマンドには、 MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するためのクラスター構成設定が必要です。 構成プロパティは、 .yaml
または.json
ファイルを介して提供できます。 以下のセクションでは、クラスターの作成または更新に必要な構成プロパティと、コピーして変更できるサンプル構成ファイルについて説明します。
構成プロパティ
次のセクションには、次のものが含まれます。
クラスター全体の構成プロパティ
レプリカセット ノード構成プロパティ
シャーディングされたクラスター構成プロパティ
クラスター全体の設定
MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、次のクラスター全体の設定が含まれている必要があります。
フィールド | タイプ | 説明 |
---|---|---|
name | string | クラスターの名前。 |
version | string | 配置する mongod プロセスのバージョン。 |
featureCompatibilityVersion | string | 配置の機能の互換性バージョン。 |
processes | オブジェクトの配列 | |
shards | オブジェクトの配列 | シャーディングされたクラスターに必要です。 各シャードの 設定を含むオブジェクトの配列。 |
config | オブジェクト | シャーディングされたクラスターに必要です。 コンフィギュレーションサーバーのレプリカセットを含むオブジェクト。 |
mongos | オブジェクトの配列 | シャーディングされたクラスターに必要です。 各 mongos インスタンスの 設定を含むオブジェクトの配列。 |
レプリカセット ノードの設定
MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、各レプリカセット ノードに対して次の設定を含めることができます。
フィールド | タイプ | 説明 | 必須 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
auditLogDestination | string | を設定すると監査が有効になり、すべての監査イベントが送信される場所を指定します。 MongoDB CLI は、次の値を受け入れます。
この設定は、 auditLog.d destination構成ファイル オプションに対応します。 | no | ||||||||||
auditLogFilter | string | どのイベントが監査されるかをフィルター処理する設定。 フィルターは、指定したクエリに一致するように結果を制限します。 フィルターの作成の詳細については、「監査フィルターの構成 」を参照してください。 この設定は、 auditLog.filter構成ファイル オプションに対応します。 | no | ||||||||||
auditLogFormat | string |
MongoDB CLI は、次の値を受け入れます。
この設定は、 auditLog.format構成ファイル オプションに対応します。 | no | ||||||||||
auditLogPath | string |
この設定は、 auditLog.path構成ファイル オプションに対応します。 | no | ||||||||||
bindIp | string |
この設定は、 net.bindIp構成ファイル オプションに対応します。 | no | ||||||||||
bindIpAll | ブール値 |
この設定は、 net.bindIpAll構成ファイル オプションに対応します。 | no | ||||||||||
buildIndexes | ブール値 | インデックスをビルドするよう この設定は、 buildIndexesレプリカセット 構成オプションに対応します。 | no | ||||||||||
dbPath | string | mongod インスタンスがデータを保存するディレクトリ。 これは配置後に変更することはできません。 | はい | ||||||||||
delay | 整数 | このノードがプライマリ ノードより遅れる秒数。 この設定は、 slaveDelayレプリカセット 構成オプションに対応します。 | no | ||||||||||
directoryPerDB | ブール値 | MongoDB が各データベースのデータを保存するために個別のディレクトリを使用するかどうかを示すフラグ。 ディレクトリは デフォルトでは、 この設定は、 | no | ||||||||||
enableMajorityReadConcern | ブール値 | 読み取り保証 (read concern デフォルトでは、 この設定は、 replication.enableMajorityReadConcern レプリカセット構成オプションの値に応じてエラーを発生させるか、nil を返します。 | no | ||||||||||
hostname | string | レプリカセットに追加するホストの名前。 これは、 Ops Manager がmongod プロセスを配置するホストです。 | はい | ||||||||||
inMemory.engineConfig.
inMemorySizeGB | float | インメモリ ストレージエンジンデータ(インデックス、 値の範囲は MongoDB Enterprise でのみ使用できます。 この設定は、 | no | ||||||||||
ipv6 | ブール値 | 配置が IPv6をサポートしているかどうかを示すフラグ。 MongoDB CLI は、 この設定は、 net.IPv 6構成ファイル オプションに対応します。 | no | ||||||||||
logDestination | string | MongoDB がすべてのログ出力を送信する宛先。 MongoDB CLI は、
この設定は、 systemLog.d destination構成ファイル オプションに対応します。 | no | ||||||||||
logPath | string | ホスト上の mongod プロセスのログファイルの場所と名前。 | はい | ||||||||||
oplogSizeMB | integer | レプリケーションoplogの最大サイズ(メガバイト単位)。 この設定は、 replication.oplogSizeMBレプリカセット 構成オプションに対応します。 | no | ||||||||||
port | integer | レプリカセット ノードのポート。 mongod プロセスは、指定されたポートへの排他的アクセス権を持つ必要があります。 | はい | ||||||||||
priority | integer | 選挙中のレプリカセット ノードの優先順位。 値は次のとおりです。
投票権のないノードの優先順位は | はい | ||||||||||
tls.CAFile | string |
この設定は、 net.tls.CAFile | no | ||||||||||
tls.
certificateKeyFile | string |
この設定は、 net.tls.CertificateKeyFile | no | ||||||||||
tls.
certificateKeyFilePassword | string | 証明書キー ファイルの復号化パスワード。 証明書鍵ファイルが暗号化されている場合にのみ、 この設定は、 net.tls.CertificateKeyFilePassword | no | ||||||||||
tls.certificateSelector | string | MongoDB Agent がオペレーティング システムの証明書ストアから、TLS/SSL に使用するのに合わせて証明書を選択するために使用する証明書のプロパティ。 MongoDB CLI は、次のキーと値のマッピングのいずれかを
この設定は、 net.tls.CertificateSelector | no | ||||||||||
tls.
clusterCertificateSelector | string | MongoDB Agent がオペレーティング システムの証明書ストアから内部 x に使用するのに一致する証明書を選択するために使用する証明書プロパティ。 509メンバーシップ認証。 MongoDB CLI は、次のキーと値のマッピングのいずれかを
この設定は、 net.tls.clusterCertificateSelectorに対応します。 | no | ||||||||||
tls.clusterFile | string |
この設定は、 net.tls.clusterFile | no | ||||||||||
tls.clusterPassword | string |
証明書鍵ファイルが暗号化されている場合にのみ、 この設定は、 net.tls.clusterPassword | no | ||||||||||
tls.CRLFile | string | 証明書失効リストを含む この設定は、 net.tls.CRLFile | no | ||||||||||
tls.disabledProtocols | string | TLS で実行されている MongoDB サーバーが着信接続を拒否するプロトコルまたはバージョン。 この設定は、 net.tls.disabledProtocols | no | ||||||||||
tls.FIPSMode | string |
この設定は、 net.tls.FIPSMode | no | ||||||||||
tls.mode | string | すべてのネットワーク接続に対して TLS を有効にします。 MongoDB CLI は、この設定に対して次の引数を受け入れます。
この設定は、 net.tls.mode | no | ||||||||||
tls.PEMKeyFile | string |
重要:この設定は非推奨です。 代わりに この設定は、 net.ssl.PEMKeyFile | no | ||||||||||
votes | integer | レプリカセットが選挙で投票するかどうかを示す数値。 MongoDB CLI は、次の値を受け入れます。
| はい | ||||||||||
wiredTiger.engineConfig.
cacheSizeGB | float | WiredTiger がすべてのデータに使用する内部キャッシュの最大サイズ。 値の範囲は
WiredTiger 内部キャッシュ サイズがデフォルト値より大きくならないようにしてください。 この設定は、 | no | ||||||||||
wiredTiger.engineConfig.
journalCompressor | string | no | |||||||||||
wiredTiger.engineConfig.
directoryForIndexes | ブール値 |
シンボリック リンクを使用すると、インデックスに別の場所を指定できます。 具体的には、 デフォルトでは、 この設定は、 | no | ||||||||||
wiredTiger.engineConfig.
maxCacheOverflowFileSizeGB | float | この設定は、MongoDB バージョン を実行しているクラスターでのみサポートされています。
設定では、次の値を受け入れることができます。
実行時に最大サイズを変更するには、 この設定は、 | no | ||||||||||
wiredTiger.collectionConfig.
blockCompressor | string | コレクション データのデフォルトの圧縮。 これは、コレクションを作成する際、コレクションごとに上書きできます。 利用可能なコンプレッサーは次のとおりです。 デフォルトでは、コンプレッサーはsnappy です。 この設定は、新しく作成されたすべてのコレクションに影響します。 既存の MongoDB デプロイでこの設定の値を変更すると、新しいコレクションのすべてで指定されたコンプレッサーが使用されます。 既存のコレクションは、作成時に指定されたコンプレッサー、またはその時点でのデフォルトのコンプレッサーを引き続き使用します。 この設定は、 | no | ||||||||||
wiredTiger.indexConfig.
prefixCompression | ブール値 | インデックスデータの接頭辞圧縮を有効にするか無効にするかを示すフラグ。
デフォルトでは、 この設定は作成されたすべてのインデックスに影響します。 既存の MongoDB の配置でこの設定の値を変更すると、すべての新しいインデックスで接頭辞圧縮が使用されます。 既存のインデックスは影響を受けません。 この設定は、 | no |
シャード設定
MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、各シャードに対して次の設定を含めることができます。
フィールド | タイプ | 説明 | 必須 |
---|---|---|---|
name | string | シャードの の名前。 | はい |
processes | オブジェクトの配列 | はい |
サンプル構成ファイル
name: "myCluster" version: 4.2.2 featureCompatibilityVersion: 4.2 processes: - hostname: host0 dbPath: /data/cluster_2/rs1 logPath: /data/cluster_2/rs1/mongodb.log priority: 1 votes: 1 port: 29010 - hostname: host1 dbPath: /data/cluster_2/rs2 logPath: /data/cluster_2/rs2/mongodb.log priority: 1 votes: 1 port: 29020 - hostname: host2 dbPath: /data/cluster_2/rs3 logPath: /data/cluster_2/rs3/mongodb.log priority: 1 votes: 1 port: 29030
{ "name": "myCluster", "version": "4.2.2", "featureCompatibilityVersion": "4.2", "processes": [ { "hostname": "host0", "dbPath": "/data/cluster_3/rs1", "logPath": "/data/cluster_3/rs1/mongodb.log", "priority": 1, "votes": 1, "port": 30010 }, { "hostname": "host1", "dbPath": "/data/cluster_3/rs2", "logPath": "/data/cluster_3/rs2/mongodb.log", "priority": 1, "votes": 1, "port": 30020 }, { "hostname": "host2", "dbPath": "/data/cluster_3/rs3", "logPath": "/data/cluster_3/rs3/mongodb.log", "priority": 1, "votes": 1, "port": 30030 } ] }
{ "name": "myShardedCluster", "version": "4.2.2", "featureCompatibilityVersion": "4.2", "shards": [ { "name": "myShard_0", "processes": [ { "dbPath": "/data/myCluster/myShard_0/27000", "hostname": "host0.example", "logPath": "/data/myCluster/myShard_0/27000/mongodb.log", "port": 27000, "votes": 1 }, { "dbPath": "/data/myCluster/myShard_0/27001", "hostname": "host1.example", "logPath": "/data/myCluster/myShard_0/27001/mongodb.log", "port": 27001, "votes": 1 }, { "dbPath": "/data/myCluster/myShard_0/27002", "hostname": "host2.example", "logPath": "/data/myCluster/myShard_0/27002/mongodb.log", "port": 27002, "version": "4.2.8-ent", "votes": 1 } ] }, { "name": "myShard_1", "processes": [ { "dbPath": "/data/myCluster/myShard_1/28000", "hostname": "host3.example", "logPath": "/data/myCluster/myShard_1/28000/mongodb.log", "port": 28000, "votes": 1 }, { "dbPath": "/data/myCluster/myShard_1/28001", "hostname": "host4.example", "logPath": "/data/myCluster/myShard_1/28001/mongodb.log", "port": 28001, "votes": 1 }, { "dbPath": "/data/myCluster/myShard_1/28002", "hostname": "host5.example", "logPath": "/data/myCluster/myShard_1/28002/mongodb.log", "port": 28002, "votes": 1 } ] } ], "config": { "name": "configRS", "processes": [ { "dbPath": "/data/myCluster/configRS/29000", "hostname": "host6.example", "logPath": "/data/myCluster/configRS/29000/mongodb.log", "port": 29000, "votes": 1 }, { "dbPath": "/data/myCluster/configRS/29001", "hostname": "host7.example", "logPath": "/data/myCluster/configRS/29001/mongodb.log", "port": 29001, "votes": 1 }, { "dbPath": "/data/myCluster/configRS/29002", "hostname": "host8.example", "logPath": "/data/myCluster/configRS/29002/mongodb.log", "port": 29002, "votes": 1 } ] }, "mongos": [ { "hostname": "host9.example", "logPath": "/data/myCluster/mongoses/27015/mongodb.log", "port": 27015 } ] }