AtlasDeployment 사용자 지정 리소스

예시

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: test-cluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: US-Zone
        numShards: 3
        regionConfigs:
          - regionName: CENTRAL_US
            providerName: GCP
            backingProviderName: GCP
            priority: 7
            electableSpecs:
              instanceSize: M10
              nodeCount: 3
status:
  conditions:
  - lastTransitionTime: "2021-03-18T16:32:43Z"
    status: "True"
    type: Ready
  - lastTransitionTime: "2021-03-18T16:32:43Z"
    status: "True"
    type: ClusterReady
  connectionStrings:
    standard: mongodb://test-cluster-shard-00-00.kpc8f.mongodb.net:27017,test-cluster-shard-00-01.kpc8f.mongodb.net:27017,test-cluster-shard-00-02.kpc8f.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-1gm1pv-shard-0
    standardSrv: mongodb+srv://test-cluster.kpc8f.mongodb.net
  mongoDBVersion: 6.0
  mongoURIUpdated: "2021-03-12T12:21:41Z"
  observedGeneration: 1
  stateName: IDLE

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: development
  deploymentSpec:
    clusterType: REPLICASET
    name: service-name
    tags:
    - key: "environment"
      value: "production"
    backupEnabled: true
    replicationSpecs:
      - numShards: 1
        regionConfigs:
         - regionName: EASTERN_US
           providerName: GCP
           autoScaling:
             diskGB:
               enabled: true
             compute:
               enabled: true
               scaleDownEnabled: true
               minInstanceSize: M30
               maxInstanceSize: M40
           analyticsSpecs:
             instanceSize: M30
             nodeCount: 1
           electableSpecs:
             instanceSize: M30
             nodeCount: 3
           priority: 7
           readOnlySpecs:
             instanceSize: M30
             nodeCount: 1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    name: test-cluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: Zone 1
        regionConfigs:
         - electableSpecs:
             instanceSize: M10
             nodeCount: 3
           providerName: AWS
           regionName: US_EAST_1
           priority: 7
  processArgs:
    javascriptEnabled: false

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  projectRef:
    name: development
  serverlessSpec:
    name: serverless-instance
    tags:
    - key: "environment"
      value: "production"
    providerSettings:
      providerName: AWS
      regionName: US_EAST_1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: tenantCluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - zoneName: Zone 1
        regionConfigs:
        priority: 7
        - electableSpecs:
            instanceSize: M10
            nodeCount: 3
          providerName: AWS
          regionName: US_EAST_1

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: tenantCluster
    tags:
    - key: "environment"
      value: "production"
    replicationSpecs:
      - regionConfigs:
        - electableSpecs:
            instanceSize: M10
            nodeCount: 3
          providerName: AWS
          regionName: US_EAST_1
          priority: 7
        - electableSpecs:
            instanceSize: M10
            nodeCount: 2
          providerName: AZURE
          regionName: US_EAST_2
          priority: 6
        - electableSpecs:
            instanceSize: M10
            nodeCount: 2
          providerName: GCP
          regionName: CENTRAL_US
          priority: 5

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  deploymentSpec:
    backupEnabled: true
    clusterType: REPLICASET
    name: Test-cluster-M10
    replicationSpecs:
    - regionConfigs:
      - backingProviderName: AWS
        electableSpecs:
          instanceSize: M10
          nodeCount: 3
        priority: 7
        providerName: AWS
        regionName: US_EAST_1
      zoneName: Zone 1
    searchIndexes:
    - DBName: sample_training
      collectionName: grades
      name: test-vector-search-index
      type: vectorSearch
      vectorSearch:
        fields:
        - numDimensions: 1000
          path: student_id
          similarity: euclidean
          type: vector
    - DBName: sample_airbnb
      collectionName: listingsAndReviews
      name: my-index
      search:
        mappings:
          dynamic: true
        searchConfigurationRef:
          name: atlassearchindexconfig-sample
          namespace: mongodb-atlas-system
      type: search
    terminationProtectionEnabled: false
  projectRef:
    name: my-project
    namespace: mongodb-atlas-system

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  namespace: mongodb-atlas-system
spec:
  deploymentSpec:
    backupEnabled: true
    clusterType: REPLICASET
    name: Test-cluster-M10
    replicationSpecs:
    - regionConfigs:
      - backingProviderName: AWS
        electableSpecs:
          instanceSize: M10
          nodeCount: 3
        priority: 7
        providerName: AWS
        regionName: US_EAST_1
      zoneName: Zone 1
    searchNodes:
    - instanceSize: S20_HIGHCPU_NVME
      nodeCount: 2

매개변수

이 섹션에서는 사용 가능한 주요 AtlasDeployment 사용자 지정 리소스 매개변수 몇 가지에 대해 설명합니다.

• 클러스터에 사용할 수 있는 매개변수의 전체 목록은 Atlas Clusters API(클러스터 API)를 참조하세요.

• 서버리스 인스턴스에 사용할 수 있는 매개변수의 전체 목록은 Atlas Serverless Instances API(서버리스 인스턴스 API)를 참조하세요.

사양을 사용자 지정하려면 이러한 설명, 사용 가능한 예제 및 API 설명서를 참조하세요.

spec.backupRef

유형: 객체

옵션

적용할 AtlasBackupSchedule 사용자 지정 리소스 의 세부 정보가 포함된 목록입니다. 백업 일정은 cluster 1개씩 지정할 수 있습니다.

spec.backupRef.name

유형: 문자열

옵션

metadata.name 적용하려는 백업 일정에 대한 AtlasBackupSchedule 사용자 지정 리소스 내의 값입니다. 백업 일정은 cluster당 하나만 지정할 수 있지만 여러 cluster에 동일한 백업 일정을 사용할 수 있습니다.

