Docs Menu
Docs Home
/
Atlas オープン サービス ブロック
/
データベース配置

レプリカセットの配置

重要

Atlas Open Service Blog は非推奨です。代わりに、MongoDB Atlas演算子 を使用してください。

レプリカセット は、同じデータセットを保持するMongoDB配置のグループです。レプリカセットは冗長性と高可用性を提供し、すべての配置環境の基盤となります。

レプリカセットの詳細については、MongoDB マニュアルの 「レプリケーションの概要」を参照してください。

You can use the Atlas Open Service Broker to deploy a new replica set managed by Atlas. 配置後は、Atlas を使用して、モニタリング、バックアップ、VPC ピアリングや請求などのプロジェクト構成を管理します。

前提条件

Atlasレプリカセットは、オブジェクトを定義して作成します。Kubernetesオブジェクトを使用してレプリカセットを配置するには、まず Atlas Open Service ブロックをインストールする 必要があります。

Considerations

Atlas Public API

Atlas Open Service Blog は、Atlas Public API の クラスターの作成 エンドポイントを使用してレプリカセットを配置します。APIの要件や制限は、Atlas Open Service Blog にも適用されます。

手順

1

レプリカセットのリソース定義を作成します。

  1. サービス プロバイダー インスタンスのスコープに基づいて、次のリソース定義の例の 1 つをコピーします。

    Atlas Open Service Blog インスタンスをクラスター スコープの ClusterServiceBrokerとして登録した場合は、[ クラスター スコープのインスタンス ] を選択します。 Atlas Open Service Blog インスタンスを名前空間スコープのServiceBrokerとして登録した場合は、[ 名前空間スコープのインスタンス ] を選択します。


    次の YAML ファイルをコピーします。これは、必要な構成に合わせて変更できます。

    apiVersion: servicecatalog.k8s.io/v1beta1
    kind: ServiceInstance
    metadata:
      name: <CLUSTER_NAME>
      namespace: <NAMESPACE>
    spec:
      clusterServiceClassExternalName: <CLOUD_SERVICE_PROVIDER_CLASS>
      clusterServicePlanExternalName: <INSTANCE_SIZE_PLAN>
      parameters:
        cluster:
          providerSettings:
            regionName: <ATLAS_REGION>

    次の YAML ファイルをコピーします。これは、必要な構成に合わせて変更できます。

    apiVersion: servicecatalog.k8s.io/v1beta1
    kind: ServiceInstance
    metadata:
      name: <CLUSTER_NAME>
      namespace: <NAMESPACE>
    spec:
      serviceClassExternalName: <CLOUD_SERVICE_PROVIDER_CLASS>
      servicePlanExternalName: <INSTANCE_SIZE_PLAN>
      parameters:
        cluster:
          providerSettings:
            regionName: <ATLAS_REGION>

  2. テキスト エディターを開き、リソース定義を新しいテキスト ファイルに貼り付けます。

2

必要な設定を構成します。

レプリカセットを配置するには、ハイライトされた設定が必要です。

キー
説明
例

metadata.name

Kubernetes内のクラスターの名前。Atlas は、対応するレプリカセット名をランダムに生成します。

my-atlas-cluster

metadata.namespace

このクラスターが作成されるKubernetes名前空間空間。

atlas

spec.clusterServiceClassExternalName

Atlasクラウドサービス プロバイダーに対応するKubernetesクラス。

次のコマンドを呼び出して、利用可能なクラスを表示します。

svcat marketplace -n <NAMESPACE>

クラス名は、コマンド出力の CLASS 列に表示されます。

注意

M2 または M5レプリカセットを配置するには、mongodb-atlas-tenantクラスを使用する必要があります。spec.regionName 設定に指定する値によって、クラスターが配置されるクラウドプロバイダーが決まります。

mongodb-atlas-aws

spec.clusterServicePlanExternalName

必要な Atlasインスタンスサイズに対応するKubernetesサービス プラン。

次のコマンドを呼び出して、利用可能なプランを表示します。

svcat marketplace -n <NAMESPACE>

プラン名は、コマンド出力の PLANS 列に表示されます。

M10

spec.regionName

レプリカセットが作成される Atlas リージョン。

重要

目的のリージョンに、クラウドプロバイダーのリージョン名ではなく、Atlas リージョン名を使用していることを確認してください。M2 または M5 クラスターを配置する場合は、選択したリージョンがこれらのクラスター サイズをサポートしていることを確認してください。

利用可能なリージョンのリストについては、クラウドサービス プロバイダーの Atlas ドキュメントを参照してください。

