AtlasDeployment 사용자 지정 리소스

Flex 클러스터로 마이그레이션

Atlas Kubernetes Operator 2.0의 단절적 변경 사항

AtlasDeployment 사용자 지정 리소스 정보

AtlasDeployment 사용자 지정 리소스 Atlas 에서 MongoDB cluster 또는 Flex 클러스터 구성합니다. AtlasDeployment 사용자 지정 리소스 만들면 Atlas Kubernetes Operator Atlas 에서 클러스터 또는 Flex 클러스터 만들거나 업데이트 하려고 시도합니다.

Atlas Kubernetes Operator는 AtlasDeployment 사용자 지정 리소스에 지정한 값에 따라 다음 조치 중 하나를 수행합니다.

• If you specify values for fields under spec.deploymentSpec, Atlas Kubernetes Operator uses the Atlas Clusters API Resource to create a new cluster or update an existing cluster.

• If you specify values for fields under spec.flexSpec, Atlas Kubernetes Operator uses the Atlas Flex Instance API Resource to create a new Flex cluster or update an existing Flex cluster.

무료 클러스터를 만드는 데 15 초도 걸리지 않습니다.

Flex 클러스터 또는 전용 클러스터 만들거나 업데이트하는 데 최대 10 분이 걸릴 수 있습니다. Atlas Kubernetes Operator 업데이트 프로세스를 모니터합니다.

다음 명령을 실행하여 상태를 확인할 수 있습니다.

kubectl get atlasdeployment -o yaml

다음 예시에서는 프로비저닝 중인 클러스터의 상태 섹션을 보여줍니다.

status:
  conditions:
  - lastTransitionTime: "2024-03-18T16:32:43Z"
    status: "False"
    type: ClusterReady
    reason: ClusterCreating
    message: Cluster is provisioning

클러스터 또는 서버리스 인스턴스 준비되면 ClusterReady 상태가 True 로 변경됩니다.

예시

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: "2024-03-18T16:32:43Z"
    status: "True"
    type: Ready
  - lastTransitionTime: "2024-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: "2024-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: my-project
  flexSpec:
    name: flex-cluster
    tags:
      - key: "environment"
        value: "production"
    providerSettings:
      backingProviderName: AWS
      regionName: US_EAST_1

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 사용자 지정 리소스 매개변수 몇 가지에 대해 설명합니다.

• For a full list of available parameters for clusters, see the Atlas Clusters API.

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

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

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

spec.backupRef

유형: 객체

옵션

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

spec.backupRef.name

유형: 문자열

옵션

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

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

spec.backupRef.namespace

유형: 문자열

옵션

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

spec.configServerManagementMode

유형: 문자열

옵션

기본값: ATLAS_MANAGED

샤딩된 클러스터 생성하거나 업데이트하기 위한 서버 관리 모드를 정의하는 구성입니다. 가능한 값은 다음과 같습니다.

• ATLAS_MANAGED: Atlas 최적의 성능과 비용 절감을 위해 클러스터의 config 서버 유형을 자동으로 전환할 수 있습니다.

• FIXED_TO_DEDICATED: 클러스터 항상 전용 config 서버 사용합니다.

MongoDB 샤드 클러스터 구성 서버에 대해 자세히 보기.

spec.connectionSecret.name

유형: 문자열

조건부

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

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

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

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

spec.deploymentSpec

유형: 배열

조건부

List that contains the cluster parameters from the API. For a full list of available parameters, see the Atlas Clusters API.

중요

You must specify spec.deploymentSpec or spec.flexSpec in your configuration.

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

spec.deploymentSpec.name

유형: 문자열

조건부

클러스터 의 이름을 식별하는 문자열입니다. 이름에는 문자, 숫자, 대시만 포함되어야 하며 배포서버 생성 후에는 수정할 수 없습니다.

spec.deploymentSpec.clusterType

유형: 문자열

조건부

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

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

조건	필요성
You set spec.deploymentSpec.replicationSpecs.	필수 사항
You are deploying Global Clusters.	필수 사항
글로벌 외 복제본 세트 및 샤딩된 클러스터를 배포 중입니다.	옵션

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

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