이 매개변수를 생략하면 Atlas는 백업 구성을 이 cluster에 적용하지 않습니다.

spec.backupRef.namespace

유형: 문자열

옵션

적용할 백업 일정에 대한 AtlasBackupSchedule 사용자 지정 리소스 가 포함된 네임스페이스를 나타내는 문자열입니다.

spec.connectionSecret.name

유형: 문자열

조건부

Atlas Kubernetes Operator 가 Atlas 에 연결하는 데 사용하는 조직 ID 및 API 키가 포함된 불투명 시크릿 의 이름입니다. 지정되지 않은 경우 Atlas Kubernetes Operator 는 다음 중 하나로 대체됩니다.

• 상위 atlasProject의 spec.connectionSecretRef.name 매개 변수

• 기본값 global 시크릿(상위 atlasProject에 대해 spec.connectionSecretRef.name 이 정의되지 않은 경우)

이 매개변수는 독립적인 CRD의 경우 필수입니다.

Atlas Kubernetes Operator는 불필요한 시크릿 을 감시하지 atlas.mongodb.com/type=credentials 않기 위해 레이블이 있는 시크릿 만 감시합니다. .

다음 예시에서는 시크릿에 레이블을 지정합니다.

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

spec.deploymentSpec

유형: 배열

조건부

API 의 클러스터 매개변수가 포함된 목록입니다. 사용 가능한 매개변수의 전체 목록은 Atlas Clusters API(클러스터 API)를 참조하세요.

중요

구성에서 spec.deploymentSpec 또는 spec.serverlessSpec 을 지정해야 합니다.

spec.deploymentSpec.clusterType

유형: 문자열

조건부

생성할 cluster 유형을 식별하는 인간 판독 가능 레이블.

이 매개변수는 언제 사용해야 하나요?

조건	필요성
spec.deploymentSpec.replicationSpecs을(를) 설정하다 했습니다.	필수 사항
글로벌 클러스터를 배포 중입니다.	필수 사항
글로벌 외 복제본 세트 및 샤딩된 클러스터를 배포 중입니다.	옵션

Atlas는 다음 항목을 허용합니다.

값	클러스터 유형
복제본 세트	replicaSet
샤드	샤딩된 클러스터
지오샤드	글로벌 클러스터

spec.deploymentSpec.customZoneMapping

유형: 배열

필수 사항

구역을 지리적 리전에 매핑하는 글로벌 클러스터 매개변수가 포함된 목록입니다. 사용 가능한 매개변수의 전체 목록은 Atlas Global Clusters API(글로벌 클러스터 API)를 참조하세요.

spec.deploymentSpec.customZoneMapping.location

유형: 문자열

필수 사항

글로벌 클러스터의 구역에 매핑되는 위치를 나타내는 코드입니다.

spec.deploymentSpec.customZoneMapping.zone

유형: 문자열

필수 사항

글로벌 클러스터의 구역을 식별하는 사람이 읽을 수 있는 레이블입니다.

spec.deploymentSpec.diskSizeGB

유형: 숫자

옵션

호스트의 루트 볼륨을 나타내는 용량(단위: 기가바이트)입니다. 이 숫자를 늘려 용량을 추가할 수 있으며 가능한 최대값인 4096 (4TB)까지 사용할 수 있습니다. 이 값에는 양수를 지정해야 합니다.

로컬 NVMe SSD 가 있는 클러스터의 경우 이 값을 설정할 수 없습니다.

참고

어느 리전에서든 diskGB 에 대한 자동 확장을 활성화한 경우 이 옵션을 편집할 수 없습니다. 자세한 내용은 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled 를 참조하세요.

전용 클러스터의 최소 디스크 크기는 AWS 및 Google Cloud의 경우 10GB입니다. 이 설정에서 디스크 크기를 더 적게 지정하면 Atlas가 최소 디스크 크기 값을 기본값으로 설정합니다.

데이터베이스 배포에 Azure 노드가 포함된 경우 이 값은 기존 Azure 디스크 유형(8, 16, 32, 64, 128, 256, 512, 1024, 2048 또는 4096)에 해당해야 합니다.

Atlas는 기본값을 선택하는지, 아니면 사용자 지정 값을 선택하는지에 따라 스토리지 요금을 서로 다르게 계산합니다.

Atlas는 단일 복제본 세트에 대한 디스크 용량 제한이 있으며, 상위 클러스터 계층을 위해 최대 4 TB까지 확장할 수 있습니다. 총 클러스터 스토리지를 기본 제한 이상으로 확장하려면 프로젝트 설정 에서 확장 스토리지를 활성화할 수 있습니다. 향후 추가 확장을 수용하려면 장기적인 확장을 위해 샤딩 을 활성화하는 것이 좋습니다.

데이터베이스 배포가 여러 클라우드 서비스 제공자를 망라하는 경우, 이 값은 관련 제공자의 최소 기본값으로 기본 설정됩니다.

자세한 내용은 저장 용량을 참조하세요.

spec.deploymentSpec.encryptionAtRestProvider

유형: 문자열

옵션

이 cluster의 고객 키를 managed하는 Cloud 서비스 제공자입니다. 추가 암호화 계층을 제공하는 이 클러스터의 고객 관리형 키를 사용하여 미사용 데이터 암호화를 사용하려면 이 값을 설정해야 합니다. 자세한 내용은 KMS를 사용하여 데이터 암호화를 참조하세요.

Atlas는 다음 값을 허용합니다.

