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

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

将 Amazon DocumentDB 实例添加到集群

您可以使用 Amazon DocumentDB或 AWS 管理控制台 创建一个新 AWS CLI 实例。要将实例添加到集群,该集群必须处于可用 状态。您无法将实例添加到已停止的集群。如果集群已停止,则首先启动集群,等待集群进入可用 状态,然后添加实例。有关更多信息,请参阅停止和启动 Amazon DocumentDB 集群

注意

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

使用 AWS 管理控制台添加实例

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

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台:https://console.amazonaws.cn/docdb

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

    提示

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

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

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

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

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

      实例命名约束:

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

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

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

      • 对于每个区域、每个 AWS 账户的所有实例(跨 Amazon RDS、Neptune 和 Amazon DocumentDB)必须是唯一的。

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

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

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

  6. 完成此操作。

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

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

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

使用 AWS CLI添加实例

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

  • --db-instance-class — 必需。实例的计算和内存容量,例如,db.m4.large。并非所有实例类在所有 AWS 区域中都可用。

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

    实例命名约束:

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

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

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

    • 对于每个区域、每个 AWS 账户的所有实例(跨 Amazon RDS、Neptune 和 Amazon DocumentDB)必须是唯一的。

  • --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" } }

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