spec.deploymentSpec.customZoneMapping

유형: 배열

필수 사항

List that contains Global Cluster parameters that map zones to geographic regions. For a full list of available parameters, see the Atlas Global Clusters API.

spec.deploymentSpec.customZoneMapping.location

유형: 문자열

필수 사항

Code that represents a location that maps to a zone in your Global Cluster.

spec.deploymentSpec.customZoneMapping.zone

유형: 문자열

필수 사항

Human-readable label that identifies the zone in your Global Cluster.

spec.deploymentSpec.diskSizeGB

유형: 숫자

옵션

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

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

참고

If you enable auto-scaling for diskGB in any region, you can't edit this option. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabled.

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

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

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

Atlas has disk capacity limits on single replica sets, scaling up to 4 TB for higher cluster tiers. To expand the total cluster storage beyond default limits, you can enable extended storage in the Project Settings. To accommodate further scaling in the future, we recommend that you enable sharding for long-term expansion.

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

To learn more, see Storage Capacity.

spec.deploymentSpec.encryptionAtRestProvider

유형: 문자열

옵션

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

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

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

spec.deploymentSpec.managedNamespaces

유형: 배열

필수 사항

List that contains information to create a managed namespace in a specified Global Cluster to create. For a full list of available parameters, see the Atlas Global Clusters API.

spec.deploymentSpec.managedNamespaces.collection

유형: 문자열

필수 사항

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

spec.deploymentSpec.managedNamespaces.db

유형: 문자열

필수 사항

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

spec.deploymentSpec.managedNamespaces.isCustomShardKeyHashed

유형: 부울

옵션

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

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

• Set to false to disable a custom shard key for the collection. If diabled, MongoDB uses ranged sharding.

To learn more, see Hashed Shard Keys.

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

유형: 부울

옵션

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

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

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

spec.deploymentSpec.managedNamespaces.numInitialChunks

유형: integer

옵션

Minimum number of chunks to initially create when sharding an empty collection with a hashed shard key.

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

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

• 8.0

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

조건	결과
You omit this parameter and you omit the spec.deploymentSpec.versionReleaseSystem parameter.	Atlas는 MongoDB 7.0을 실행하는 클러스터를 배포합니다.
You omit this parameter and you set the spec.deploymentSpec.versionReleaseSystem parameter to LTS.	Atlas는 MongoDB 7.0을 실행하는 클러스터를 배포합니다.
Atlas deprecated M2 and M5 clusters and Serverless instances. To learn more, see Migration to Flex Clusters. Set the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize parameter to M0, M2, or M5.	MongoDB 7.0 이상을 배포 해야 합니다.
이 매개변수를 지정합니다.	Atlas는 항상 지정된 버전의 안정적인 최신 패치를 출시하여 클러스터를 배포합니다.
You set the spec.deploymentSpec.versionReleaseSystem parameter to CONTINUOUS.	이 매개변수는 생략해야 합니다.

spec.deploymentSpec.pitEnabled

유형: 부울

조건부

참고

Atlas M2 및 M5 클러스터와 서버리스 인스턴스를 더 이상 사용하지 않습니다. Atlas 모든 M2 및 M5 클러스터를 Flex 클러스터로 마이그레이션했습니다. 서버리스 인스턴스의 경우, Atlas 사용량에 따라 인스턴스를 무료 클러스터, Flex 클러스터 또는 전용 클러스터로 마이그레이션합니다.

일정 기간 동안 API의 이전 버전과의 호환성을 유지하기 위해, Atlas Atlas Kubernetes Operator 사용할 때를 포함하여 이러한 마이그레이션된 클러스터를 동일한 API(이전 API 및 새 API)를 통해 managed 할 수 있도록 계속 허용합니다. API의 이전 버전과의 호환성은 2026 1월까지 유지되며, 이 때 이전 API는 제거되고 Flex 클러스터와 관련된 API만 유지됩니다.

