向集群添加 Amazon DocumentDB 实例

Using the Amazon Web Services Management Console

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

登录 Amazon Web Services Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com
在导航窗格中，选择集群。

提示
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 ()。
要选择希望将实例添加到的集群，请选择该集群名称左侧的按钮。
选择 Actions (操作)，然后选择 Add instance (添加实例)。
在 Add instance to: (将实例添加到:)<cluster-name> 页面中，对要添加到集群的每个实例重复以下步骤。您最多可以有 15。
1. Instance identifier (实例标识符) - 您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
  
  实例命名约束：
  - 长度为 [1-63] 个字母、数字或连字符。
  - 第一个字符必须是字母。
  - 不能以连字符结束或包含两个连续连字符。
  - 每个区域的亚马逊RDS、Neptune 和 Amazon DocumentDB 上的所有实例都必须是唯一 Amazon Web Services 账户的。
2. Instance class (实例类) - 从下拉列表中，为该实例选择所需的实例类型。
3. Promotion tier (提升层) - 从下拉列表中，选择该实例的提升层，或者选择 No preference (无首选项) 以允许 Amazon DocumentDB 为您的实例设置提升层。数字越小，意味着优先级越高。有关更多信息，请参阅控制故障转移目标。
4. 要添加更多实例，请选择 Add additional instances (添加额外实例)，并重复步骤 a、b 和 c。
完成此操作。
- 要将实例添加到集群，请选择 Create (创建)。
- 要取消操作，请选择取消。

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

Using the Amazon CLI

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

--db-instance-class – 必需。实例的计算和内存容量，例如，db.m4.large。并非所有实例类在所有 Amazon Web Services 区域中都可用。
--db-instance-identifier – 必需。标识实例的一个字符串。

实例命名约束：
- 长度为 [1-63] 个字母、数字或连字符。
- 第一个字符必须是字母。
- 不能以连字符结束或包含两个连续连字符。
- 每个区域的亚马逊RDS、Neptune 和 Amazon DocumentDB 上的所有实例都必须是唯一 Amazon Web Services 账户的。
--engine – 必需。必须是 docdb。
--availability-zone – 可选。要在其中创建此实例的可用区。使用此参数在不同可用区中找到您的实例，以增强容错能力。有关更多信息，请参阅亚马逊 DocumentDB 高可用性和复制性。
--promotion-tier – 可选。此实例的失效转移优先级层。必须介于 0 与 15 之间，数字越小，优先级越高。有关更多信息，请参阅控制故障转移目标。

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

如果要在创建实例前指定可用区，请运行以下命令以确定哪些可用区可用于您的 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"
        ]
    ]
]

其次，确定您可以在您的区域中创建哪些实例类。

要确定您所在区域中可用的实例类，请运行以下命令。从输出中，为要添加到 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"
]

最后，将实例添加到您的 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 实例的状态。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

实例生命周期

描述实例

向集群添加 Amazon DocumentDB 实例

提示