AtlasDeployment カスタム リソース

フレキシブルなクラスターへの移行

Atlas Kubernetes演算子 2.0 による重大な変更

AtlasDeployment カスタム リソースについて

AtlasDeployment カスタムリソースは、 Atlas のMongoDBクラスターまたは Flex クラスターを構成します。 AtlasDeployment カスタムリソースを作成すると、Atlas Kubernetes Operator は Atlas 内の クラスターまたは Flex クラスターを作成または更新しようとします。

Atlas Kubernetes Operator は、 AtlasDeploymentカスタム リソースで指定した値に応じて、次のいずれかのアクションを実行します。

• spec.deploymentSpecの下のフィールドに値を指定すると、Atlas Kubernetes Operator は Atlas Clusters APIリソースを使用して新しいクラスターを作成するか、既存のクラスターを更新します。

• spec.flexSpecの下のフィールドに値を指定すると、Atlas Kubernetes Operator は Atlas Flex Instance APIリソースを使用して、新しい Flex クラスターを作成するか、既存の Flex クラスターを更新します。

クラスターまたは 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カスタム リソース パラメータの一部について説明します。

• クラスターで使用可能なパラメーターの完全なリストについては、 Atlas Clusters API を参照してください。

• Flex クラスターで使用可能なパラメーターの完全なリストについては、 Atlas Flex Clusters APIを参照してください。

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

仕様をカスタマイズするには、これらの説明、利用可能な例、およびAPIドキュメントを参照してください。

spec.backupRef

型: オブジェクト

任意

適用するAtlasBackupScheduleカスタム リソースの詳細を含むリスト。 クラスターごとに 1 つのバックアップ スケジュールを指定できます。

spec.backupRef.name

型: string

任意

metadata.name 適用するバックアップ スケジュールのAtlasBackupScheduleカスタム リソース内の値。 クラスターごとに指定できるバックアップ スケジュールは 1 つだけですが、複数のクラスターで同じバックアップ スケジュールを使用できます。

このパラメーターを省略すると、Atlas はこのクラスターにバックアップ構成を適用しません。

spec.backupRef.namespace

型: string

任意

適用するバックアップ スケジュールのAtlasBackupScheduleカスタム リソースを含む名前空間を示す string。

spec.connectionSecret.name

型: string

条件付き

Atlas Kubernetes Operator が Atlas への接続に使用する組織IDとAPIキーを含む opaque secret の名前。指定されていない場合、Atlas Kubernetes Operator は次のいずれかにフォールバックします。

• 親 atlasProject の spec.connectionSecretRef.name パラメータ

• デフォルトの global シークレット（親 atlasProject に対して spec.connectionSecretRef.name が未定義の場合）

このパラメータは独立した CRD に必須です。

spec.deploymentSpec

タイプ: 配列

条件付き

APIからのクラスター パラメーターが含まれるリスト。 使用可能なパラメーターの完全なリストについては、 Atlas Clusters API を参照してください。

重要

spec.deploymentSpec構成でspec.flexSpec または を指定する必要があります。

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

spec.deploymentSpec.clusterType

型: string

条件付き

作成するクラスターのタイプを識別する、人間が判読可能なラベル。

このパラメーターをいつ使用するか？

条件	必要性
spec.deploymentSpec.replicationSpecsを設定します。	必須
グローバルクラスターを配置している。	必須
非グローバルのレプリカセットとシャーディングされたクラスターを配置している。	任意

Atlas では以下に対応しています。

値	クラスター タイプ
レプリカセット	レプリカセット
シャード	シャーディングされたクラスター
GEOSHARDED	グローバル クラスター

spec.deploymentSpec.customZoneMapping

タイプ: 配列

必須

ゾーンを地理的リージョンにマッピングするグローバルクラスターパラメーターが格納されたリスト。 使用可能なパラメーターの完全なリストについては、 Atlas Global Clusters API を参照してください。

spec.deploymentSpec.customZoneMapping.location

型: string

必須

グローバルクラスター内のゾーンにマッピングするロケーションを表すコード。

spec.deploymentSpec.customZoneMapping.zone

型: string

必須

グローバルクラスター内のゾーンを識別する、人間が判読できるラベル。