서버리스 인스턴스의 비공개 엔드포인트에 대한 지원이 2025 3월에 종료되었습니다. 비공개 엔드포인트 제거 하려면 2025 3월까지 Atlas Kubernetes Operator 구성을 업데이트 해야 합니다. 2026 1월 이전에 Atlas Kubernetes Operator 구성에서 나머지 M2, M5 및 서버 인스턴스 기능을 모두 제거 해야 합니다.

If your workloads require Private Endpoints or Continuous Backup, switch to Atlas Dedicated Clusters. To learn more, see Migration to Flex Clusters and the Atlas Flex Migration Guide.

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

spec.deploymentSpec.replicationSpecs

유형: 객체 배열

조건부

List that contains the configurations for your cluster regions. Use this parameter for multi-region clusters. You must set either spec.deploymentSpec.replicationSpecs.regionConfigs.regionName or spec.deploymentSpec.replicationSpecs.

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

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

If you specify this parameter, you must also specify spec.deploymentSpec.clusterType and spec.deploymentSpec.replicationSpecs.numShards.

spec.deploymentSpec.replicationSpecs.numShards

유형: integer

조건부

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

If you use the spec.deploymentSpec.replicationSpecs parameter, you must set this parameter.

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

• If you specify a value of 1 and you set spec.deploymentSpec.clusterType to SHARDED, Atlas deploys a single-shard sharded cluster.

• If you specify 1 and you set spec.deploymentSpec.clusterType to REPLICASET, Atlas deploys a replica set.

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

  팁

  • 샤딩

  • 노드 수

경고

When you use a sharded cluster, MongoDB requires that your applications connect to a mongos instance to ensure that your applications interact with the shards and other components of the sharded cluster properly. If you migrate from a replica set to a sharded cluster, your applications must restart to enable the connection to the cluster's mongos. As a result, the Atlas Admin API prevents you from migrating a replica set directly to a sharded cluster with more than one shard. After you successfully migrate your replica set to a single shard cluster and reset your application connections, you can add additional shards to the cluster.

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

유형: 객체

옵션

Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary.

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

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

유형: 부울

옵션

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

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

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

The maximum amount of RAM for the selected cluster tier and the oplog size can limit storage auto-scaling. To learn more, see Customize Your Storage.

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

유형: 부울

옵션

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

• Set to true to enable instance size auto-caling. If enabled, you must specify a value for spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

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

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

유형: 문자열

조건부

String that indicates the maximum instance size to which your database deployment can automatically scale (such as M40). You must specify this parameter if you set spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled to true.

참고

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

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

If Atlas changes the current instance size and you don't change the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize in Atlas Kubernetes Operator to match the new instance size, Atlas Kubernetes Operator displays a warning in the logs but doesn't prevent auto-scaling.

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

유형: 문자열

조건부

String that indicates the minimum instance size to which your database deployment can automatically scale (such as M10). You must specify this parameter if you set spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled to true.

참고

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

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

If Atlas changes the current instance size and you don't change the spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize in Atlas Kubernetes Operator to match the new instance size, Atlas Kubernetes Operator displays a warning in the logs but doesn't prevent auto-scaling.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs

유형: 객체

옵션

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

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

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize

유형: 문자열

조건부

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

If you deploy a sharded cluster, or global cluster, you must choose an instance size of M30 or greater.

If you change the instance size name after you deploy your cluster, Atlas changes the database deployment to the instance size you specify unless it falls outside the range you specify in spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize and spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize with auto-scaling enabled. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.minInstanceSize and spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSize.

참고

If you have auto-scaling enabled for the compute field, you can't edit this option. To learn more, see spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.enabled.

참고

이 설정을 변경하여 M0 또는 Flex 클러스터 M10+ 클러스터 로 업그레이드 수 있습니다. 그러나 이 설정을 사용하여 M0 또는 Flex 클러스터 다른 무료 또는 Flex 클러스터 로 업그레이드 수는 없습니다.

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

유형: integer

조건부

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

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

