Adding an Amazon DocumentDB Instance to a Cluster - Amazon DocumentDB

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Adding an Amazon DocumentDB Instance to a Cluster

新しい Amazon DocumentDB インスタンスは、AWS マネジメントコンソール または AWS CLI を使用して作成できます。クラスタにインスタンスを追加するには、クラスタが available 状態。停止しているクラスターにインスタンスを追加することはできません。クラスタが停止している場合は、クラスタを最初に起動し、クラスタが availableインスタンスを追加します。詳細については、「の停止と開始 Amazon DocumentDB クラスタ」を参照してください。

注記

コンソールを使用して Amazon DocumentDB クラスターを作成した場合、同時にインスタンスが自動的に作成されます。追加のインスタンスを作成する場合は、以下のいずれかの手順を使用します。

Adding an Instance Using the AWS マネジメントコンソール

次の手順に従い、Amazon DocumentDB コンソールを使用してクラスターのインスタンスを作成します。

  1. AWS マネジメントコンソールにサインインして、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。

  2. ナビゲーションペインで [クラスター] を選択します。

    ヒント

    画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。

  3. インスタンスの追加先のクラスターを選択するには、クラスター名の左にあるボタンを選択します。

  4. [アクション] を選択し、[インスタンスの追加] を選択します。

  5. [Add instance to: (インスタンスの追加先:)<cluster-name>] ページで、クラスターに追加する各インスタンスに対して以下の手順を繰り返します。最大数は 15 です。

    1. インスタンス識別子 — このインスタンスの一意の識別子を入力するか、クラスター識別子に基づき Amazon DocumentDB でインスタンスを指定できるようにします。

      インスタンスの名前付けの制約:

      • Length is [1—63] letters, numbers, or hyphens.

      • First character must be a letter.

      • Cannot end with a hyphen or contain two consecutive hyphens.

      • Must be unique for all instances across Amazon RDS, Neptune, and Amazon DocumentDB per AWS account, per Region.

    2. インスタンスタイプ — ドロップダウンリストから、このインスタンスに必要なインスタンスタイプを選択します。

    3. プロモーション階層 — ドロップダウン リストから、インスタンスのプロモーション階層を選択するか、 No preference 許可する Amazon DocumentDB インスタンスのプロモーション階層を設定します。数値が小さいほど優先順位が高くなります。詳細については、「フェイルオーバーターゲットの制御」を参照してください。

    4. インスタンスをさらに追加するには、[Add additional instances (追加のインスタンスを追加する)] を選択してステップ a、b、c を繰り返します。

  6. オペレーションを完了します。

    • To add the instances to your cluster, choose Create.

    • To cancel the operation, choose Cancel.

インスタンスが作成されるまでに数分かかります。インスタンスのステータスを表示するには、コンソールまたは AWS CLI を使用します。詳細については、「インスタンスのステータスのモニタリング」を参照してください。

Adding an Instance Using the AWS CLI

以下のパラメータを指定して create-db-instance AWS CLI オペレーションを使用し、クラスターのプライマリインスタンスを作成します。

  • --db-instance-class — Required. The compute and memory capacity of the instance, for example, db.m4.large. Not all instance classes are available in all AWS Regions.

  • --db-instance-identifier — Required. A string that identifies the instance.

    Instance Naming Constraints:

    • Length is [1—63] letters, numbers, or hyphens.

    • First character must be a letter.

    • Cannot end with a hyphen or contain two consecutive hyphens.

    • Must be unique for all instances across Amazon RDS, Neptune, and Amazon DocumentDB per AWS account, per Region.

  • --engine — Required. Must be docdb.

  • --availability-zone — Optional. The Availability Zone that you want this instance to be created in. Use this parameter to locate your instances in different Availability Zones to increase fault tolerance. For more information, see Amazon DocumentDB 高可用性とレプリケーション.

  • --promotion-tier — Optional. The failover priority tier for this instance. Must be between 0 and 15 with lower numbers being higher priority. For more information, see フェイルオーバーターゲットの制御.

  1. First, determine what Availability Zones you can create your instance in.

    インスタンスを作成する前にアベイラビリティーゾーンを指定する場合は、次のコマンドを実行して Amazon DocumentDB クラスターで使用できるアベイラビリティーゾーンを確認します。

    複数 Linux、macOS、または Unix:

    aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

    複数 Windows:

    aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

    このオペレーションによる出力は、次のようになります。

    [ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ]
  2. Second, determine what instance classes you can create in your Region.

    リージョンで利用可能なインスタンスクラスを確認するには、次のコマンドを実行します。出力から、Amazon DocumentDB クラスターに追加するインスタンスのインスタンスクラスを選択します。

    複数 Linux、macOS、または Unix:

    aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

    複数 Windows:

    aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

    このオペレーションによる出力は、次のようになります。

    [ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ]
  3. Finally, add an instance to your Amazon DocumentDB cluster.

    Amazon DocumentDB クラスターにインスタンスを追加するには、次のコマンドを実行します。

    複数 Linux、macOS、または Unix:

    aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb

    複数 Windows:

    aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb

    このオペレーションによる出力は、次のようになります。

    { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2" } }

インスタンスが作成されるまでに数分かかります。インスタンスのステータスを表示するには、コンソールまたは AWS CLI を使用します。詳細については、「Amazon DocumentDB インスタンスのステータスのモニタリング」を参照してください。