값	클라우드 제공자
AWS	Amazon Amazon Web Services
GCP	Google Cloud
AZURE	Microsoft Azure
none	제공자가 없습니다. 이 클러스터는 고객 관리형 키를 사용하여 데이터를 암호화하지 않습니다.

spec.deploymentSpec.managedNamespaces

유형: 배열

필수 사항

생성할 지정된 글로벌 클러스터 에 관리형 네임스페이스를 생성하기 위한 정보가 포함된 목록입니다. 사용 가능한 매개변수의 전체 목록은 Atlas Global Clusters API(글로벌 클러스터 API)를 참조하세요.

spec.deploymentSpec.managedNamespaces.collection

유형: 문자열

필수 사항

이 글로벌 클러스터에서 관리할 컬렉션의 사람이 읽을 수 있는 레이블입니다.

spec.deploymentSpec.managedNamespaces.db

유형: 문자열

필수 사항

이 글로벌 클러스터에서 관리 데이터베이스 의 사람이 읽을 수 있는 레이블입니다.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyHashed

유형: 부울

옵션

지정된 collection에 대한 사용자 지정 분할 키를 해시할지 여부를 나타내는 플래그입니다. 이 매개변수의 기본값은 false 입니다.

• collection에 대한 사용자 지정 샤드 키를 활성화하려면 true 로 설정합니다.

• 컬렉션에 대한 사용자 지정 샤드 키를 비활성화하려면 false 로 설정합니다. 비활성화된 경우 MongoDB는 범위 샤딩을 사용합니다.

자세한 내용은 해시된 샤드 키를 참조하세요.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

유형: 부울

옵션

지정된 컬렉션에 대한 사용자 지정 분할 키가 고유한지 여부를 나타내는 플래그입니다. 이 매개변수의 기본값은 false 입니다.

• collection에 대해 고유한 사용자 지정 샤드 키를 활성화하려면 true 로 설정합니다.

• collection에 대한 고유한 사용자 지정 샤드 키를 비활성화하려면 false 로 설정합니다.

spec.deploymentSpec.managedNamespaces.numInitialChunks

유형: integer

옵션

해시 샤드 키로 빈 컬렉션을 샤딩할 때 처음에 생성할 청크의 최소 개수입니다.

학습 내용 은 글로벌 컬렉션 샤딩을 참조하세요.

spec.deploymentSpec.managedNamespaces.presplitHashedZones

유형: 부울

옵션

MongoDB cloud가 비어 있거나 존재하지 않는 collection에 대해 초기 청크를 생성하고 배포해야 하는지 여부를 나타내는 플래그입니다. 이 매개변수의 기본값은 false 입니다.

• MongoDB cloud가 비어 있거나 존재하지 않는 collection에 대해 초기 청크를 생성하고 배포하도록 하려면 true 로 설정합니다.

• MongoDB cloud가 비어 있거나 존재하지 않는 collection에 대해 초기 청크를 생성하고 배포하지 못하게 하려면 false 로 설정합니다.

spec.deploymentSpec.mongoDBMajorVersion

유형: 문자열

옵션

배포할 클러스터의 버전입니다. Atlas는 M10+ cluster에 대해 다음 MongoDB 버전을 지원합니다.

• 5.0

• 6.0

• 7.0

다음 조건을 적용하면 다음과 같은 결과가 나타납니다.

조건	결과
이 매개변수를 생략하고 spec.deploymentSpec.versionReleaseSystem 매개변수를 생략합니다.	Atlas는 MongoDB 7.0을 실행하는 클러스터를 배포합니다.
이 매개변수를 생략하고 spec.deploymentSpec.versionReleaseSystem 매개변수를 LTS 으)로 설정합니다.	Atlas는 MongoDB 7.0을 실행하는 클러스터를 배포합니다.
spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize 매개 변수를 M0, M2 또는 M5 로 설정합니다.	MongoDB 7.0을 배포해야 합니다.
이 매개변수를 지정합니다.	Atlas는 항상 지정된 버전의 안정적인 최신 패치를 출시하여 클러스터를 배포합니다.
spec.deploymentSpec.versionReleaseSystem 매개 변수를 CONTINUOUS 으)로 설정합니다.	이 매개변수는 생략해야 합니다.

spec.deploymentSpec.pitEnabled

유형: 부울

조건부

지속적인 cloud 백업을 활성화하는 구성입니다. 연속 cloud 백업을 사용하려면 이 설정에 true 를 지정해야 합니다.

spec.deploymentSpec.replicationSpecs

유형: 객체 배열

조건부

클러스터 리전에 대한 구성이 포함된 목록입니다. 멀티 리전 클러스터에는 이 매개변수를 사용하세요. spec.deploymentSpec.replicationSpecs.regionConfigs.regionName 또는 spec.deploymentSpec.replicationSpecs 중 하나를 설정해야 합니다.

이 매개변수는 언제 사용해야 하나요?

조건	필요성	Values
글로벌 클러스터를 배포 중입니다.	필수 사항	이 배열의 각 객체는 Atlas가 클러스터의 노드를 배포하는 구역을 나타냅니다.
글로벌 외 복제본 세트 및 샤딩된 클러스터를 배포 중입니다.	옵션	이 배열에는 Atlas가 클러스터의 노드를 배포하는 위치를 나타내는 객체가 1개 있습니다.

이 매개변수를 지정하는 경우 spec.deploymentSpec.clusterType 및 spec.deploymentSpec.replicationSpecs.numShards 도 지정해야 합니다.

spec.deploymentSpec.replicationSpecs.numShards

유형: integer

조건부

샤딩된 클러스터에 대해 배포할 샤드의 수를 지정하는 양의 정수입니다.