spec.deploymentSpec.diskSizeGB

タイプ: 数値

任意

ホストのルート ボリュームを示す容量（ギガバイト単位）。 この数を増やして、最大値4096 （4 TB）まで容量を追加します。 この値には正の数を指定する必要があります。

この値は、ローカルNVMe SSDを持つクラスターでは設定できません。

注意

任意のリージョンでdiskGBのオートスケーリングを有効にしている場合、このオプションは編集できません。 詳しくは、 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.diskGB.enabledを参照してください。

専有クラスターの最小ディスク サイズは、GB Amazon Web ServicesおよびGoogle Cloud Platform で 10 です。より低いディスク サイズでこの設定を指定すると、Atlas はデフォルトで最小ディスク サイズ値になります。

データベース配置にAzureノードが含まれている場合、この値は既存のAzureディスクタイプ（8、16、32、64、128、256、512、1024、2048、または 4096）に対応している必要があります。

Atlas は、デフォルト値を選択するかカスタム値を選択するかに応じて、ストレージ料金の計算方法が異なります。

Atlas は単一のレプリカセットのディスク容量に制限があり、上位のクラスター階層では4 TB までスケールアップされます。 デフォルトの制限を超えてクラスターの合計ストレージを拡張するには、プロジェクト設定で拡張ストレージを有効にします。 将来のさらなるスケーリングに対応するため、長期的に展開できるようシャーディングを有効にすることをお勧めします。

データベース配置が複数のクラウド サービス プロバイダーにまたがる場合、この値は関係するプロバイダーの最小デフォルトになります。

詳細については、「ストレージ容量 」を参照してください。

spec.deploymentSpec.encryptionAtRestProvider

型: string

任意

このクラスターのカスタマー キーを管理するクラウド サービス プロバイダー。 このクラスターのカスタマー マネージド キーを使用して保管時の暗号化を有効にするには、この値を設定する必要があります。これにより、暗号化の追加レイヤーが提供されます。 詳細については、「 KMSを使用したデータの暗号化 」を参照してください。

Atlas は次の値を受け入れます。

値	クラウドプロバイダー
Amazon Web Services	Amazon Amazon Web Services
GCP	Google Cloud
Azure	Microsoft Azure
なし	プロバイダーなし。クラスターは、カスタマー マネージド キーを使用してデータを暗号化 しません 。

spec.deploymentSpec.managedNamespaces

タイプ: 配列

必須

作成する指定されたグローバルクラスターに管理対象名前空間を作成するための情報を含むリスト。 使用可能なパラメーターの完全なリストについては、 Atlas Global Clusters API を参照してください。

spec.deploymentSpec.managedNamespaces.collection

型: string

必須

このグローバルクラスターで管理するコレクションの、人間が判読可能なラベル。

spec.deploymentSpec.managedNamespaces.db

型: string

必須

このグローバルクラスターで管理する、人間が判読可能なデータベースのラベル。

spec.deploymentSpec.managedNamespaces.isCustomShardKeyHashed

タイプ: ブール値

任意

指定されたコレクションのカスタム シャードキーをハッシュするかどうかを示すフラグ。 このパラメータのデフォルトはfalseです。

• コレクションのカスタム シャードキーを有効にするには、 をtrueに設定します。

• コレクションのカスタム シャードキーを無効にするには、 をfalseに設定します。 無効にすると、MongoDB は範囲シャーディングを使用します。

詳細については、「ハッシュされたシャードキー 」を参照してください。

spec.deploymentSpec.managedNamespaces.isCustomShardKeyUnique

タイプ: ブール値

任意

指定されたコレクションのカスタム シャードキーが一意であるかどうかを示すフラグ。 このパラメータのデフォルトはfalseです。

• コレクションの一意のカスタム シャードキーを有効にするには、 をtrueに設定します。

• コレクションの一意のカスタム シャードキーを無効にするには、 をfalseに設定します。

spec.deploymentSpec.managedNamespaces.numInitialChunks

タイプ: 整数

任意

空の コレクションをハッシュされたシャードキー でシャーディングするときに最初に作成するチャンクの最小数。

詳細については、「グローバル コレクションのシャーディング 」を参照してください。

