클러스터 구성 파일

이 페이지의 내용

필수 cluster 설정

선택적 및 조건부 클러스터 설정
클러스터 구성 파일 예시
멀티클라우드 클러스터 구성 파일 예시
지리적 샤드 클러스터 구성 파일 예시

cluster 구성 파일을 사용하면 Atlas CLI를 사용하여 cluster를 생성하거나 업데이트할 때 필요한 설정을 지정할 수 있습니다. Atlas CLI는 .json cluster 구성 파일을 허용합니다.

다음 리소스를 사용하여 다음을 수행할 수 있습니다.

클러스터 구성 파일에서 지정할 수 있는 필수 설정 에 대해 알아보세요.
샘플 구성 파일을 보고 복사합니다.

필수 cluster 설정

Atlas CLI를 사용하여 클러스터를 만들려면 Atlas에서 다음 설정이 필요합니다. 이러한 cluster 설정은 구성 파일에서 지정하거나 명령의 플래그로 지정해야 합니다.

필드	유형	설명
`clusterType`	문자열	생성할 클러스터의 유형을 나타내는 사람이 읽을 수 있는 레이블입니다. 값에는 `REPLICASET`, `SHARDED` 또는 `GEOSHARDED` 가 포함됩니다.
`name`	문자열	클러스터를 식별하는 사람이 읽을 수 있는 라벨입니다.
`replicationSpecs`	배열	클러스터 리전에 대한 구성 설정 및 클러스터 리전에 프로비저닝된 하드웨어가 포함된 목록입니다.
`replicationSpecs.` `regionConfigs`	배열	지정한 리전 내에 설정된 노드에 대한 hardware 사양이 포함된 목록입니다. 각 `regionConfigs` 객체는 투표에서 리전의 우선 순위와 Atlas가 해당 리전에 배포하는 MongoDB 노드의 수 및 유형을 설명합니다. 각 `regionConfigs` 객체에는 `analyticsSpecs` 객체, `electableSpecs` 객체 또는 `readOnlySpecs` 객체가 있어야 합니다. 공유 클러스터에는 `electableSpecs` 만 필요합니다. 전용 클러스터는 이러한 사양 중 무엇이든 지정할 수 있지만 `replicationSpec` 내에 `electableSpecs` 객체가 하나 이상 있어야 합니다. 모든 hardware 사양은 동일한 `instanceSize` 을 사용해야 합니다.
`replicationSpecs.` `regionConfigs.electableSpecs`	객체	리전 의 투표 선택 가능 노드에 대한 하드웨어 사양입니다. 투표 선택 가능 노드는 프라이머리 노드가 될 수 있으며 로컬 읽기를 활성화 할 수 있습니다.
`replicationSpecs.` `regionConfigs.` `electableSpecs.instanceSize`	문자열	이 리전의 인스턴스 크기에 대한 하드웨어 사양입니다. 자세한 내용은 클러스터 계층 선택을 참조하세요.
`replicationSpecs` `.regionConfigs.` `electableSpecs.nodeCount`	숫자	Atlas가 해당 리전에 배포할 수 있는 투표 선택 가능 노드의 수입니다. 투표 선택 가능 노드는 프라이머리 노드가 될 수 있으며 로컬 읽기를 활성화할 수 있습니다. 모든 replicationSpecs[n].regionConfigs[m] 객체의 결합된 lectableSpecs.nodeCount는 총 3개, 5개 또는 7개여야 합니다.
`replicationSpecs.` `regionConfigs.priority`	Integer	예비 투표가 발생할 때 이 리전에 부여되는 우선순위입니다. 해당 리전에서 `electableSpecs.nodeCount` 을 `1` 이상으로 설정한 경우 우선 순위는 `replicationSpecs[n].regionConfigs[m]` 배열의 다른 리전보다 정확히 1 낮아야 합니다. 최우선 순위 리전의 우선 순위는 `7` 이어야 합니다. 가능한 가장 낮은 우선순위는 `1` 입니다. 우선 순위 `7` 리전 은 클러스터 의 기본 리전 을 식별합니다. Atlas 는 프라이머리 노드 를 기본 리전 에 배치합니다.
`replicationSpecs.` `regionConfigs.providerName`	문자열	클라우드 서비스 제공자를 식별하는 사람이 읽을 수 있는 레이블입니다. 값에는 `AWS`, `AZURE` 또는 `GCP` 가 포함됩니다.
`replicationSpecs.` `regionConfigs.regionName`	문자열	cluster 노드의 물리적 위치를 나타내는 사람이 읽을 수 있는 레이블입니다. 선택하는 리전은 데이터베이스에 액세스하는 클라이언트의 네트워크 지연 시간에 영향을 줄 수 있습니다. 리전 이름 값의 전체 목록은 cloud 공급자 참고 페이지를 참조하세요. AWS GCP Azure

선택적 및 조건부 클러스터 설정

클러스터 구성 파일에는 추가적인 선택적 또는 조건부 클러스터 설정이 포함될 수 있습니다. GEOSHARDED 의 clusterType 을 선택한 경우 구성 파일에서 또는 명령의 플래그로 다음 클러스터 설정을 지정해야 합니다.