spec.deploymentSpec.replicationSpecs 매개변수를 사용하는 경우 이 매개변수를 설정해야 합니다.

Atlas는 1 ~ 50 을(를) 허용합니다. 기본값은 1 입니다.

• 1 값을 지정하고 spec.deploymentSpec.clusterType 를 SHARDED 로 설정하다 하면 Atlas 는 단일 샤드 샤드 샤딩된 클러스터 를 배포합니다.

• 1 을(를) 설정하다 하고 spec.deploymentSpec.clusterType 를 REPLICASET(으)로 설정하면 Atlas 가 복제본 세트 를 배포합니다.

  프로덕션 환경에서는 단일 샤드로 샤딩된 클러스터를 생성하지 마세요. 단일 샤드로 샤딩된 클러스터는 다중 샤드 구성과 동일한 이점을 제공하지 않습니다.

  팁

  다음도 참조하세요.

  • 샤딩

  • 노드 수

경고

샤딩된 클러스터 를 사용하는 경우, MongoDB 는 애플리케이션이 샤드 mongos 샤딩된 클러스터 의 샤드 및 기타 구성 요소와 제대로 상호 작용 수 있도록 애플리케이션을 인스턴스 에 연결해야 합니다. 복제본 세트 에서 샤딩된 클러스터 마이그레이션 하는 경우, 클러스터의 에 연결할 활성화 애플리케이션을 다시 시작해야 mongos 합니다. 따라서 Atlas Admin API 는 복제본 세트 를 두 개 이상의 샤드 가 있는 샤드 샤딩된 클러스터 로 직접 마이그레이션할 수 없도록 합니다. 복제본 세트 를 단일 샤드 클러스터 로 성공적으로 마이그레이션 하고 애플리케이션 연결을 재설정한 후에는 클러스터 에 샤드를 추가할 수 있습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs

유형: 배열

필수 사항

특정 리전에 대해 설정된 노드의 hardware 사양입니다. 각 regionConfigs 객체는 투표에서 리전의 우선 순위와 Atlas가 해당 리전에 배포하는 MongoDB 노드의 수 및 유형을 설명합니다.

각 regionConfigs 객체에는 analyticsSpecs 객체, electableSpecs 객체 또는 readOnlySpecs 객체가 있어야 합니다.

• M0, M2 또는 M5 cluster에는 electableSpecs 만 필요합니다.

• 전용 클러스터는 이러한 사양 중 무엇이든 지정할 수 있지만 replicationSpec 내에 electableSpecs 객체가 하나 이상 있어야 합니다.

• 모든 hardware 사양은 동일한 instanceSize 을 사용해야 합니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.analyticsSpecs

유형: 객체

옵션

리전에 필요한 분석 노드 의 하드웨어 사양입니다. 분석 노드는 Atlas용 BI Connector의 보고 쿼리와 같은 분석 데이터를 처리합니다. 분석 노드는 읽기 전용이며 절대 프라이머리 노드가 될 수 없습니다.

이 매개변수를 지정하지 않으면 Atlas가 이 리전에 분석을 배포하지 않습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled

유형: 부울

옵션

이 데이터베이스 배포에서 디스크 자동 확장을 활성화할지 여부를 나타내는 플래그입니다. 이 매개변수의 기본값은 true 입니다.

• 디스크 자동 확장을 사용하려면 true 로 설정합니다.

• 디스크 자동 확장을 사용하지 않으려면 false 로 설정합니다.

선택한 클러스터 계층의 최대 RAM 용량과 oplog 크기로 인해 스토리지 자동 확장이 제한될 수 있습니다. 자세한 내용은 Customize Your Storage(스토리지 사용자 지정)를 참조하세요.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled

유형: 부울

옵션

인스턴스 크기 자동 확장 활성화 여부를 나타내는 플래그. 이 매개변수의 기본값은 false 입니다.

• 인스턴스 크기 자동 확장을 사용하려면 true 로 설정합니다. 활성화된 경우 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize 값을 지정해야 합니다.

• 인스턴스 크기 자동 확장을 비활성화하려면 false 로 설정합니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize

유형: 문자열

조건부

데이터베이스 배포가 자동으로 확장할 수 있는 최대 인스턴스 크기(예: M40)를 나타내는 string 입니다. spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled 을(를) true 으)로 설정한 경우 이 매개변수를 지정해야 합니다.

참고

자동 확장 기능이 활성화된 상태에서 최대 인스턴스 크기를 데이터베이스 배포의 현재 인스턴스 크기보다 작게 설정하면 Atlas가 현재 인스턴스 크기를 사용자가 지정한 최댓값으로 자동 확장합니다.

예를 들어, 데이터베이스 배포의 현재 인스턴스 크기가 M40 (이)고 최대 인스턴스 크기를 M30(으)로 설정하면 Atlas는 현재 인스턴스 크기를 M30 으)로 자동 확장합니다.

Atlas 가 현재 인스턴스 크기를 변경하고 사용자가 Atlas Kubernetes Operator 의 spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize 를 새 인스턴스 크기와 일치하도록 변경하지 않는 경우, Atlas Kubernetes Operator 는 로그에 경고를 표시하지만 자동 확장을 막지는 않습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize

유형: 문자열

조건부

데이터베이스 배포가 자동으로 확장할 수 있는 최소 인스턴스 크기(예: M10)를 나타내는 string 입니다. spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled 을(를) true 으)로 설정한 경우 이 매개변수를 지정해야 합니다.

참고

자동 확장 기능이 활성화된 상태에서 최소 인스턴스 크기를 데이터베이스 배포의 현재 인스턴스 크기보다 크게 설정하면 Atlas가 현재 인스턴스 크기를 사용자가 지정한 최솟값으로 자동 확장합니다.

