本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
快速入门指南:全球群集
配置
Amazon DocumentDB 全局集群跨越至少两个Amazon Web Services 区域. 主区域支持具有一个主(写入器)实例和最多 15 个副本实例的集群,而辅助区域则运行完全由十六个副本实例组成的只读集群。一个全局集群最多可以有五个辅助区域。该表列出了全局集群中允许的最大集群、实例和副本。
描述 | PrimaryAmazon Web Services 区域 | 辅助Amazon Web Services 区域 |
---|---|---|
集群 | 1 | 5(最大值) |
写入器实例 | 1 | 0 |
每个群集的只读实例(Amazon DocumentDB 副本) | 15(最大值) | 16(合计) |
只读实例(允许的最大值,辅助区域的指定实际数量) | 15 - s | s= 辅助总数Amazon Web Services 区域 |
这些集群有以下特定要求:
-
数据库实例类要求— 您只能使用
db.r5
实例类。 -
Amazon Web Services 区域要求— 主群集必须位于一个区域中,并且必须至少有一个辅助群集位于同一账户的不同区域中。您最多可以创建五个辅助(只读)集群,每个集群必须位于不同的区域中。换句话说,同一个区域中没有两个集群可位于同一个区域中。
-
命名要求— 您为每个集群选择的名称在所有区域中必须唯一。即使不同的集群位于不同的区域中,也不能对它们使用相同的名称。
创建 Amazon DocumentDB 全局集群
准备好构建第一个全球集群了吗? 在本节中,我们将解释如何使用Amazon Web Services Management Console要么Amazon CLI以下说明进行操作。
-
在Amazon Web Services Management Console,导航到Amazon DocumentDB.
-
当您进入 Amazon DocumentDB 控制台时,选择集群.
-
选择 Create (创建)。
-
填写配置的 部分创建 Amazon DocumentDB 集群相应地形成:
-
集群标识符:您可以输入此实例的唯一标识符,或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
-
引擎版本:选择4.0.0
-
实例类:选择db.r5.large
-
实例的数量:选择3.
-
-
在身份验证部分中,填写主用户名和主密码。
-
选择显示高级设置.
-
在网络设置部分:
-
保留默认选项Virtual Private Cloud和子网组.
-
适用于VPC 安全组、默认 VPC应该已将其添加到。
-
类型
DocDB
进入VPC 安全组字段然后选择docDB-入站 (VPC).
-
-
适用于集群选项和静态加密,保留默认选择。
-
适用于备份和日志导出,保留默认选择。
-
适用于维护、标签和删除保护中,保留默认选择。
-
现在点击显示的按钮Create.
要创建 Amazon DocumentDB 区域集群,请调用create-db-cluster
Amazon CLI. 以下Amazon CLI命令创 Amazon DocumentDB 个名为sample-cluster
. 有关删除保护的更多信息,请参阅删除 Amazon DocumentDB 集群.
此外,--engine-version
是默认主引擎最新版本的可选参数。当前的主要引擎版本是4.0.0
. 当新的主要引擎版本发布时,默认引擎版本--engine-version
将更新以反映历时的主要引擎版本。因此,对于生产工作负载,尤其是那些依赖脚本编写、自动化或者的工作负载Amazon CloudFormation模板,建议您明确指定--engine-version
到预期的主要版本。
如果db-subnet-group-name
要么vpc-security-group-id
未指定,Amazon DocumentDB 将使用给定区域的默认子网组和 Amazon VPC 安全组。
对于 Linux、macOS 或 Unix:
aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 4.0.0 \ --deletion-protection \ --master-username masteruser \ --master-user-password password
对于 Windows:
aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 4.0.0 ^ --deletion-protection ^ --master-username masteruser ^ --master-user-password password
此操作的输出将类似于下文(JSON 格式)。
{ "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "4.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "DBClusterIdentifier": "sample-cluster", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb4.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com", "AssociatedRoles": [], "HostedZoneId": "ZNKXTT8WH85VW", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1e" ], "Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com" } }
创建集群需要几分钟时间。您可以使用 Amazon Web Services Management Console或 Amazon CLI 监控集群的状态。有关更多信息,请参阅监控 Amazon DocumentDB 集群的状态。
当您使用Amazon CLI要创建 Amazon DocumentDB 区域集群,则不会创建实例。因此,您必须显式创建主实例和所需的任何副本实例。您可以使用控制台或 Amazon CLI 来创建实例。有关更多信息,请参阅 。将 Amazon DocumentDB 实例添加到集群和CreateDBCluster在 Amazon DocumentDB API 参考中。
当您的区域集群可用后,您可以使用以下说明在另一个区域中添加辅助集群:添加Amazon Web Services 区域转到 Amazon DocumentDB 全球群集. 添加区域时,您的区域集群将成为主集群,并且您选择的区域中有一个新的辅助集群。
添加Amazon Web Services 区域转到 Amazon DocumentDB 全球群集
一个全局群集在与主群集不同的区域中至少需要一个辅助群集,您最多可以添加五个辅助群集。请注意,对于您添加的每个辅助集群,您必须将主集群中允许的副本数量减少一个。例如,如果您的全局集群有五个辅助区域,则主集群只能有 10 个(而不是 15 个)副本。有关更多信息,请参阅 。Amazon DocumentDB 全局集群的配置要求.
-
登录到Amazon Web Services Management Console然后打开 Amazon DocumentDB 控制台。
-
在导航窗格中,选择 Clusters。
-
选择要将辅助集群添加到的集群。确保集群是
Available
. -
选择下拉菜单操作然后选择添加区域.
-
在存储库的添加区域页面中,选择辅助区域。请注意,您不能为同一个全局集群选择已有辅助集群的区域。此外,该区域也不能是主集群所在的同一个区域。如果这是您要添加的第一个区域,则还必须指定自己选择的全局集群标识符。
-
在新区域中填写辅助集群的其余字段,然后选择创建集群. 在您完成区域添加后,您可以在集群中的Amazon Web Services Management Console.
-
使用
create-db-cluster
名称的 CLI 命令(--global-cluster-identifier)
的全局集群。对于其他参数,请执行以下操作:-
适用于
--region
,请选择另一个Amazon Web Services 区域比你的主要地区。 -
选择特定的值
--engine
和--engine-version
参数。 -
对于加密集群,请指定主集群Amazon Web Services 区域作为
--source-region
对于加密。
-
以下示例创建了一个新 Amazon DocumentDB 集群,并将其作为只读辅助集群挂载到全局集群。在最后一步中,实例将添加到新集群。
对于 Linux、macOS 或 Unix:
aws docdb --region secondary_region \ create-db-cluster \ --db-cluster-identifier secondary_cluster_id \ --global-cluster-identifier global_database_id \ --engine-version version aws docdb --region secondary_region \ create-db-instance \ --db-instance-class instance_class \ --db-cluster-identifier secondary_cluster_id \ --db-instance-identifier db_instance_id \
对于 Windows:
aws docdb --region secondary_region ^ create-db-cluster ^ --db-cluster-identifier secondary_cluster_id ^ --global-cluster-identifier global_database_id_id ^ --engine-version version aws docdb --region secondary_region ^ create-db-instance ^ --db-instance-class instance_class ^ --db-cluster-identifier secondary_cluster_id ^ --db-instance-identifier db_instance_id ^
对 Amazon DocumentDB 全局集群使用快照
您可以还原 Amazon DocumentDB 集群的快照,以作为全局集群的起点。为此,您必须还原快照并创建新集群。这将作为全球集群的主集群。然后,您可以向还原的群集添加另一个区域,从而将其转换为全局集群。