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

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

将 Amazon DocumentDB 实例添加到集群

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

注意

如果您使用控制台创建 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 实例的状态