예를 들어, 데이터베이스 배포의 현재 인스턴스 크기가 M10 (이)고 최소 인스턴스 크기를 M30(으)로 설정하면 Atlas는 현재 인스턴스 크기를 M30 으)로 자동 확장합니다.

Atlas 가 현재 인스턴스 크기를 변경하고 사용자가 Atlas Kubernetes Operator 의 spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize 를 새 인스턴스 크기와 일치하도록 변경하지 않는 경우, Atlas Kubernetes Operator 는 로그에 경고를 표시하지만 자동 확장을 막지는 않습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs

유형: 객체

옵션

리전의 투표 선택 가능 노드에 대한 하드웨어 사양입니다. 투표 선택 가능 노드는 프라이머리가 될 수 있으며 로컬 읽기를 활성화할 수 있습니다.

이 옵션을 지정하지 않으면 Atlas가 해당 리전에 투표 선택 가능 노드를 배포하지 않습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize

유형: 문자열

조건부

이 리전의 인스턴스 크기에 대한 하드웨어 사양입니다. 각 인스턴스 크기에는 기본 스토리지 및 메모리 용량이 있습니다. 선택한 인스턴스 크기는 해당 인스턴스 크기의 모든 데이터 보유 호스트에 적용됩니다. 자세한 내용은 Amazon Web Services, GCP 및 Azure 사용자 지정 스토리지 크기를 참조하세요.

샤드 클러스터 또는 글로벌 클러스터 를 배포하는 경우 인스턴스 크기를 M30 이상으로 선택해야 합니다.

클러스터를 배포한 후 인스턴스 크기 이름을 변경하는 경우, Atlas는 데이터베이스 배포가 자동 확장이 활성화된 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize 및 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize 에서 지정한 범위를 벗어나지 않는 한 데이터베이스 배포를 지정한 인스턴스 크기로 변경합니다. 자세한 내용은 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize 및 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize 를 참조하세요.

참고

컴퓨팅 필드에 대해 자동 확장을 활성화한 경우 이 옵션을 편집할 수 없습니다. 자세한 내용은 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled 를 참조하세요.

참고

