将 Amazon DocumentDB 实例添加到集群 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

将 Amazon DocumentDB 实例添加到集群

您可以使用Amazon Web Services Management Console或Amazon CLI. 要将实例添加到集群,该集群必须处于可用 状态。您无法将实例添加到已停止的集群。如果集群已停止,则首先启动集群,等待集群进入可用 状态,然后添加实例。有关更多信息,请参阅 停止和启动 Amazon DocumentDB 集群

注意

如果您使用控制台创建 Amazon DocumentDB 集群,则会同时自动为您创建实例。如果您要创建其他实例,请使用以下过程之一。

使用 Amazon Web Services Management Console添加实例

使用以下过程使用 Amazon DocumentDB 控制台为您的集群创建实例。

  1. 登录到Amazon Web Services Management Console,然后打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb.

  2. 在导航窗格中,选择 Clusters

    提示

    如果您在屏幕左侧没有看到导航窗格,请在页面左上角选择菜单图标 ()。

  3. 要选择希望将实例添加到的集群,请选择该集群名称左侧的按钮。

  4. 选择 Actions (操作),然后选择 Add instance (添加实例)

  5. Add instance to: (将实例添加到:)<cluster-name> 页面中,对要添加到集群的每个实例重复以下步骤。您最多可以有 15 个。

    1. 实例标识符— 您可以输入此实例的唯一标识符,或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。

      实例命名约束:

      • 长度为 [1—63] 个字母、数字或连字符。

      • 第一个字符必须是字母。

      • 不能以连字符结束或包含两个连续连字符。

      • 对于每个 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有实例,必须是唯一的。 Amazon Web Services 账户 每个区域。

    2. 实例类— 从下拉列表中,为该实例选择所需的实例类型。

    3. 提升层— 从下拉列表中,为您的实例选择提升层,或从无首选项以允许 Amazon DocumentDB 为您的实例设置促销套餐。数字越小,意味着优先级越高。有关更多信息,请参阅 控制故障转移目标

    4. 要添加更多实例,请选择 Add additional instances (添加额外实例),并重复步骤 a、b 和 c。

  6. 完成此操作。

    • 要将实例添加到集群,请选择 Create (创建)

    • 要取消操作,请选择取消

创建实例需要几分钟时间。您可以使用控制台或 Amazon CLI 查看实例的状态。有关更多信息,请参阅 监控 实例的状态

使用 Amazon CLI添加实例

create-db-instance Amazon CLI 操作与以下参数一起使用,为您的集群创建主实例。

  • --db-instance-class – 必需。实例的计算和内存容量,例如,db.m4.large。并非所有实例类在所有 Amazon Web Services 区域 .

  • --db-instance-identifier – 必需。标识实例的一个 字符串。

    实例命名约束:

    • 长度为 [1—63] 个字母、数字或连字符。

    • 第一个字符必须是字母。

    • 不能以连字符结束或包含两个连续连字符。

    • 对于每个 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有实例,必须是唯一的。 Amazon Web Services 账户 每个区域。

  • --engine – 必需。必须是 docdb

  • --availability-zone— 可选。要在其中创建此实例的可用区。使用此参数在不同可用区中找到您的实例,以增强容错能力。有关更多信息,请参阅 Amazon DocumentDB 高可用性和复制

  • --promotion-tier— 可选。此实例的故障转移优先级层。必须介于 0 与 15 之间,数字越小,优先级越高。有关更多信息,请参阅 控制故障转移目标

  1. 首先,确定您可以在哪些可用区中创建您的实例。

    如果要在创建实例前指定可用区,请运行以下命令确定哪些可用区可用于您的 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. 其次,确定您可以在您的区域中创建哪些实例类。

    要确定您所在区域中可用的实例类,请运行以下命令。从输出中,为要添加到 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. 最后,将实例添加到 Amazon DocumentDB 集群。

    要将实例添加到 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" } }

创建实例需要几分钟时间。您可以使用控制台或 Amazon CLI 查看实例的状态。有关更多信息,请参阅 监控 Amazon DocumentDB 实例的状态