/ /

클러스터 구성 파일

개요

The mongocli command requires cluster configuration settings for creating or updating a MongoDB Cloud Manager or MongoDB Ops Manager cluster. The configuration properties can be provided through a .yaml or .json file. The following sections describe the Configuration Properties that are required for creating or updating a cluster and provide a Sample Configuration File that you can copy and modify.

구성 속성

다음 섹션에는 다음이 포함되어 있습니다.

cluster 전체 구성 속성
복제본 세트 멤버 구성 속성
샤드 cluster 구성 속성

cluster 전체 설정

The configuration file for creating or updating a MongoDB Cloud Manager or MongoDB Ops Manager cluster must contain the following cluster-wide settings:

필드	유형	설명
`name`	문자열	cluster의 이름입니다.
`version`	문자열	Version of the `mongod` process to deploy.
`featureCompatibilityVersion`	문자열	Feature Compatibility Version of the deployment.
`processes`	객체 배열	Required for replica sets. An array of objects containing settings for each `mongod` process. Each `mongod` has replica set member settings.
`shards`	객체 배열	샤드 cluster에 필요합니다. 각 샤드에 대한 설정이 포함된 객체 배열입니다.
`config`	객체	Required for sharded clusters. Object that contains your config server replica set.
`mongos`	객체 배열	Required for sharded clusters. An array of objects containing settings for each `mongos` instance.

복제본 세트 멤버 설정

MongoDB Cloud Manager 또는 MongoDB Ops Manager 클러스터를 만들거나 업데이트하기 위한 구성 파일에는 각 복제본 세트 멤버에 대한 다음 설정이 포함될 수 있습니다.

