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

パラメーター

このセクションでは、使用可能な主要なAtlasDeploymentカスタム リソース パラメータの一部について説明します。

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

• サーバーレスインスタンスで使用できるパラメーターの完全なリストについては、「 Atlas Serverless Instances API 」を参照してください。

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

spec.backupRef

型: オブジェクト

任意

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

spec.backupRef.name

型: string

任意

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

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

spec.backupRef.namespace

型: string

任意

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

spec.deploymentSpec

タイプ: 配列

条件付き

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

重要

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

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 を実行するクラスターをデプロイします。
spec.deploymentSpec.replicationSpecs.regionConfigs.electableSpecs.instanceSizeパラメータをM0 、M2 、またはM5 に設定します。	MongoDB 7.0 を配置する必要があります。
このパラメーターを指定します。	Atlas は、指定されたバージョンの最新の安定したパッチ リリースを使用してクラスターを常にデプロイします。
spec.deploymentSpec.versionReleaseSystemパラメータをCONTINUOUS に設定します。	このパラメーターは省略する必要があります。

spec.deploymentSpec.pitEnabled

タイプ: ブール値

条件付き

継続的なクラウドバックアップを可能にする構成。 継続的なクラウドバックアップを有効にするには、この設定に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 ルーターに再接続されたことを確認したときに、シャードを追加で追加できます。

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クラスターをM10+クラスターにアップグレードします。 ただし、 M0 、 M2 、またはM5クラスターは、別の 無料クラスターまたは 共有クラスターにアップグレードできません。 たとえば、 M0クラスターをM5クラスターにアップグレードすることはできません。

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.tags

タイプ: 配列

任意

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

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.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カスタム リソースを指定する必要があります。

spec.serverlessSpec

タイプ: 配列

条件付き

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

重要

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

spec.serverlessSpec.privateEndpoints

タイプ: 配列

任意

サーバーレスインスタンスのプライベートエンドポイント構成が格納されたリスト。

spec.serverlessSpec.providerSettings

型: オブジェクト

条件付き

MongoDB が実行されるプロビジョニングされたホストの 設定を指定する構成。 利用可能なオプションは、クラウド サービス プロバイダーに固有です。 詳しくは、「 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

型: 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 が格納されたリスト。 このパラメーターは、クラスターを作成またはアップデートした後に表示されます。

注意

接続URL を直接使用することはできません。Atlas クラスターには認証が必要です。Kubernetesクラスター内のアプリケーションがAtlas クラスターに接続する前に、少なくとも 1 つのAtlasDatabaseUser カスタム リソースを作成する必要があります。Atlas Kubernetes Operator は、プロジェクト内の各クラスターとデータベースユーザーの組み合わせに対して特別なシークレットを作成します。Kubernetesクラスター内のアプリケーションは、このシークレットを使用して Atlas クラスターに接続できます。AtlasDatabaseUser カスタムリソースの spec.scopes パラメータは、データベースユーザーを作成するクラスターを制限します。

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