EU_CENTRAL_1

キー
説明
例

metadata.name

Kubernetes内のクラスターの名前。Atlas は、対応するレプリカセット名をランダムに生成します。

my-atlas-cluster

metadata.namespace

このクラスターが作成されるKubernetes名前空間空間。

atlas

spec.serviceClassExternalName

Atlasクラウドサービス プロバイダーに対応するKubernetesクラス。

次のコマンドを呼び出して、利用可能なクラスを表示します。

svcat marketplace -n <NAMESPACE>

クラス名は、コマンド出力の CLASS 列に表示されます。

注意

M2 または M5レプリカセットを配置するには、mongodb-atlas-tenantクラスを使用する必要があります。spec.regionName 設定に指定する値によって、クラスターが配置されるクラウドプロバイダーが決まります。

mongodb-atlas-aws

spec.servicePlanExternalName

必要な Atlasインスタンスサイズに対応するKubernetesサービス プラン。

次のコマンドを呼び出して、利用可能なプランを表示します。

svcat marketplace -n <NAMESPACE>

プラン名は、コマンド出力の PLANS 列に表示されます。

M10

spec.regionName

レプリカセットが作成される Atlas リージョン。

重要

目的のリージョンに、クラウドプロバイダーのリージョン名ではなく、Atlas リージョン名を使用していることを確認してください。M2 または M5 クラスターを配置する場合は、選択したリージョンがこれらのクラスター サイズをサポートしていることを確認してください。

利用可能なリージョンのリストについては、クラウドサービス プロバイダーの Atlas ドキュメントを参照してください。

EU_CENTRAL_1

3

（任意）レプリカセット配置の追加設定を構成します。

spec.parameters.cluster キーの下で追加のクラスター設定を指定できます。これらの設定は、 パブリックAPIクラスターの作成 メソッドのリクエスト本文パラメーターに対応します。

重要

次のAPIパラメーターは、前のステップの必須 Atlas Open Service Blocker 設定によって上書きされるため、指定しないでください。

  • providerSettings.instanceSizeName

  • providerSettings.providerName

  • name

例

このリソース定義の例では、atlas名前空間に次の構成を持つ my-atlas-cluster というクラスターを作成します。

  • クラスタースコープの（ClusterServiceBroker）Atlas Open Service Blog によって管理

  • クラウドサービス プロバイダーとしてのAmazon Web Services

  • のインスタンスサイズ M10

  • EU（フランクフルト）リージョン内にあります

  • オートスケーリングが無効

  • Atlas クラウドプロバイダーのスナップショットが有効

apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
  name: my-atlas-cluster
  namespace: atlas
spec:
  clusterServiceClassExternalName: mongodb-atlas-aws
  clusterServicePlanExternalName: M10
  parameters:
    cluster:
      providerSettings:
        regionName: EU_CENTRAL_1
      autoscaling:
        diskGBEnabled: false
      providerBackupEnabled: true

例

このリソース定義の例では、atlas名前空間に次の構成を持つ my-atlas-cluster というクラスターを作成します。

  • 名前空間スコープの（ServiceBroker）Atlas Open Service Blog によって管理

  • クラウドサービス プロバイダーとしてのAmazon Web Services

  • のインスタンスサイズ M10

  • EU（フランクフルト）リージョン内にあります

  • オートスケーリングが無効

  • Atlas クラウドプロバイダーのスナップショットが有効

apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
  name: my-atlas-cluster
  namespace: atlas
spec:
  serviceClassExternalName: mongodb-atlas-aws
  servicePlanExternalName: M10
  parameters:
    cluster:
      providerSettings:
        regionName: EU_CENTRAL_1
      autoscaling:
        diskGBEnabled: false
      providerBackupEnabled: true
4

ファイルをreplica-set.yaml として保存します。

5

レプリカセットを配置します。

次のKubernetesコマンドを呼び出して、レプリカセットを作成します。

kubectl apply -f replica-set.yaml
6

レプリカセットの配置のステータスを追跡します。

配置のステータスを表示するには、metadata.name からのreplica-set.yaml を次のコマンドに渡します。

svcat describe instance <METADATA.NAME> -n <NAMESPACE>

レプリカセットが配置される際、 コマンドは次のステータスを返します。

Provisioning - The instance is being provisioned asynchronously

レプリカセットが正常に配置されると、 コマンドは次のステータスを返します。

Ready - The instance was provisioned successfully

戻る

データベース配置

次へ

シャーディングされたクラスターの配置

項目一覧