spec.deploymentSpec.managedNamespaces.presplitHashedZones

タイプ: ブール値

任意

MongoDB Cloud が、空のコレクションや存在しないコレクションの初期チャンクを作成して配布するかどうかを示すフラグ。 このパラメータのデフォルトはfalseです。

• MongoDB Cloud が空のコレクションまたは存在しないコレクションの初期チャンクを作成して配布するには、 trueに設定します。

• MongoDB Cloud が空のコレクションや存在しないコレクションの初期チャンクを作成して配布しないようにするには、 falseに設定します。

spec.deploymentSpec.mongoDBMajorVersion

型: string

任意

配置するクラスターのバージョン。 Atlas は、 M10+クラスターに対して次の MongoDB バージョンをサポートしています。

• 5.0

• 6.0

• 7.0

次の条件では、次の結果が得られます。

条件	結果
このパラメータを省略し、spec.deploymentSpec.versionReleaseSystem パラメータを省略します。	Atlas は MongoDB 7.0 を実行するクラスターをデプロイします。
このパラメータを省略し、spec.deploymentSpec.versionReleaseSystem パラメータをLTS に設定します。	Atlas は MongoDB 7.0 を実行するクラスターをデプロイします。
AtlasM2 M5は および クラスターとサーバーレス インスタンスを非推奨にしました。詳細については、「 フレキシブルなクラスターへの移行 spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSize」を参照してください。 パラメータをM0 、M2 、またはM5 に設定します。	MongoDB 7.0 以降を配置する必要があります。
このパラメーターを指定します。	Atlas は、指定されたバージョンの最新の安定したパッチ リリースを使用してクラスターを常にデプロイします。
spec.deploymentSpec.versionReleaseSystemパラメータをCONTINUOUS に設定します。	このパラメーターは省略する必要があります。

spec.deploymentSpec.pitEnabled

タイプ: ブール値

条件付き

注意

Atlas は M2 および M5 クラスターとサーバーレス インスタンスを非推奨にしました。近い将来、Atlas はすべての M2 クラスターと M5 クラスターを Flex クラスターに自動的に移行する予定です。サーバーレス インスタンスの場合、Atlas は使用状況に応じて、インスタンスを無料クラスター、Flex クラスター、または専用クラスターに移行するかどうかを決定し、サーバーレス インスタンスを自動的に移行します。

API の下位互換性を一定期間維持するため、Atlas では、Atlas Kubernetes Operator を使用する場合を含め、これらの移行クラスターを同じ API（古い API と新しい API）で管理できるようにします。 API の下位互換性は、古い2026 API が削除され、Flex クラスターに関連する API のみが残ります。