You can't create electable nodes if spec.deploymentSpec.replicationSpecs.regionConfigs.priority is 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

For multi-region clusters, see spec.deploymentSpec.replicationSpecs. You must set either spec.deploymentSpec.replicationSpecs.regionConfigs.regionName or spec.deploymentSpec.replicationSpecs.

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

유형: 객체

옵션

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

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

spec.deploymentSpec.replicationSpecs.zoneName

유형: 문자열

옵션

Human-readable label that identifies the zone in a Global Cluster. Provide this value only if you set spec.deploymentSpec.clusterType to 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.terminationProtectionEnabled

유형: 부울

클러스터 에 대해 종료 방지 기능이 활성화되었는지 또는 비활성화되었는지 여부를 나타냅니다. true로 설정하다 하면 Atlas 클러스터 삭제 하지 않습니다. false로 설정하다 하면 Atlas 클러스터 삭제 . 기본값 false입니다.

spec.deploymentSpec.versionReleaseSystem

유형: 문자열

조건부

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

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

• LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the spec.deploymentSpec.mongoDBMajorVersion parameter. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.

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

  If you set this parameter to CONTINUOUS, you must omit the spec.deploymentSpec.mongoDBMajorVersion parameter.

spec.externalProjectRef.id

유형: 문자열

조건부

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

• Atlas Kubernetes Operator 의 다른 인스턴스

• Atlas Kubernetes Operator 이외의 도구

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

spec.flexSpec

유형: 배열

조건부

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

List that contains the Flex cluster parameters from the API. For a full list of available parameters, see the Atlas Flex Clusters API.

중요

You must specify spec.deploymentSpec or spec.flexSpec in your configuration.

spec.flexSpec.name

유형: 문자열

Flex 클러스터 의 이름을 식별하는 문자열입니다.

spec.flexSpec.tags

유형: 배열

옵션

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

spec.flexSpec.terminationProtectionEnabled

유형: 부울

Flex 클러스터 에 대해 종료 방지 기능이 활성화되어 있는지 또는 비활성화되어 있는지를 나타냅니다. true로 설정하다 하면 Atlas 클러스터 삭제 하지 않습니다. false로 설정하다 하면 Atlas 클러스터 삭제 . 기본값 false입니다.

spec.flexSpec.providerSettings.backingProviderName

유형: 문자열

Flex 클러스터 에 대한 cloud 제공자 의 이름입니다. providerSettings 에는 MongoDB 실행되는 프로비저닝된 호스트에 대한 설정을 지정하는 구성이 포함됩니다.

Atlas 다음 값 중 하나를 허용합니다.

• AWS

• AZURE

• GCP

spec.flexSpec.providerSettings.regionName

유형: 문자열

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

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

• AWS

• GCP

• Azure

spec.processArgs

유형: 객체

옵션

Object that contains the additional configuration options for your cluster.

spec.processArgs.defaultReadConcern

유형: 문자열

옵션

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

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

spec.processArgs.defaultWriteConcern

유형: 문자열

옵션

String that indicates the default level of acknowledgment requested from MongoDB for write operations set for this cluster.

MongoDB versions 5.0 and later clusters default to majority.

spec.processArgs.failIndexKeyTooLong

유형: 부울

옵션

Flag that indicates whether to fail the operation and return an error when you insert or update documents where all indexed entries exceed 1024 bytes. If you set this to false, mongod writes documents that exceed this limit, but doesn't index them.

This option corresponds to the param.failIndexKeyTooLong mongod parameter.

spec.processArgs.javascriptEnabled

유형: 부울

옵션

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

• This option corresponds to modifying the security.javascriptEnabled configuration file option for each mongod and mongos in the cluster.

spec.processArgs.minimumEnabledTlsProtocol

유형: integer

옵션

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

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

This option corresponds to the net.ssl.disabledProtocols mongod configuration file option.

spec.processArgs.noTableScan

유형: 부울

옵션

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

This option corresponds to the notablescan mongod parameter.

spec.processArgs.oplogSizeMB

유형: integer

옵션

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

