/ /

クラスター構成ファイル

Overview

mongocliコマンドには、MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するためのクラスター構成設定が必要です。構成プロパティは、.yaml または.json ファイルを介して提供できます。以下のセクションでは、クラスターの作成または更新に必要な構成プロパティと、コピーして変更できるサンプル構成ファイルについて説明します。

構成プロパティ

次のセクションには、次のものが含まれます。

クラスター全体の構成プロパティ
レプリカセットノード構成プロパティ
シャーディングされたクラスター構成プロパティ

クラスター全体の設定

MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、次のクラスター全体の設定が含まれている必要があります。

フィールド	タイプ	説明
`name`	string	クラスターの名前。
`version`	string	`mongod`配置するプロセスのバージョン。
`featureCompatibilityVersion`	string	配置の機能の互換性バージョン。
`processes`	オブジェクトの配列	レプリカセットに必須です。各`mongod` プロセスの設定を含むオブジェクトの配列。各`mongod` にはレプリカセットメンバー設定があります。
`shards`	オブジェクトの配列	シャーディングされたクラスターに必要です。各シャードの設定を含むオブジェクトの配列。
`config`	オブジェクト	シャーディングされたクラスターに必要です。コンフィギュレーションサーバーのレプリカセットを含むオブジェクト。
`mongos`	オブジェクトの配列	シャーディングされたクラスターに必要です。各インスタンスの`mongos` 設定を含むオブジェクトの配列。

レプリカセットノードの設定

MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、各レプリカセットノードに対して次の設定を含めることができます。