サーバーレスインスタンス上のプライベートエンドポイントのサポートは、2025 年 3 月 日で終了します。 {3 月 2025 までにプライベートエンドポイントを削除するには、Atlas Kubernetes Operator の構成を更新する必要があります。 残りのすべての M2、M5、およびサーバーレスインスタンス機能を Atlas Kubernetes Operator 構成から 1 月 2026前に削除する必要があります。

ワークロードに プライベートエンドポイント または 継続的なバックアップとポイントインタイム復元 が必要な場合は、Atlas 専用クラスターに切り替えます。詳細については、「 Flex クラスターへの移行 」および「 Atlas Flex 移行ガイド 」を参照してください。

継続的なクラウドバックアップを可能にする構成。 継続的なクラウドバックアップを有効にするには、この設定に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

タイプ: 整数

条件付き

シャーディングされたクラスターに配置するシャードの数を指定する正の整数。

spec.deploymentSpec.replicationSpecsパラメーターを使用する場合は、このパラメーターを設定する必要があります。

Atlas は1から50までを受け入れます。 デフォルト値は1です。

• 1の値を指定し、 spec.deploymentSpec.clusterTypeをSHARDEDに設定すると、Atlas は単一シャードのシャーディングされたクラスターを配置します。

• 1を指定し、 spec.deploymentSpec.clusterTypeをREPLICASETに設定すると、Atlas はレプリカセットを配置します。

  実稼働環境では、単一のシャードを含むシャーディングされたクラスターを作成しないでください。単一シャードのシャード クラスターでは、マルチシャード構成と同じ利点は得られません。

  Tip

  以下も参照してください。

  • シャーディング

  • ノード数

警告

シャーディングされたシャーディングされたクラスターを使用する場合、 MongoDBではアプリケーションがmongos インスタンスに接続され、アプリケーションがシャードやシャーディングされたシャーディングされたクラスターのコンポーネントと適切にやり取りできるようにする必要があります。レプリカセットから シャーディングされたシャーディングされたクラスターに移行する場合は、クラスターのmongos への接続を有効にするためにアプリケーションを再起動する必要があります。その結果、Atlas Admin APIでは、レプリカセットを複数のシャードを持つシャーディングされたシャーディングされたクラスターに直接移行することはできません。 レプリカセットを単一のシャード クラスターに正常に移行し、アプリケーション接続をリセットしたら、クラスターにシャードを追加できます。

spec.deploymentSpec.replicationSpecs.regionConfigs

タイプ: 配列

必須

特定のリージョンに設定されたノードのハードウェア仕様。 各regionConfigsオブジェクトは、選挙におけるリージョンの優先順位と、Atlas がリージョンに配置する MongoDB ノードの数とタイプを表します。

各regionConfigsオブジェクトには、 analyticsSpecsオブジェクト、 electableSpecsオブジェクト、またはreadOnlySpecsオブジェクトのいずれかが必要です。

• M0、 M2 、またはM5クラスターではelectableSpecsのみが必要です。

• 専有クラスターはこれらの仕様のいずれかを指定できますが、 replicationSpec内に少なくとも 1 つのelectableSpecsオブジェクトが必要です。

• すべてのハードウェア仕様で同じinstanceSizeを使用する必要があります。

spec.deploymentSpec.replicationSpecs.regionConfigs.analyticsSpecs

型: オブジェクト

任意

リージョンで必要とされる分析ノードのハードウェア仕様。 分析ノードは、BI Connector for Atlas からのクエリのレポートなどの分析データを処理します。 分析ノードは読み取り専用であり、プライマリになることはできません。

このパラメーターを指定しない場合、Atlas はこのリージョンに分析を配置しません。

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

タイプ: ブール値

任意

このデータベース配置でディスクのオートスケーリングが有効になっているかどうかを示すフラグ。 このパラメータのデフォルトはtrueです。

• ディスクのオートスケーリングを有効にするには、 trueに設定します。

• ディスクの自動スケーリングを無効にするには、 falseに設定します。

選択したクラスター階層の RAM の最大量と oplog サイズによって、ストレージのオートスケーリングが制限される可能性があります。 詳しくは、「ストレージをカスタマイズする 」を参照してください。

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

タイプ: ブール値

任意

インスタンス サイズのオートスケーリングが有効になっているかどうかを示すフラグ。 このパラメータのデフォルトはfalseです。

• インスタンス サイズのオートスケーリングを有効にするには、 trueに設定します。 有効にする場合は、 spec.deploymentSpec.replicationSpecs.regionConfigs.autoScaling.compute.maxInstanceSizeの値を指定する必要があります。

• インスタンス サイズの自動スケーリングを無効にするには、 falseに設定します。

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

型: string

条件付き

データベース配置がオートスケーリングできる最大インスタンス サイズを示すstring （M40 など）。 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

型: string

条件付き

データベース配置がオートスケーリングできる最小インスタンスサイズを示すstring （M10 など）。 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

型: string

条件付き

このリージョンのインスタンス サイズのハードウェア仕様。 各インスタンス サイズには、デフォルトのストレージとメモリ容量が設定されています。 選択したインスタンス サイズは、インスタンス サイズ内のすべてのデータを保持するホストに適用されます。 詳しくは、「 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、または Flex クラスターを別の 無料クラスターまたは共有クラスターにアップグレードすることはできません。

spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.nodeCount

タイプ: 整数

条件付き

Atlas が リージョンに配置する選択可能なノードの数。 選挙可能なノードはプライマリになることができ、ローカル読み取りを有効にできます。

すべてのreplicationSpecs.regionConfigsオブジェクトにわたるelectableSpecs.nodeCountの合計は、 3 、 5 、または7の合計が必要です。

spec.deploymentSpec.replicationSpecs.regionConfigs.priorityが0の場合、選択可能なノードを作成することはできません。

spec.deploymentSpec.replicationSpecs.regionConfigs.priority

タイプ: 整数

必須

予備選挙が行われると、このリージョンに優先順位が与えられます。

regionConfigsにreadOnlySpecs 、 analyticsSpecs 、またはその両方がある場合は、この値を0に設定します。

複数のregionConfigsオブジェクト（クラスターがマルチリージョンまたはマルチクラウド）がある場合、それらの優先順位は降順である必要があります。 最も優先順位は7です。

例

最も優先度の高いリージョンを7に、2 番目に優先度の高いリージョンを6に、3 番目の優先度のリージョンを5に設定します。 選択可能なノードがない場合は、この値を0に設定します。

お使いのリージョンでelectableSpecs.nodeCountが1以上に設定されている場合、プライマリでない限り、 replicationSpecs.regionConfigs配列内の別のリージョンよりも優先度が 1 つだけ低い必要があります。 最も優先度の高いリージョンの優先度は、 7である必要があります。 最低の優先順位は1です。

優先度7リージョンは、クラスターの優先リージョンを識別します。 Atlas は優先リージョンにプライマリ ノードを配置します。 優先順位1から7は排他的です。特定の優先順位をクラスターごとに複数のリージョンに割り当てることはできません。

例

3 つのリージョンがある場合、優先順位はそれぞれ7 、 6 、 5になります。 選択可能なノードをサポートするためにさらに 2 つのリージョンを追加した場合、それらのリージョンの優先順位はそれぞれ4と3になります。

spec.deploymentSpec.replicationSpecs.regionConfigs.providerName

型: string

条件付き

Atlas がホストをプロビジョニングするクラウド サービス プロバイダー。

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

spec.deploymentSpec.replicationSpecs.regionConfigs.regionName

型: string

条件付き

MongoDB クラスターの物理的なロケーション。 選択したリージョンは、データベースにアクセスするクライアントのネットワーク レイテンシに影響する可能性があります。

リージョン名の値の完全なリストについては、クラウドプロバイダーのリファレンス ページを参照してください。

• Amazon Web Services

• GCP

• Azure

マルチリージョンクラスターについては、 spec.deploymentSpec.replicationSpecsを参照してください。 spec.deploymentSpec.replicationSpecs.regionConfigs.regionNameまたはspec.deploymentSpec.replicationSpecsのいずれかを設定する必要があります。

spec.deploymentSpec.replicationSpecs.regionConfigs.readOnlySpecs

型: オブジェクト

任意

リージョン内の読み取り専用ノードのハードウェア仕様。 読み取り専用ノードは プライマリ ノードになることはできませんが、ローカル読み取りを有効にできます。

このパラメーターを指定しない場合、Atlas は リージョンに読み取り専用ノードを配置しません。

spec.deploymentSpec.replicationSpecs.zoneName

型: string

任意

グローバルクラスター内の ゾーンを識別する、人間が判読可能なラベル。 この値は、 spec.deploymentSpec.clusterTypeをGEOSHARDEDに設定した場合にのみ指定します。

spec.deploymentSpec.searchIndexes

タイプ: 配列

任意

検索インデックスを記述するフィールドを持つSearchIndexオブジェクトの配列。 各SearchIndexオブジェクトには次のフィールドが含まれています。

フィールド	タイプ	説明
name	string	このインデックスを識別する、人間が判読できるラベル。 配置に対して一意である必要があります。
DBName	string	1 つ以上の Atlas Search インデックスを持つコレクションを含む既存のデータベースを識別する、人間が判読できるラベル。 重要:指定するデータベースはすでに存在している必要があります。 既存のデータベースがない場合は、作成します 。
collectionName	string	1 つ以上の Atlas Search インデックスを含むコレクションを識別する、人間が判読できるラベル。
type	string	インデックスのタイプ。 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	string	シノニム（同意語）の定義を識別する、人間が判読可能なラベル。 各名前は同じインデックス定義内で一意である必要があります 必須
analyzer	string	検索するシノニム（同意語）に適用するために選択された特定の定義済みメソッド。 可能な値は次のとおりです。 lucene.standard lucene.standard lucene.simple lucene.whitespace lucene.keyword lucene.arabic lucene.argenian lucene.basque lucene. envelope 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	オブジェクト	1 つ以上の単語が、それらの単語の 1 つ以上のシノニム（同意語）にマップされるのを保存するデータセット 必須

spec.deploymentSpec.searchIndexes.search.synonyms.source

型: オブジェクト

必須

フィールド	タイプ	説明
collection	string	単語とそのシノニム（同意語）を保存する MongoDB コレクションを識別する、人間が判読可能なラベル 必須

spec.deploymentSpec.searchIndexes.search.mappings

型: オブジェクト

必須

コレクションのフィールドのインデックス仕様を持つオブジェクト:

dynamic	ブール値	インデックスが動的マッピングを使用するか、静的マッピングを使用するかを示すフラグ。 mappings.fields が省略されている場合は必須です。
fields	JSON/YAML	Atlas Search インデックスの 1 つ以上のフィールド仕様。 mappings.dynum が省略されているか、false に設定されている場合は必須です。

spec.deploymentSpec.searchIndexes.vectorSearch

型: オブジェクト

任意

フィールド	タイプ	説明
fields	JSON/YAML	JSON オブジェクトの配列。 https://docub.mongodb.org/core/avs-vector-type 必須

spec.deploymentSpec.searchNodes

タイプ: 配列

任意

検索ノード構成の配列。 各要素には 2 つのフィールドが含まれています。

フィールド	タイプ	説明
nodeCount	integer	クラスター内の検索ノードの数。 Atlas は2から32までの値を受け入れます。 デフォルトの数値は2です。
instanceSize	string	検索ノード インスタンス サイズのハードウェア仕様。 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

型: string

条件付き

Atlas がこのクラスターに使用するリリース ケイデンス。 Atlas では以下に対応しています。

• CONTINUOUS: Atlas は、最新の MongoDB リリースを使用してクラスターを作成します。 Atlas は、MongoDB の最新のメジャー リリースと Rapid Release が利用可能になると、クラスターを自動的に更新します。

• LTS: Atlas は、 spec.deploymentSpec.mongoDBMajorVersionパラメータで指定した MongoDB バージョンの最新パッチ リリースを使用してクラスターを作成します。 Atlas は、クラスターをこの MongoDB バージョンの後続のパッチ リリースに自動的に更新します。 Atlas は、MongoDB の新しい Rapid Release またはメジャー リリースが利用可能になると、クラスターを更新しません。

  省略した場合、デフォルトは LTS になります。

  このパラメータをCONTINUOUSに設定する場合は、 spec.deploymentSpec.mongoDBMajorVersionパラメータを省略する必要があります。

spec.externalProjectRef.id

型: string

条件付き

配置が属するプロジェクトのID 。 既存の Atlas プロジェクト のプロジェクトIDを指定する必要があります。このパラメーターは、次のいずれかによって管理されるプロジェクトに属する配置に必要です。

• Atlas Kubernetes Operator の別のインスタンス

• Atlas Kubernetes Operator 以外のツール

Atlas Kubernetes Operator の同じインスタンスによって管理されるプロジェクトに属する配置では、 spec.externalProjectRef.id を使用しない場合は spec.projectRef.name を使用します。

spec.flexSpec

タイプ: 配列

条件付き

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

APIからの Flex クラスター パラメーターが含まれるリスト。利用可能なパラメーターの完全なリストについては、 Atlas Flex Clusters API を参照してください。

重要

spec.deploymentSpec構成でspec.flexSpec または を指定する必要があります。

spec.flexSpec.name

型: string

Flex クラスターの名前を識別する string。

spec.flexSpec.tags

タイプ: 配列

任意

データベース配置をよりよく理解、整理し、識別するためのタグ（キーと値のペア）を含むリスト。 詳細については、「クラスターのタグ 」を参照してください。

spec.flexSpec.terminationProtectionEnabled

タイプ: ブール値

Flex クラスターの終了保護が有効になっているか無効になっているかを示します。 true に設定されていると、Atlas はクラスターを削除しません。 false に設定されていると、Atlas はクラスターを削除します。 デフォルトはfalse です。

spec.flexSpec.providerSettings.backingProviderName

型: string

Flex クラスターのクラウドプロバイダーの名前。 providerSettings には、 MongoDB が実行されるプロビジョニングされたホストの 設定を指定する構成が含まれます。

Atlas は、次のいずれかの値を受け入れます。

• AWS

• AZURE

• GCP

spec.flexSpec.providerSettings.regionName

型: string

MongoDB Flex クラスターの物理的なロケーション。 選択したリージョンは、データベースにアクセスするクライアントのネットワークレイテンシに影響する可能性があります。

リージョン名の値の完全なリストについては、クラウドプロバイダーのリファレンス ページを参照してください。

• Amazon Web Services

• GCP

• Azure

spec.processArgs

型: オブジェクト

任意

クラスターの追加構成オプションを含むオブジェクト。

spec.processArgs.defaultReadConcern

型: string

任意

このクラスターの読み取り操作に対して MongoDB から要求される確認応答のデフォルト レベルを示す string。

MongoDB 5.0クラスターのデフォルトはローカルです。

spec.processArgs.defaultWriteConcern

型: string

任意

このクラスターに対して設定された書込み (write) 操作に対して MongoDB から要求される確認応答のデフォルト レベルを示す string。

MongoDB バージョン5.0以降のクラスターのデフォルトは過半数です。

spec.processArgs.failIndexKeyTooLong

タイプ: ブール値

任意

すべてのインデックスエントリが1024バイトを超えるドキュメントを挿入または更新するときに、操作を失敗させエラーを返すかどうかを示すフラグ。 これをfalseに設定すると、 mongodはこの制限を超えるドキュメントを書込みますが、インデックスは作成しません。

このオプションはparam.failIndexKeyTooLong mongodパラメータに相当します。

spec.processArgs.javascriptEnabled

タイプ: ブール値

任意

クラスターが JavaScript のサーバー側実行を実行する操作の実行を許可するかどうかを示すフラグ。

• このオプションは、クラスター内の各 とsecurity.javascriptEnabledmongodmongos の 構成ファイル オプションの変更に対応します。

spec.processArgs.minimumEnabledTlsProtocol

タイプ: 整数

任意

着信接続に対してクラスターが許可する最小TLSバージョンを示す string。 TLS 1.0 または 1.1 を使用するクラスターでは、 TLS プロトコルの最小バージョンとして TLS 1.2 を設定することを検討する必要があります。

詳細については、「 Atlas はどのバージョンの TLS をサポートしていますか 」を参照してください。

このオプションは、 net.ssl.disabledProtocols mongod構成ファイル オプションに相当します。

spec.processArgs.noTableScan

タイプ: ブール値

任意

結果を返すためにコレクションスキャンが必要なクエリについて、クラスターで実行が無効化されているかどうかを示すフラグ。

このオプションはnotablescan mongodパラメーターに相当します。

spec.processArgs.oplogSizeMB

タイプ: 整数

任意

クラスターの oplog のストレージ制限をメガバイト単位で示す数値。 nullの値は、Atlas が計算するデフォルトの oplog サイズをクラスターが使用することを示します。

このオプションは、 replication.oplogSizeMB mongod構成ファイル オプションに相当します。

spec.processArgs.sampleRefreshIntervalBIConnector

タイプ: 整数

任意

スキーマ情報の収集時にサンプリングするデータベースあたりのドキュメント数を示す数値。

このパラメーターは、 sampleSize mongosqldオプションに対応します。

spec.processArgs.sampleSizeBIConnector

タイプ: 整数

任意

mongosqld プロセスがデータを再サンプリングしてリレーショナル スキーマを作成する間隔を秒単位で示す数値。

このパラメーターは、 sampleRefreshIntervalSecs mongosqldオプションに対応します。

spec.projectRef.name

型: string

条件付き

配置が属するプロジェクトの名前。 既存のAtlasProject カスタム リソース を指定する必要があります。このパラメーターは、同じインスタンスAtlas Kubernetes Operator によって管理されるプロジェクトに属する配置にのみ適用されます。

次のいずれかによって管理されるプロジェクトに属する配置の場合、次のいずれかによって管理されます。

• Atlas Kubernetes Operator の別のインスタンス

• Atlas Kubernetes Operator 以外のツール

spec.externalProjectRef.id を使用します。

spec.serverlessSpec

タイプ: 配列

条件付き

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

APIからのサーバーレスインスタンスパラメーターが格納されたリスト。利用可能なパラメーターの完全なリストについては、 Atlas Flex Clusters API を参照してください。

重要

構成でspec.deploymentSpecまたはspec.flexSpecを指定する必要があります。

spec.serverlessSpec.privateEndpoints

タイプ: 配列

任意

注意

Atlas は M2 および M5 クラスターとサーバーレス インスタンスを非推奨にしました。近い将来、Atlas はすべての M2 クラスターと M5 クラスターを Flex クラスターに自動的に移行する予定です。サーバーレス インスタンスの場合、Atlas は使用状況に応じて、インスタンスを無料クラスター、Flex クラスター、または専用クラスターに移行するかどうかを決定し、サーバーレス インスタンスを自動的に移行します。

API の下位互換性を一定期間維持するため、Atlas では、Atlas Kubernetes Operator を使用する場合を含め、これらの移行クラスターを同じ API（古い API と新しい API）で管理できるようにします。 API の下位互換性は、古い2026 API が削除され、Flex クラスターに関連する API のみが残ります。

サーバーレスインスタンス上のプライベートエンドポイントのサポートは、2025 年 3 月 日で終了します。 {3 月 2025 までにプライベートエンドポイントを削除するには、Atlas Kubernetes Operator の構成を更新する必要があります。 残りのすべての M2、M5、およびサーバーレスインスタンス機能を Atlas Kubernetes Operator 構成から 1 月 2026前に削除する必要があります。

ワークロードに プライベートエンドポイント または 継続的なバックアップとポイントインタイム復元 が必要な場合は、Atlas 専用クラスターに切り替えます。詳細については、「 Flex クラスターへの移行 」および「 Atlas Flex 移行ガイド 」を参照してください。

非推奨。 このパラメーターが存在する場合は削除します。 サーバーレスインスタンスのプライベートエンドポイント構成が格納されたリスト。

spec.serverlessSpec.providerSettings

型: オブジェクト

条件付き

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

MongoDB が実行されるプロビジョニングされたホストの 設定を指定する構成。 利用可能なオプションは、クラウドサービス プロバイダーに固有です。 詳しくは、「 Amazon Web Services 」 、 「 GCP 」 、およびAzure Serverlessインスタンスの構成オプションを参照してください。

サーバーレスインスタンスを作成または更新する場合は、この設定を指定する必要があります。

重要

次の設定は非推奨であり、将来のリリースで削除される予定です。

• 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

型: string

条件付き

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

Atlas が サーバーレスインスタンスのホストをプロビジョニングするクラウド サービス プロバイダー。

Atlas は次の値を受け入れます。

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

spec.serverlessSpec.providerSettings.regionName

型: string

条件付き

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

MongoDBサーバーレスインスタンスの物理的なロケーション。 選択したリージョンは、データベースにアクセスするクライアントのネットワークレイテンシに影響する可能性があります。

リージョン名の値の完全なリストについては、クラウドプロバイダーのリファレンス ページを参照してください。

• Amazon Web Services

• GCP

• Azure

spec.serverlessSpec.tags

注意

変更に関する詳細な情報については、「 フレキシブルなクラスターへの移行に関するノート 」を参照してください。

タイプ: 配列

任意

データベース配置をよりよく理解、整理し、識別するためのタグ（キーと値のペア）を含むリスト。 詳細については、「クラスターのタグ 」を参照してください。

status.connectionStrings

タイプ: 配列

必須

クラスターにアクセスするための接続 URL が格納されたリスト。 このパラメーターは、クラスターを作成またはアップデートした後に表示されます。

注意

... include:：/includes/fact-ask8so- connection-strings.rst

APIからクラスターで利用可能な構成パラメーターについては、「 Atlas Clusters API 」を参照してください。