필드	유형	설명
`replicationSpecs.` `numShards`	문자열	지정된 각 구역에 배포할 샤드 수를 지정하는 양의 정수. `SHARDED` 또는 `GEOSHARDED` 의 `clusterType` 을 설정한 경우 이 값을 제공하십시오. `REPLICASET` } 중 `clusterType` 을 선택한 경우 이 값을 생략합니다. 이 API 리소스는 `1` ~ `50` 을(를) 허용합니다. 이 매개변수의 기본값은 `1` 입니다. `numShards` 값을 `1` 로 지정하고 `clusterType` 를 `SHARDED` 로 지정하면 Atlas는 단일 샤드 샤드 클러스터를 배포합니다. 프로덕션 환경에서는 단일 샤드로 샤딩된 클러스터를 생성하지 마세요. 단일 샤드로 샤딩된 클러스터는 다중 샤드 구성과 동일한 이점을 제공하지 않습니다.
`replicationSpecs.` `zoneName`	문자열	글로벌 클러스터 에 있는 구역의 이름입니다. `clusterType` 을 `GEOSHARDED` 로 설정한 경우 이 값을 입력합니다.
`tags`	배열	클러스터에 태그를 지정하고 분류하기위한 1 ~ 255 자 길이의 키-값 쌍이 포함된 목록입니다.
`tags.key`	문자열	태그 세트를 정의하는 상수입니다. 예를 들어 `environment : production` 태그의 `environment` 입니다.
`tags.value`	문자열	태그 세트에 속하는 변수입니다. 예를 들어 `environment : production` 태그의 `production` 입니다.

사용 가능한 설정의 전체 목록은 1개의 프로젝트에서 1개의 멀티클라우드 클러스터 생성에 대한 API 설명서를 참조하세요.

클러스터 구성 파일 예시

단일 cloud 공급자를 사용하여 cluster를 생성하려면 다음 예제 파일에 표시된 대로 regionConfigs 객체에 동일한 서비스 제공자를 지정합니다.

{
  "name":"myCluster",
  "clusterType":"REPLICASET",
  "replicationSpecs":[
    {
      "regionConfigs":[
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":7,
          "providerName":"AWS",
          "regionName":"EU_WEST_1"
        },
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":6,
          "providerName":"AWS",
          "regionName":"US_EAST_1"
        },
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":5,
          "providerName":"AWS",
          "regionName":"US_WEST_1"
        }
      ]
    }
  ]
}

멀티클라우드 클러스터 구성 파일 예시

멀티 cloud cluster를 생성하려면 다음 예제 파일에 표시된 대로 regionConfigs 객체에 대해 둘 이상의 서비스 제공자를 지정합니다.

{
  "name":"myCluster",
  "clusterType":"REPLICASET",
  "replicationSpecs":[
    {
      "regionConfigs":[
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":7,
          "providerName":"AWS",
          "regionName":"EU_WEST_1"
        },
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":6,
          "providerName":"GCP",
          "regionName":"CENTRAL_US"
        },
        {
          "electableSpecs":{
            "instanceSize":"M30",
            "nodeCount":1
          },
          "priority":5,
          "providerName":"AZURE",
          "regionName":"US_EAST_2"
        }
      ]
    }
  ]
}

지리적 샤드 클러스터 구성 파일 예시

지리적으로 샤딩된 클러스터를 생성하려면 다음 예제 파일에 표시된 대로 replicationSpecs 객체에 대한 구역을 지정합니다.

{
    "backupEnabled": false,
    "biConnector": {
      "enabled": false,
      "readPreference": "secondary"
    },
    "clusterType": "GEOSHARDED",
    "diskSizeGB": 100,
    "encryptionAtRestProvider": "NONE",
    "mongoDBMajorVersion": "5.0",
    "name": "myCluster",
    "paused": false,
    "pitEnabled": false,
    "stateName": "IDLE",
    "replicationSpecs": [
      {
        "numShards": 1,
        "zoneName": "US-1",
        "regionConfigs": [
          {
            "analyticsSpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 0
            },
            "electableSpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 3
            },
            "readOnlySpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 0
            },
            "autoScaling": {
              "diskGB": {
                "enabled": true
              },
              "compute": {
                "enabled": false,
                "scaleDownEnabled": false
              }
            },
            "priority": 7,
            "providerName": "AWS",
            "regionName": "US_EAST_1"
          }
        ]
      },
      {
        "numShards": 1,
        "zoneName": "US-2",
        "regionConfigs": [
          {
            "analyticsSpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 0
            },
            "electableSpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 3
            },
            "readOnlySpecs": {
              "diskIOPS": 3000,
              "ebsVolumeType": "STANDARD",
              "instanceSize": "M30",
              "nodeCount": 0
            },
            "autoScaling": {
              "diskGB": {
                "enabled": true
              },
              "compute": {
                "enabled": false,
                "scaleDownEnabled": false
              }
            },
            "priority": 7,
            "providerName": "AWS",
            "regionName": "US_EAST_2"
          }
        ]
      }
    ]
  }

돌아가기

JSON 구성 파일

cloud 백업 일정