이 설정을 변경하여 M0, M2, M5 또는 Flex 클러스터 를 M10+ 클러스터 로 업그레이드 할 수 있습니다. 그러나 M0, M2, M5`, or Flex cluster to another free or shared cluster. For example, you can't upgrade an ``M0 클러스터 를 Flex 클러스터 로 업그레이드 할 수는 없습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

유형: integer

조건부

Atlas가 해당 리전에 배포할 수 있는 투표 선택 가능 노드의 수입니다. 투표 선택 가능 노드는 프라이머리가 될 수 있으며 로컬 읽기를 활성화할 수 있습니다.

모든 replicationSpecs.regionConfigs 객체의 합계 electableSpecs.nodeCount 는 합계가 3, 5 또는 7 여야 합니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.priority 이 0 인 경우 투표 선택 가능 노드를 생성할 수 없습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.priority

유형: integer

필수 사항

일차 투표가 실시되면 이 리전에 우선권이 주어집니다.

regionConfigs 에 readOnlySpecs, analyticsSpecs 또는 둘 다 있는 경우 이 값을 0 로 설정합니다.

여러 개의 regionConfigs 객체가 있는 경우(cluster가 멀티 리전 또는 멀티 cloud인 경우) 우선 순위는 내림차순이어야 합니다. 가장 높은 우선순위는 7 입니다.

예시

최우선 순위 리전을 7 로 설정하고, 두 번째로 높은 우선 순위를 6 로, 세 번째 우선 순위 리전을 5 로 설정합니다. 투표 선택 가능 노드가 없는 경우 이 값을 0 으로 설정합니다.

해당 리전에서 electableSpecs.nodeCount 을 1 이상으로 설정한 경우, 이 리전이 프라이머리 리전이 아닌 한 우선 순위가 replicationSpecs.regionConfigs 배열의 다른 리전보다 정확히 한 단계 낮아야 합니다. 최우선 순위 리전의 우선 순위는 7 이어야 합니다 . 가능한 가장 낮은 우선순위는 1 입니다.

우선 순위 7 리전은 cluster의 기본 리전 을 식별합니다. Atlas는 프라이머리 노드를 Preferred Region 에 배치합니다. 1 부터 7 까지의 우선 순위는 배타적이며, cluster당 하나 이상의 리전에 지정된 우선 순위를 할당할 수 없습니다.

예시

리전이 세 개 있는 경우 해당 리전의 우선순위는 각각 7, 6 및 5 이 됩니다. 투표 선택 가능 노드를 지원하기 위해 리전을 두 개 더 추가하는 경우 해당 리전의 우선순위는 각각 4 및 3 가 됩니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.providerName

유형: 문자열

조건부

Atlas가 호스트를 프로비저닝하는 cloud 서비스 제공자입니다.

AWS	Amazon Amazon Web Services
GCP	Google Cloud Platform
AZURE	Microsoft Azure

spec.deploymentSpec.replicationSpecs.regionConfigs.regionName

유형: 문자열

조건부

MongoDB 클러스터의 물리적 위치입니다. 선택한 리전은 해당 데이터베이스에 액세스하는 클라이언트의 네트워크 지연 시간에 영향을 미칠 수 있습니다.

리전 이름 값의 전체 목록은 클라우드 제공자 참조 페이지를 참조하세요.

• AWS

• GCP

• Azure

멀티 리전 클러스터의 경우 spec.deploymentSpec.replicationSpecs 을(를) 참조하세요. spec.deploymentSpec.replicationSpecs.regionConfigs.regionName 또는 spec.deploymentSpec.replicationSpecs 중 하나를 설정해야 합니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

유형: 객체

옵션

리전의 읽기 전용 노드에 대한 하드웨어 사양입니다. 읽기 전용 노드는 절대로 프라이머리 노드가 될 수 없지만 로컬 읽기를 허용할 수 있습니다.

이 매개변수를 지정하지 않으면 Atlas가 이 리전에 읽기 전용 노드를 배포하지 않습니다.

spec.deploymentSpec.replicationSpecs.zoneName

유형: 문자열

옵션

Global Cluster(글로벌 클러스터) 의 구역을 식별하는 사람이 읽을 수 있는 레이블입니다. spec.deploymentSpec.clusterType 을 GEOSHARDED 로 설정한 경우에만 이 값을 제공합니다.

spec.deploymentSpec.searchIndexes

유형: 배열

옵션

Atlas Search 인덱스를 설명하는 필드가 있는 SearchIndex 객체의 배열입니다. 각 SearchIndex 객체에는 다음 필드가 포함되어 있습니다.

필드	유형	설명
name	문자열	이 인덱스를 식별하는 사람이 읽을 수 있는 레이블입니다. 배포에 대해 고유해야 합니다.
DBName	문자열	하나 이상의 Atlas Search 인덱스가 있는 컬렉션이 포함된 기존 데이터베이스를 식별하는 사람이 읽을 수 있는 레이블입니다. 중요: 지정하는 데이터베이스 가 이미 존재해야 합니다. 기존 데이터베이스 가 없는 경우 데이터베이스를 만듭니다.
collectionName	문자열	1개 이상의 Atlas Search 인덱스가 포함된 컬렉션을 식별하는 사람이 읽을 수 있는 라벨입니다.
type	문자열	인덱스의 유형입니다. Atlas에서 허용하는 값은 다음과 같습니다. search vectorSearch
search	객체	type 이 search 경우 이 객체를 포함해야 합니다. 그렇지 않으면 생략합니다.
vectorSearch	객체	type 이 vectorSearch 경우 이 객체를 포함해야 합니다. 그렇지 않으면 생략합니다.

spec.deploymentSpec.searchIndexes.search

유형: 객체

옵션

필드	유형	설명
synonyms	배열	단어를 이 인덱스의 동의어에 매핑하는 규칙 집합입니다.
mappings	객체	컬렉션 필드에 대한 인덱스 사양 필수 사항
searchConfigurationRef	객체	아래에 설명된 AtlasSearchIndexConfig 사용자 지정 리소스에 대한 이름/네임스페이스 참조입니다. 필수 사항

spec.deploymentSpec.searchIndexes.search.synonyms

유형: 배열

옵션

단어를 이 인덱스의 동의어에 매핑하는 규칙 집합을 설명하는 필드가 있는 Synonym 객체의 배열입니다. 각 Synonym 객체에는 다음 필드가 포함되어 있습니다.

필드	유형	설명
name	문자열	동의어 정의를 식별하는 사람이 읽을 수 있는 레이블입니다. 각 이름은 동일한 인덱스 정의 내에서 고유해야 합니다. 필수 사항
analyzer	문자열	검색할 동의어에 적용하기 위해 선택한 사전 정의된 특정 메서드입니다. 가능한 값은 다음과 같습니다. lucene.standard lucene.standard lucene.simple lucene.whitespace lucene.keyword lucene.arabic lucene.armenian lucene.basque lucene.bengali lucene.brazilian lucene.bulgarian lucene.catalan lucene.chinese lucene.cjk lucene.czech lucene.danish lucene.dutch lucene.english lucene.finnish lucene.french lucene.galician lucene.german lucene.greek lucene.hindi lucene.hungarian lucene.indonesian lucene.irish lucene.italian lucene.japanese lucene.korean lucene.kuromoji lucene.latvian lucene.lithuanian lucene.morfologik lucene.nori lucene.norwegian lucene.persian lucene.portuguese lucene.romanian lucene.russian lucene.smartcn lucene.sorani lucene.spanish lucene.swedish lucene.thai lucene.turkish lucene.ukrainian 필수 사항
source	객체	하나 이상의 단어가 해당 단어의 하나 이상의 동의어에 매핑되는 매핑을 저장하는 데이터 세트입니다. 필수 사항

spec.deploymentSpec.searchIndexes.search.synonyms.source

유형: 객체

필수 사항

필드	유형	설명
collection	문자열	단어와 해당 동의어를 저장하는 MongoDB 컬렉션을 식별하는 사람이 읽을 수 있는 레이블입니다. 필수 사항

spec.deploymentSpec.searchIndexes.search.mappings

유형: 객체

필수 사항

컬렉션 필드에 대한 인덱스 사양이 있는 객체입니다.

dynamic	부울	인덱스가 동적 매핑을 사용하는지 정적 매핑을 사용하는지 여부를 나타내는 플래그입니다. mappings.fields가 생략된 경우 필수입니다.
fields	JSON/YAML	Atlas Search 인덱스에 대한 하나 이상의 필드 사양입니다. mappings.dynamic이 생략되거나 false로 설정된 경우 필수입니다.

spec.deploymentSpec.searchIndexes.vectorSearch

유형: 객체

옵션

필드	유형	설명
fields	JSON/YAML	JSON 객체의 배열입니다. https://dochub.mongodb.org/core/avs-vector-type예시 참조 필수 사항

spec.deploymentSpec.searchNodes

유형: 배열

옵션

Atlas Search 노드 구성의 배열입니다. 각 요소에는 두 개의 필드가 포함되어 있습니다.

필드	유형	설명
nodeCount	integer	클러스터에 있는 Atlas Search 노드의 수입니다. Atlas는 2 부터 32 까지의 값을 허용합니다. 기본 숫자는 2 입니다.
instanceSize	문자열	Atlas Search 노드 인스턴스 크기에 대한 하드웨어 사양입니다. Atlas는 다음 중 하나를 허용합니다. S20_HIGHCPU_NVME S30_HIGHCPU_NVME S40_HIGHCPU_NVME S50_HIGHCPU_NVME S60_HIGHCPU_NVME S70_HIGHCPU_NVME S80_HIGHCPU_NVME S30_LOWCPU_NVME S40_LOWCPU_NVME S50_LOWCPU_NVME S60_LOWCPU_NVME S80_LOWCPU_NVME S90_LOWCPU_NVME S100_LOWCPU_NVME 기본 인스턴스 크기는 S20_HIGHCPU_NVME 입니다.

spec.deploymentSpec.tags

유형: 배열

옵션

데이터베이스 배포를 더 잘 이해하고, 정리하고, 식별하기 위한 태그 (키-값 쌍)가 포함된 목록입니다. 자세한 내용 은 클러스터에 대한 태그 지정을 참조하세요.

spec.deploymentSpec.versionReleaseSystem

유형: 문자열

조건부

Atlas가 이 클러스터에 사용할 릴리스 주기입니다. Atlas는 다음 항목을 허용합니다.

• CONTINUOUS: Atlas는 가장 최근의 MongoDB 릴리스를 사용하여 cluster를 생성합니다. Atlas는 MongoDB의 주요 주요 릴리스와 빠른 릴리스가 출시되면 자동으로 cluster를 업데이트합니다.

• LTS: Atlas는 spec.deploymentSpec.mongoDBMajorVersion 매개변수에 지정한 MongoDB 버전의 최신 패치 릴리스를 사용하여 클러스터를 생성합니다. Atlas는 이 MongoDB 버전의 후속 패치 릴리스로 클러스터를 자동으로 업데이트합니다. Atlas는 빠른 최신 또는 주요 MongoDB 릴리스가 출시되더라도 해당 릴리스로 클러스터를 업데이트하지 않습니다.

  생략하는 경우 기본값은 LTS입니다.

  이 매개변수를 CONTINUOUS 로 설정하는 경우 spec.deploymentSpec.mongoDBMajorVersion 매개변수를 생략해야 합니다.

spec.externalProjectRef.id

유형: 문자열

조건부

배포서버 가 속한 프로젝트 의 ID 입니다. 기존 Atlas 프로젝트의 프로젝트 ID 를 지정해야 합니다. 이 매개변수는 다음 중 하나에서 managed 되는 프로젝트에 속한 배포에 필요합니다.

• Atlas Kubernetes Operator 의 다른 인스턴스

• Atlas Kubernetes Operator 이외의 도구

Atlas Kubernetes Operator 의 동일한 인스턴스 에서 managed 하는 프로젝트에 속한 배포서버의 경우 spec.externalProjectRef.id을(를) 사용하지 않는 경우 spec.projectRef.name 을(를) 사용하세요.

spec.processArgs

유형: 객체

옵션

클러스터 에 대한 추가 구성 옵션 이 포함된 객체입니다.

spec.processArgs.defaultReadConcern

유형: 문자열

옵션

이 클러스터 에string 대해 설정하다 MongoDB 읽기 작업에 대해 에서 요청한 기본값 승인 수준 을 나타내는 입니다.

MongoDB 5.0 클러스터는 기본적으로 로컬로 설정됩니다.

spec.processArgs.defaultWriteConcern

유형: 문자열

옵션

이 클러스터에 대해 MongoDB string 설정된 쓰기 작업에 대해 에서 요청한 기본 승인 수준 을 나타내는 입니다.

MongoDB 버전 5.0 이상 클러스터는 기본적으로 과반수로 설정됩니다.

spec.processArgs.failIndexKeyTooLong

유형: 부울

옵션

인덱싱된 모든 항목이 1024 바이트를 초과하는 문서를 삽입하거나 업데이트할 때 작업을 실패하고 오류를 반환할지 여부를 나타내는 플래그입니다. 이 값을 false 로 설정하면 mongod 가 이 제한을 초과하는 문서를 작성하지만 인덱싱 하지는 않습니다 .

이 옵션은 param.failIndexKeyTooLong mongod 매개변수에 해당합니다.

spec.processArgs.javascriptEnabled

유형: 부울

옵션

클러스터가 서버 측 JavaScript 실행을 수행하는 작업의 실행을 허용하는지 여부를 나타내는 플래그입니다.

• 이 옵션은 클러스터의 mongos security.javascriptEnabled 각 및 mongod 에 대한 구성 파일 옵션을 수정하는 것에 해당합니다.

spec.processArgs.minimumEnabledTlsProtocol

유형: integer

옵션

이 클러스터가 수신 연결에 대해 허용하는 최소 TLS 버전을 나타내는 문자열입니다. TLS 1.0 또는 1.1을 사용하는 클러스터에서는 TLS 1.2를 최소 TLS 프로토콜 버전으로 설정하는 것이 좋습니다.

자세한 내용 은 Atlas가 지원하는 TLS 버전은 무엇인가요?를 참조하세요.

이 옵션은 net.ssl.disabledProtocols mongod 구성 파일 옵션에 해당합니다.

spec.processArgs.noTableScan

유형: 부울

옵션

클러스터가 결과 반환 시 컬렉션 스캔을 요하는 쿼리의 실행을 비활성화할지 여부를 나타내는 플래그입니다.

이 옵션은 notablescan mongod 매개변수에 해당합니다.

spec.processArgs.oplogSizeMB

유형: integer

옵션

메가바이트 단위로 표현된 cluster oplog의 저장 용량 한도를 나타내는 숫자입니다. null 값은 cluster가 Atlas가 계산하는 기본 oplog 크기를 사용함을 나타냅니다.

이 옵션은 replication.oplogSizeMB mongod 구성 파일 옵션에 해당합니다.

spec.processArgs.sampleRefreshIntervalBIConnector

유형: integer

옵션

스키마 정보 수집 시 샘플링할 데이터베이스당 문서를 나타내는 숫자입니다.

이 매개변수는 sampleSize mongosqld 옵션에 해당합니다.

spec.processArgs.sampleSizeBIConnector

유형: integer

옵션

mongosqld 프로세스 가 데이터를 다시 샘플링하여 관계형 스키마를 생성하는 간격(초)을 나타내는 숫자입니다.

이 매개변수는 sampleRefreshIntervalSecs mongosqld 옵션에 해당합니다.

spec.projectRef.name

유형: 문자열

조건부

배포서버 가 속한 프로젝트 의 이름입니다. 기존 AtlasProject Custom Resource(사용자 지정 리소스)를 지정해야 합니다. 이 매개변수는 동일한 인스턴스 Atlas Kubernetes Operator 에서 managed 하는 프로젝트에 속한 배포서버에만 적용됩니다.

다음 중 하나에서 managed 되는 프로젝트에 속한 배포의 경우:

• Atlas Kubernetes Operator 의 다른 인스턴스

• Atlas Kubernetes Operator 이외의 도구

spec.externalProjectRef.name 을(를) 사용하세요.

spec.serverlessSpec

유형: 배열

조건부

API 의 서버리스 인스턴스 매개변수가 포함된 목록입니다. 사용 가능한 매개변수의 전체 목록은 Atlas Serverless Instances API(서버리스 인스턴스 API)를 참조하세요.

중요

구성에서 spec.deploymentSpec 또는 spec.serverlessSpec 을 지정해야 합니다.

spec.serverlessSpec.privateEndpoints

유형: 배열

옵션

서버리스 인스턴스 에 대한 비공개 엔드포인트 구성이 포함된 목록입니다.

spec.serverlessSpec.providerSettings

유형: 객체

조건부

MongoDB 가 실행되는 프로비저닝된 호스트에 대한 설정을 지정하는 구성입니다. 사용 가능한 옵션은 cloud 서비스 제공자 에 따라 다릅니다.학습 내용은 AWS, GCP 및 Azure 서버리스 인스턴스 구성 옵션을 참조하세요.

서버리스 인스턴스 를 만들거나 업데이트 하려면 이 설정을 지정해야 합니다.

중요

다음 설정은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

• spec.serverlessSpec.providerSettings.DiskIOPS

• spec.serverlessSpec.providerSettings.DiskTypeName

• spec.serverlessSpec.providerSettings.EncryptEBSVolume

• spec.serverlessSpec.providerSettings.InstanceSizeName

• spec.serverlessSpec.providerSettings.VolumeType

• spec.serverlessSpec.providerSettings.AutoScaling

이러한 설정에 대한 값을 제공해도 아무런 효과가 없습니다.

spec.serverlessSpec.providerSettings.providerName

유형: 문자열

조건부

Atlas 가 서버리스 인스턴스 에 대해 호스팅하다 를 프로비저닝하는 클라우드 서비스 제공자 입니다.

Atlas는 다음 값을 허용합니다.

AWS	Amazon Amazon Web Services
GCP	Google Cloud Platform
AZURE	Microsoft Azure

spec.serverlessSpec.providerSettings.regionName

유형: 문자열

조건부

MongoDB Serverless 인스턴스 의 물리적 위치 입니다. 선택하는 리전 은 데이터베이스에 액세스하는 클라이언트의 네트워크 지연 시간 에 영향을 줄 수 있습니다.

리전 이름 값의 전체 목록은 클라우드 제공자 참조 페이지를 참조하세요.

• AWS

• GCP

• Azure

spec.serverlessSpec.tags

유형: 배열

옵션

데이터베이스 배포를 더 잘 이해하고, 정리하고, 식별하기 위한 태그 (키-값 쌍)가 포함된 목록입니다. 자세한 내용 은 클러스터에 대한 태그 지정을 참조하세요.

status.connectionStrings

유형: 배열

필수 사항

클러스터에 액세스하기 위한 연결 URL이 포함된 목록입니다. 이 매개변수는 클러스터를 생성하거나 업데이트한 후에 나타납니다.

참고

연결 URL은 직접 사용할 수 없습니다. Atlas 클러스터에는 인증이 필요합니다. Kubernetes 클러스터의 애플리케이션이 Atlas 클러스터에 연결하려면 먼저 AtlasDatabaseUser 사용자 지정 리소스 를 하나 이상 생성해야 합니다. Atlas Kubernetes Operator가 생성하는 특별한 시크릿 프로젝트의 각 클러스터 및 데이터베이스 사용자 조합에 대해 Kubernetes 클러스터의 애플리케이션은 이 시크릿 을 사용할 수 있습니다. Atlas cluster에 연결합니다. AtlasDatabaseUser 사용자 지정 리소스의 spec.scopes 매개 변수는 데이터베이스 사용자를 생성하는 클러스터를 제한합니다.

API 에서 클러스터에 사용할 수 있는 구성 매개변수는 Atlas 클러스터 API 를 참조하세요.