This option corresponds to the replication.oplogSizeMB mongod configuration file option.

spec.processArgs.sampleRefreshIntervalBIConnector

유형: integer

옵션

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

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

spec.processArgs.sampleSizeBIConnector

유형: integer

옵션

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

This parameter corresponds to the sampleRefreshIntervalSecs mongosqld option.

spec.projectRef.name

유형: 문자열

조건부

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

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

• Atlas Kubernetes Operator 의 다른 인스턴스

• Atlas Kubernetes Operator 이외의 도구

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

spec.serverlessSpec

유형: 배열

조건부

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

API의 서버리스 인스턴스 매개변수가 포함된 목록입니다. 사용 가능한 매개변수의 전체 목록은 Atlas Flex 클러스터 API참조하세요.

중요

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

spec.upgradeToDedicated

유형: 부울

옵션

true로 설정하다 Flex 클러스터 에서 전용 클러스터 로 현재 위치 업그레이드 트리거하는 플래그입니다.

생략하면 기본값은 false입니다. 마이그레이션 프로세스 에 대한 전체 연습은 Flex 클러스터 전용 클러스터 로 마이그레이션을 참조하세요.

중요

또한 spec.deploymentSpec 차단 에 대상 전용 클러스터 에 대한 전체 구성을 제공해야 합니다. 이 작업은 단방향이며 되돌릴 수 없습니다.

spec.serverlessSpec.privateEndpoints

유형: 배열

옵션

참고

Atlas M2 및 M5 클러스터와 서버리스 인스턴스를 더 이상 사용하지 않습니다. Atlas 모든 M2 및 M5 클러스터를 Flex 클러스터로 마이그레이션했습니다. 서버리스 인스턴스의 경우, Atlas 사용량에 따라 인스턴스를 무료 클러스터, Flex 클러스터 또는 전용 클러스터로 마이그레이션합니다.

일정 기간 동안 API의 이전 버전과의 호환성을 유지하기 위해, Atlas Atlas Kubernetes Operator 사용할 때를 포함하여 이러한 마이그레이션된 클러스터를 동일한 API(이전 API 및 새 API)를 통해 managed 할 수 있도록 계속 허용합니다. API의 이전 버전과의 호환성은 2026 1월까지 유지되며, 이 때 이전 API는 제거되고 Flex 클러스터와 관련된 API만 유지됩니다.

서버리스 인스턴스의 비공개 엔드포인트에 대한 지원이 2025 3월에 종료되었습니다. 비공개 엔드포인트 제거 하려면 2025 3월까지 Atlas Kubernetes Operator 구성을 업데이트 해야 합니다. 2026 1월 이전에 Atlas Kubernetes Operator 구성에서 나머지 M2, M5 및 서버 인스턴스 기능을 모두 제거 해야 합니다.

If your workloads require Private Endpoints or Continuous Backup, switch to Atlas Dedicated Clusters. To learn more, see Migration to Flex Clusters and the Atlas Flex Migration Guide.

더 이상 사용되지 않습니다. 이 매개변수가 있는 경우 제거합니다. 서버리스 인스턴스 에 대한 비공개 엔드포인트 구성이 포함된 목록입니다.

spec.serverlessSpec.providerSettings

유형: 객체

조건부

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

MongoDB 실행되는 프로비저닝된 호스트에 대한 설정을 지정하는 구성입니다. 사용 가능한 옵션은 cloud 서비스 제공자 에 따라 다릅니다. 자세히 학습 Amazon Web Services, 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

유형: 문자열

조건부

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

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

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

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

spec.serverlessSpec.providerSettings.regionName

유형: 문자열

조건부

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항 을 참조하세요.

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

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

• AWS

• GCP

• Azure

spec.serverlessSpec.tags

참고

변경 사항에 대한 전체 정보는 Flex 클러스터로 전환에 대한 참고 사항을 참조하세요.

유형: 배열

옵션

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

status.connectionStrings

유형: 배열

필수 사항

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

참고

.. include:: /includes/fact-ak8so-connection-strings.rst

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