フィールド	タイプ	説明	必須
`auditLogDestination`	string	を設定すると監査が有効になり、すべての監査イベントが送信される場所を指定します。 MongoDB CLI は、次の値を受け入れます。 `syslog` 監査イベントを JSON 形式で `syslog` に出力します。 `console` 監査イベントを JSON 形式で `stdout` に出力します。 `file` 監査イベントを、 `auditLogFormat`設定で指定された形式で、 `auditLogPath`設定で指定されたファイルに出力します。この設定は、 auditLog.d destination構成ファイルオプションに対応します。	no
`auditLogFilter`	string	どのイベントが監査されるかをフィルター処理する設定。フィルターは、指定したクエリに一致するように結果を制限します。フィルターの作成の詳細については、「監査フィルターの構成」を参照してください。この設定は、 auditLog.filter構成ファイルオプションに対応します。	no
`auditLogFormat`	string	がに設定されている場合の監査`auditLogDestination` `file`用出力ファイルの形式です。 MongoDB CLI は、次の値を受け入れます。 `JSON` 監査イベントを JSON 形式で、 `auditLogPath`設定で指定されたファイルに出力します。 `BSON` 監査イベントを BSON バイナリ形式で、 `auditLogPath`設定で指定されたファイルに出力します。この設定は、 auditLog.format構成ファイルオプションに対応します。	no
`auditLogPath`	string	`auditLogDestination`の値が`file` の場合の監査用の出力ファイル。`auditLogPath` オプションには、絶対パス名または相対パス名のいずれかを指定できます。この設定は、 auditLog.path構成ファイルオプションに対応します。	no
`bindIp`	string	またはがクライアント接続をリッスンするホスト名、`mongos` `mongod`IPアドレス、Unix`mongos` ドメインソケットの完全なパスのすべてまたはいずれか。または`mongod` は任意のインターフェースにバインドできます。複数のアドレスにバインドするには、値をコンマで区切ったリストを入力します。この設定は、 net.bindIp構成ファイルオプションに対応します。	no
`bindIpAll`	ブール値	または `mongosmongod`インスタンスがすべての IPv4 アドレス（例:`0.0.0.0` ）にバインドされているかどうかを示すフラグ。が`ipv6` `true`に設定されている場合、は`bindIpAll` IPv6 アドレス（例、`::` ）にもバインドされます。 MongoDB CLI は、または`truefalse` の値を受け入れます。この設定は、 net.bindIpAll構成ファイルオプションに対応します。	no
`buildIndexes`	ブール値	`mongod`にインデックスを構築するよう指示するかどうかを示すフラグ。 MongoDB CLI`true` は、または`false` の値を受け入れます。この設定は、 buildIndexesレプリカセット構成オプションに対応します。	no
`dbPath`	string	`mongod`インスタンスがデータを保存するディレクトリ。これは配置後に変更することはできません。	はい
`delay`	整数	このノードがプライマリノードより遅れる秒数。この設定は、 slaveDelayレプリカセット構成オプションに対応します。	no
`directoryPerDB`	ブール値	MongoDB が各データベースのデータを保存するために個別のディレクトリを使用するかどうかを示すフラグ。ディレクトリは`storage.dbPath` ディレクトリの下にあり、各サブディレクトリ名はデータベース名に対応しています。デフォルトでは、 `directoryPerDB` は `false` です。この設定は、`storage.directoryPerDBmongod` レプリカセット構成オプションに対応します。	no
`enableMajorityReadConcern`	ブール値	読み取り保証 (read concern `"majority"`を有効にするかどうかを示すフラグ。有効にすると、読み取り保証`"majority"`は、読み取られたデータが、マルチドキュメントトランザクションに関連付けられていない読み取り操作について、レプリカセットのノードの大多数によって確認済みであることを保証します。デフォルトでは、 `enableMajorityReadConcern` は `true` です。この設定は、 replication.enableMajorityReadConcern レプリカセット構成オプションの値に応じてエラーを発生させるか、nil を返します。	no
`hostname`	string	レプリカセットに追加するホストの名前。これは、が`Ops Manager` `mongod`プロセスを配置するホストです。	はい
`inMemory.engineConfig.` `inMemorySizeGB`	float	インメモリストレージエンジンデータ（インデックス、がレプリカセットの一部である場合のoplog`mongod` 、レプリカセット、シャーディングされたクラスターのメタデータなど）に割り当てるメモリの最大量。値の範囲は`256` MB から`10` TB です。デフォルトで、インメモリストレージエンジンは物理RAMの 50% からGBを引いた量を使用します。 MongoDB Enterprise でのみ使用できます。この設定は、`inMemorySizeGBmongod` レプリカセット構成オプションに対応します。	no
`ipv6`	ブール値	配置がIPv6をサポートしているかどうかを示すフラグ。MongoDB CLI は、`true` または `false` の値を受け入れます。この設定は、net.IPv6 構成ファイルオプションに対応します。	no
`logDestination`	string	MongoDB がすべてのログ出力を送信する宛先。 MongoDB CLI は、 `file`または`syslog`の次の値を受け入れます。 `file`を指定する場合は、 `logPath`も指定する必要があります。 `logDestination`を指定しない場合、MongoDB はすべてのログ出力を標準出力に送信します。この設定は、 systemLog.d destination構成ファイルオプションに対応します。	no
`logPath`	string	`mongod`ホスト上のプロセスのログファイルの場所と名前。	はい
`oplogSizeMB`	integer	レプリケーションoplogの最大サイズ（メガバイト単位）。この設定は、 replication.oplogSizeMBレプリカセット構成オプションに対応します。	no
`port`	integer	レプリカセットノードのポート。`mongod` プロセスは、指定されたポートへの排他的アクセス権を持つ必要があります。	はい
`priority`	integer	選挙中のレプリカセットノードの優先順位。値は次のとおりです。 `0` `1` 投票権のないノードの優先順位は`0`である必要があります。優先順位が `0` のレプリカセットノードはプライマリになることができず、選挙をtriggerできません。	はい
`tls.CAFile`	string	`.pem` 証明機関からのルート証明書チェーンを含むファイル。相対パスまたは絶対パスを使用して、 `.pem`ファイルのファイル名を指定します。この設定は、net.tls.CAFile `mongod` レプリカセット構成オプションに対応します。	no
`tls.` `certificateKeyFile`	string	`.pem` TLS 証明書とキーの両方を含むファイル。 `tls.certificateKeyFile` と `tls.certificateSelector` は相互に排他的です。指定できるのは 1 つだけです。この設定は、net.tls.CertificateKeyFile `mongod` レプリカセット構成オプションに対応します。	no
`tls.` `certificateKeyFilePassword`	string	証明書キーファイルの復号化パスワード。 `tls.certificateKeyFilePassword`証明書鍵ファイルが暗号化されている場合にのみ、オプションを使用します。いずれの場合も、`mongos` または`mongod` は、すべてのログとレポート出力からパスワードを削除します。この設定は、net.tls.certifyKeyFilePassword `mongod` レプリカセット構成オプションに対応します。	no
`tls.certificateSelector`	string	MongoDB Agent がオペレーティングシステムの証明書ストアから、TLS/SSL に使用するのに合わせて証明書を選択するために使用する証明書のプロパティ。 MongoDB CLI は、次のキーと値のマッピングのいずれかを`tls.certificateSelector`の引数として受け入れます。 `subject` (ASCII string): 証明書のサブジェクト名またはコモンネーム。 `thumbprint` (hex string): SHA-1 ダイジェストによって公開キーを識別するために使用される、16進数で表現されるバイトシーケンス。`thumbprint` は `fingerprint` と呼ばれることもあります。 `tls.certificateKeyFile` と `tls.certificateSelector` は相互に排他的です。指定できるのは 1 つだけです。この設定は、net.tls.CertificateSelector `mongod` レプリカセット構成オプションに対応します。	no
`tls.` `clusterCertificateSelector`	string	MongoDB Agent が内部 x.509 メンバー認証に使用するために一致する証明書を選択するために使用する証明書プロパティ。 MongoDB CLI は、次のキーと値のマッピングのいずれかを`tls.clusterCertificateSelector`の引数として受け入れます。 `subject` (ASCII string): 証明書のサブジェクト名またはコモンネーム。 `thumbprint` (hex string): SHA-1 ダイジェストによって公開キーを識別するために使用される、16進数で表現されるバイトシーケンス。`thumbprint` は `fingerprint` と呼ばれることもあります。 `tls.clusterCertificateSelector` と `tls.clusterFile` は相互に排他的です。指定できるのは 1 つだけです。この設定は、net.tls.clustercertifySelector `mongod` レプリカセット構成オプションに対応します。	no
`tls.clusterFile`	string	`.pem` x を含むファイル。クラスターまたはレプリカセットのメンバーシップ認証用の509証明書キーファイル。 `tls.clusterCertificateSelector` と `tls.clusterFile` は相互に排他的です。指定できるのは 1 つだけです。この設定は、net.tls.clusterFile `mongod` レプリカセット構成オプションに対応します。	no
`tls.clusterPassword`	string	`tls.clusterFile`で指定された x.509 証明書キーファイルの復号化パスワード。 `tls.clusterPassword`証明書鍵ファイルが暗号化されている場合にのみ、オプションを使用します。いずれの場合も、`mongos` または`mongod` は、すべてのログとレポート出力からパスワードを削除します。この設定は、net.tls.clusterPassword `mongod` レプリカセット構成オプションに対応します。	no
`tls.CRLFile`	string	証明書失効リストを含む `.pem` ファイル。相対パスまたは絶対パスを使用して `.pem` ファイルのファイル名を指定します。この設定は、net.tls.CRLFile `mongod` レプリカセット構成オプションに対応します。	no
`tls.disabledProtocols`	string	TLS で実行されている MongoDB サーバーが着信接続を拒否するプロトコルまたはバージョン。この設定は、net.tls.disabledProtocols `mongod` レプリカセット構成オプションに対応します。	no
`tls.FIPSMode`	string	またはの`mongos` TLS`mongod` ライブラリの FIPSモードの使用を有効または無効にします。このオプションを使用するには、システムに FIPS 準拠のライブラリが必要です。この設定は、net.tls.FIPSMode `mongod` レプリカセット構成オプションに対応します。	no
`tls.mode`	string	すべてのネットワーク接続に対して TLS を有効にします。 MongoDB CLI は、この設定に対して次の引数を受け入れます。 `disabled`:サーバーはTLS を使用しません。 `allowTLS`: サーバー間の接続では TLS は使用されません。着信接続の場合、サーバーではTLS と非 tls のいずれも受け付けます。 `preferTLS`: サーバー間の接続は TLS を使用します。着信接続の場合、サーバーではTLS と非 tls のいずれも受け付けます。 `requireTLS`:サーバーはTLS 暗号化接続のみを使用し、受け入れます。この設定は net.tls `mongod` に対応します。モードレプリカセット構成オプション。	no
`tls.PEMKeyFile`	string	`.pem` TLS 証明書とキーの両方を含むファイル。重要:この設定は非推奨です。代わりに`tls.certificateKeyFile`を使用してください。この設定は、net.ssl.PEMKeyFile `mongod` レプリカセット構成オプションに対応します。	no
`votes`	integer	レプリカセットが選挙で投票するかどうかを示す数値。 MongoDB CLI は、次の値を受け入れます。 `0` レプリカセットノードが投票できない場合 `1` レプリカセットノードが投票できる場合 `votes`について詳しくは、「投票」を参照してください。	はい
`wiredTiger.engineConfig.` `cacheSizeGB`	float	WiredTiger がすべてのデータに使用する内部キャッシュの最大サイズ。値の範囲は`0.25` GB から`10000` GB です。デフォルトでは、WiredTiger の内部キャッシュサイズは次のいずれか大きい方です。（RAM-1 GB）の50%、または 256 MB. WiredTiger 内部キャッシュサイズがデフォルト値より大きくならないようにしてください。この設定は、`journalCompressormongod` レプリカセット構成オプションに対応します。	no
`wiredTiger.engineConfig.` `journalCompressor`	string	WiredTiger ジャーナリングデータを圧縮するのに使用する圧縮タイプ。利用可能なコンプレッサーは次のとおりです。 `none` Snappy zlib zstd デフォルトでは、WiredTiger は snappy を使用します。この設定は、`journalCompressormongod` レプリカセット構成オプションに対応します。	no
`wiredTiger.engineConfig.` `directoryForIndexes`	ブール値	`mongod`がデータ（`storage.dbPath` ）ディレクトリ`mongod` の下の個別のサブディレクトリにインデックスとコレクションを保存するかどうかを示すフラグ。具体的には、`index` はインデックスをという名前のサブディレクトリに保存し、コレクションデータを`collection` という名前のサブディレクトリに保存します。シンボリックリンクを使用すると、インデックスに別の場所を指定できます。具体的には、`mongod` インスタンスがを実行中いない場合は、`index` サブディレクトリを新しい宛先に移動し、新しい宛先へのデータディレクトリの下にという名前のシンボリック`index` リンクを作成します。デフォルトでは、 `wiredTiger.engineConfig.` `directoryForIndexes`は`false`です。この設定は、`directoryForIndexesmongod` レプリカセット構成オプションに対応します。	no
`wiredTiger.collectionConfig.` `blockCompressor`	string	コレクションデータのデフォルトの圧縮。これは、コレクションを作成する際、コレクションごとに上書きできます。利用可能なコンプレッサーは次のとおりです。 `none` Snappy zlib zstd デフォルトでは、コンプレッサーはsnappy です。この設定は、新しく作成されたすべてのコレクションに影響します。既存の MongoDB デプロイでこの設定の値を変更すると、新しいコレクションのすべてで指定されたコンプレッサーが使用されます。既存のコレクションは、作成時に指定されたコンプレッサー、またはその時点でのデフォルトのコンプレッサーを引き続き使用します。この設定は、`blockCompressormongod` レプリカセット構成オプションに対応します。	no
`wiredTiger.indexConfig.` `prefixCompression`	ブール値	インデックスデータの接頭辞圧縮を有効にするか無効にするかを示すフラグ。 `true`の場合、インデックスデータの接頭辞圧縮が有効になります。`false` の場合、接頭辞圧縮は無効になります。デフォルトでは、 `wiredTiger.indexConfig.prefixCompression`は`true`です。この設定は作成されたすべてのインデックスに影響します。既存の MongoDB の配置でこの設定の値を変更すると、すべての新しいインデックスで接頭辞圧縮が使用されます。既存のインデックスは影響を受けません。この設定は、`prefixCompressionmongod` レプリカセット構成オプションに対応します。	no

シャード設定

MongoDB Cloud ManagerまたはMongoDB Ops Managerクラスターを作成または更新するための構成ファイルには、各シャードに対して次の設定を含めることができます。

フィールド	タイプ	説明	必須
`name`	string	シャードのの名前。	はい
`processes`	オブジェクトの配列	各`mongod` プロセスの設定を含むオブジェクトの配列。各`mongod` にはレプリカセットメンバー設定があります。	はい

サンプル構成ファイル

name: "myCluster"
version: 7.0.0
featureCompatibilityVersion: 7.0
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": "7.0.0",
    "featureCompatibilityVersion": "7.0",
    "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": "7.0.0",
  "featureCompatibilityVersion": "7.0",
  "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": "7.0.0-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
    }
  ]
}

戻る

参照

トラブルシューティング