필드	유형	설명	필수 사항입니다.
`auditLogDestination`	문자열	Setting that enables auditing and specifies where to send all audit events. MongoDB CLI accepts the following values: `syslog` `syslog`에 감사 이벤트를 JSON 형식으로 출력합니다. `console` `stdout`에 감사 이벤트를 JSON 형식으로 출력합니다. `file` `auditLogFormat` 설정에 지정된 형식으로 `auditLogPath` 설정에 지정된 파일로 감사 이벤트를 출력합니다. This setting corresponds to the auditLog.destination configuration file option.	no
`auditLogFilter`	문자열	감사되는 이벤트를 필터링하는 설정입니다. 이 필터는 지정한 쿼리와 일치하도록 결과를 제한합니다. To learn more about creating filters, see Configure Audit Filters. 이 설정은 auditLog.filter 구성 파일 옵션에 해당합니다.	no
`auditLogFormat`	문자열	Format of the output file for auditing if `auditLogDestination` is set to `file`. MongoDB CLI는 다음 값을 허용합니다. `JSON` `auditLogPath` 설정에 지정된 파일에 감사 이벤트를 JSON 형식으로 출력합니다. `BSON` 감사 이벤트를 BSON 바이너리 형식으로 `auditLogPath` 설정에 지정된 파일로 출력합니다. This setting corresponds to the auditLog.format configuration file option.	no
`auditLogPath`	문자열	Output file for auditing if `auditLogDestination` has a value of `file`. The `auditLogPath` option can take either an absolute or a relative path name. 이 설정은 auditLog.path 구성 파일 옵션에 해당합니다.	no
`bindIp`	문자열	Hostnames and/or IP addresses and/or full Unix domain socket paths on which `mongos` or `mongod` should listen for client connections. You may attach `mongos` or `mongod` to any interface. To bind to multiple addresses, enter a list of comma-separated values. This setting corresponds to the net.bindIp configuration file option.	no
`bindIpAll`	부울	Flag that indicates whether the `mongos` or `mongod` instance binds to all IPv4 addresses (for example, `0.0.0.0`). If `ipv6` is set to `true`, `bindIpAll` also binds to IPv6 addresses (for example, `::` ). MongoDB CLI accepts the following values: `true` or `false`. 이 설정은 net.bindIpAll 구성 파일 옵션에 해당합니다.	no
`buildIndexes`	부울	Flag that indicates whether to direct the `mongod` to build indexes. MongoDB CLI accepts the following values: `true` or `false`. 이 설정은 buildIndexes 복제본 세트 구성 옵션에 해당합니다.	no
`dbPath`	문자열	Directory where the `mongod` instance stores its data. This cannot be modified after deployment.	네
`delay`	int	이 멤버가 프라이머리 멤버보다 지연되어야 하는 시간(초)입니다. 이 설정은 slaveDelay 복제본 세트 구성 옵션에 해당합니다.	no
`directoryPerDB`	부울	Flag that indicates whether MongoDB should use a separate directory to store data for each database. The directories are under the `storage.dbPath` directory, and each subdirectory name corresponds to the database name. 기본적으로 `directoryPerDB`는 `false`입니다. This setting corresponds to the `storage.directoryPerDB` `mongod` replica set configuration option.	no
`enableMajorityReadConcern`	부울	Flag that indicates whether or not to enable read concern `"majority"`. If enabled, read concern `"majority"` guarantees that the data read has been acknowledged by a majority of the replica set members for read operations not associated with multi-document transactions. 기본적으로 `enableMajorityReadConcern`는 `true`입니다. This setting corresponds to the replication.enableMajorityReadConcern replica set configuration option.	no
`hostname`	문자열	Name of the host to add to the replica set. This is the host on which `Ops Manager` deploys the `mongod` process.	네
`inMemory.engineConfig.` `inMemorySizeGB`	float	Maximum amount of memory to allocate for in-memory storage engine data, including indexes, oplog if the `mongod` is part of replica set, replica set or sharded cluster metadata, etc. 값의 범위는 `256` MB에서 `10` TB까지입니다. 기본적으로 storage engine은 물리적 RAM에서 1GB를 뺀 값의 50%를 사용합니다. 이는 MongoDB Enterprise 에서만 사용할 수 있습니다. This setting corresponds to the `inMemorySizeGB` `mongod` replica set configuration option.	no
`ipv6`	부울	배포서버가 IPv6을 지원하는지 여부를 나타내는 플래그입니다. MongoDB CLI는 `true` 또는 `false` 값을 허용합니다. This setting corresponds to the net.ipv6 configuration file option.	no
`logDestination`	문자열	MongoDB가 모든 로그 출력을 전송하는 대상입니다. MongoDB CLI는 `file` 또는 `syslog` 값을 허용합니다. `file` 를 지정하는 경우 `logPath` 도 지정해야 합니다. `logDestination` 을 지정하지 않으면 MongoDB는 모든 로그 출력을 표준 출력으로 보냅니다. 이 설정은 systemLog.destination 구성 파일 옵션에 해당합니다.	no
`logPath`	문자열	Location and name of the log file for the `mongod` process on the host.	네
`oplogSizeMB`	integer	복제 oplog 의 최대 크기(MB)입니다. 이 설정은 replication.oplogSizeMB 복제본 세트 구성 옵션에 해당합니다.	no
`port`	integer	Port for the replica set member. The `mongod` process must have exclusive access to the specified port.	네
`priority`	integer	투표 중 복제본 세트 멤버의 우선순위 입니다. 값은 다음과 같습니다. `0` `1` 투표권이 없는 멤버의 우선순위는 `0` 이어야 합니다. 우선 순위가 `0` 인 복제본 세트 멤버는 프라이머리가 될 수 없으며 trigger 투표를 할 수 없습니다.	네
`tls.CAFile`	문자열	`.pem` 인증 기관의 루트 인증서 체인이 포함된 파일입니다. 상대 경로 또는 절대 경로를 사용하여 `.pem` 파일의 이름을 지정합니다. This setting corresponds to the net.tls.CAFile `mongod` replica set configuration option.	no
`tls.` `certificateKeyFile`	문자열	`.pem` TLS 인증서와 키가 모두 포함된 파일입니다. `tls.certificateKeyFile` 와 `tls.certificateSelector` 은 상호 배타적입니다. 둘 중 하나만 지정해야 합니다. This setting corresponds to the net.tls.certificateKeyFile `mongod` replica set configuration option.	no
`tls.` `certificateKeyFilePassword`	문자열	인증서 키 파일의 암호를 해독하기 위한 비밀번호입니다. Use the `tls.certificateKeyFilePassword` option only if the certificate-key file is encrypted. In all cases, the `mongos` or `mongod` will redact the password from all logging and reporting output. This setting corresponds to the net.tls.certificateKeyFilePassword `mongod` replica set configuration option.	no
`tls.certificateSelector`	문자열	MongoDB Agent가 운영 체제의 인증서 저장소에서 TLS/SSL에 일치하는 인증서를 선택하는 데 사용하는 속성입니다. MongoDB CLI는 다음 키-값 매핑 중 하나를 `tls.certificateSelector` 의 인수로 허용합니다. `subject` (ASCII string): 인증서의 주체 이름 또는 일반 이름입니다. `thumbprint` (hex string): 16진수로 표현되는 바이트 시퀀스로, SHA-1 다이제스트로 공개 키를 식별하는 데 사용됩니다. `thumbprint` 는 `fingerprint`라고도 합니다. `tls.certificateKeyFile` 와 `tls.certificateSelector` 은 상호 배타적입니다. 둘 중 하나만 지정해야 합니다. This setting corresponds to the net.tls.certificateSelector `mongod` replica set configuration option.	no
`tls.` `clusterCertificateSelector`	문자열	Certificate property that the MongoDB Agent uses to select a matching certificate from the operating system’s certificate store to use for internal x.509 membership authentication. MongoDB CLI는 다음 키-값 매핑 중 하나를 `tls.clusterCertificateSelector` 의 인수로 허용합니다. `subject` (ASCII string): 인증서의 주체 이름 또는 일반 이름입니다. `thumbprint` (hex string): 16진수로 표현되는 바이트 시퀀스로, SHA-1 다이제스트로 공개 키를 식별하는 데 사용됩니다. `thumbprint` 는 `fingerprint`라고도 합니다. `tls.clusterCertificateSelector` 와 `tls.clusterFile` 은 상호 배타적입니다. 둘 중 하나만 지정해야 합니다. This setting corresponds to the net.tls.clustercertificateSelector `mongod` replica set configuration option.	no
`tls.clusterFile`	문자열	`.pem` x가 포함된 파일입니다. 클러스터 또는 복제본 세트에 대한 멤버십 인증 을 위한 509 인증서-키 파일입니다. `tls.clusterCertificateSelector` 와 `tls.clusterFile` 은 상호 배타적입니다. 둘 중 하나만 지정해야 합니다. This setting corresponds to the net.tls.clusterFile `mongod` replica set configuration option.	no
`tls.clusterPassword`	문자열	0}으로 지정된 x.509 인증서 키 파일의 암호를 해독하기 위한 비밀번호입니다.`tls.clusterFile` Use the `tls.clusterPassword` option only if the certificate-key file is encrypted. In all cases, the `mongos` or `mongod` will redact the password from all logging and reporting output. This setting corresponds to the net.tls.clusterPassword `mongod` replica set configuration option.	no
`tls.CRLFile`	문자열	인증서 해지 목록이 포함된 `.pem` 파일입니다. 상대 경로 또는 절대 경로를 사용해 `.pem` 파일의 이름을 지정합니다. This setting corresponds to the net.tls.CRLFile `mongod` replica set configuration option.	no
`tls.disabledProtocols`	문자열	TLS로 실행되는 MongoDB Server가 수신 연결을 거부하는 프로토콜 또는 버전입니다. This setting corresponds to the net.tls.disabledProtocols `mongod` replica set configuration option.	no
`tls.FIPSMode`	문자열	Enable or disable the use of the FIPS mode of the TLS library for the `mongos` or `mongod`. Your system must have a FIPS compliant library to use this option. This setting corresponds to the net.tls.FIPSMode `mongod` replica set configuration option.	no
`tls.mode`	문자열	모든 네트워크 연결에 대해 TLS를 활성화합니다. MongoDB CLI는 이 설정에 대해 다음 인수를 허용합니다. `disabled`: 서버 tls를 사용하지 않습니다. `allowTLS`: 서버 간 연결에서 tls를 사용하지 않습니다. 수신 연결의 경우 서버 TLS와 비 TLS를 모두 허용합니다. `preferTLS`: 서버 간 연결에 tls를 사용합니다. 수신 연결의 경우 서버 TLS와 비 TLS를 모두 허용합니다. `requireTLS`: 서버 TLS 암호화됨 연결만 사용하고 허용합니다. This setting corresponds to the net.tls.mode `mongod` replica set configuration option.	no
`tls.PEMKeyFile`	문자열	`.pem` TLS 인증서와 키가 모두 포함된 파일입니다. 중요: 이 설정은 더 이상 사용되지 않습니다. 대신 `tls.certificateKeyFile` 을(를) 사용하세요. This setting corresponds to the net.ssl.PEMKeyFile `mongod` replica set configuration option.	no
`votes`	integer	복제본 세트 멤버가 투표를 하는지 여부를 나타내는 숫자입니다. MongoDB CLI는 다음 값을 허용합니다. `0` 복제본 세트 노드가 투표할 수 없는 경우 `1` 복제본 세트 멤버가 투표할 수 있는 경우 `votes` 에 대해 자세히 알아보려면 투표를 참조하세요.	네
`wiredTiger.engineConfig.` `cacheSizeGB`	float	WiredTiger가 모든 데이터에 사용하는 내부 캐시의 최대 크기입니다. 값의 범위는 `0.25` GB에서 `10000` GB입니다. 기본적으로 WiredTiger 내부 캐시 크기는 둘 중 더 큽니다. (RAM - 1GB)의 50% 256 MB. WiredTiger 내부 캐시 크기를 기본값 이상으로 늘리지 마세요. This setting corresponds to the `journalCompressor` `mongod` replica set configuration option.	no
`wiredTiger.engineConfig.` `journalCompressor`	문자열	WiredTiger 저널 데이터를 압축하는 데 사용할 압축 유형입니다. 사용할 수 있는 압축 옵션은 다음과 같습니다. `none` 스내피 zlib zstd 기본값 으로 WiredTiger 는 스내피를 사용합니다 . This setting corresponds to the `journalCompressor` `mongod` replica set configuration option.	no
`wiredTiger.engineConfig.` `directoryForIndexes`	부울	Flag that indicates whether `mongod` stores indexes and collections in separate subdirectories under the data (i.e. `storage.dbPath`) directory. Specifically, `mongod` stores the indexes in a subdirectory named `index` and the collection data in a subdirectory named `collection`. By using a symbolic link, you can specify a different location for the indexes. Specifically, when the `mongod` instance is not running, move the `index` subdirectory to a new destination and create a symbolic link named `index` under the data directory to the new destination. 기본적으로 `wiredTiger.engineConfig.` `directoryForIndexes` 은 `false` 입니다. This setting corresponds to the `directoryForIndexes` `mongod` replica set configuration option.	no
`wiredTiger.collectionConfig.` `blockCompressor`	문자열	collection 데이터의 기본 압축입니다. collection을 만들 때 collection별로 이 값을 재정의할 수 있습니다. 사용할 수 있는 압축 옵션은 다음과 같습니다. `none` 스내피 zlib zstd By default the compressor is snappy. 이 설정은 새로 생성된 모든 collection에 영향을 줍니다. 기존 MongoDB 배포에서 이 설정의 값을 변경하면 모든 새 collection이 지정된 압축기를 사용합니다. 기존 collection은 생성 시 지정된 압축기 또는 당시의 기본 압축기를 계속 사용합니다. This setting corresponds to the `blockCompressor` `mongod` replica set configuration option.	no
`wiredTiger.indexConfig.` `prefixCompression`	부울	Flag that indicates whether to enable or disable prefix compression for index data. If `true`, prefix compression is enabled for index data. If `false`, prefix compression is disabled. 기본적으로 `wiredTiger.indexConfig.prefixCompression` 은 `true` 입니다. 이 설정은 생성된 모든 인덱스에 영향을 줍니다. 기존 MongoDB 배포에서 이 설정의 값을 변경하면 모든 새 인덱스가 접두사 압축을 사용합니다. 기존 인덱스는 영향을 받지 않습니다. This setting corresponds to the `prefixCompression` `mongod` replica set configuration option.	no

샤드 설정

MongoDB Cloud Manager 또는 MongoDB Ops Manager 클러스터를 생성하거나 업데이트하기 위한 구성 파일에는 각 샤드에 대한 다음 설정이 포함될 수 있습니다.

필드	유형	설명	필수 사항입니다.
`name`	문자열	샤드의 이름입니다.	네
`processes`	객체 배열	An array of objects containing settings for each `mongod` process. Each `mongod` has replica set member settings.	네

샘플 구성 파일

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
    }
  ]
}

돌아가기

참조

문제 해결