管理弹性集群 - Amazon DocumentDB
修改弹性集群配置监控弹性集群删除弹性集群
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

管理弹性集群

要管理 Amazon DocumentDB 弹性集群，您必须拥有带适当 Amazon DocumentDB 控制层面的 IAM policy略。这些权限使您能够创建、修改和删除集群。亚马逊 DocumentDB FullAccess 策略提供了管理亚马逊 DocumentDB 弹性集群所需的所有权限。

以下主题显示使用 Amazon DocumentDB 弹性集群时如何执行各种任务。

主题

修改弹性集群配置

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 并按照以下说明修改弹性集群。

修改集群的主要用途是通过增加或减少分片数目和/或分片计算容量来扩展分片。

Using the Amazon Web Services Management Console

要使用以下命令修改弹性集群配置 Amazon Web Services Management Console：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择集群。

    提示

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

  3. 在集群标识符列中选择您想要修改的集群的名称。

  4. 选择 Modify(修改)。

  5. 编辑您想要更改的字段，然后选择修改群集。

    图：弹性集群修改
注意

或者，您可以访问修改集群对话框，方法是转到集群页面，选中集群旁边的复选框，选择操作，然后选择修改。

Using the Amazon CLI

要使用修改弹性集群配置 Amazon CLI，请使用带有以下参数的update-cluster操作：

  • --cluster-arn – 必填项。要删除的集群的 ARN 标识符。

  • --shard-capacity—可选。分配给每个分片的 vCPU 的数目。最大值为 64。允许值为 2、4、8、16、32、64。

  • --shard-count—可选。分配给集群的分片的数目。最大值为 32。

  • --shard-instance-计数—可选。应用于此集群中所有分片的副本实例数量。最大值为 16。

  • --auth-type—可选。用于确定从何处获取用于访问弹性集群的密码的身份验证类型。有效类型为 PLAIN_TEXT 和 SECRET_ARN。

  • --admin-user-password—可选。与管理用户关联的密码。

  • --vpc-security-group-ids—可选。配置与这个集群待关联的一系列 Amazon EC2 安全组和 Amazon VPC (VPC) 安全组。

  • --preferred-maintenance-window—可选。配置可进行系统维护的每周时间范围（采用通用协调时间（UTC））

    格式为：ddd:hh24:mi-ddd:hh24:mi。有效值 (ddd)：Mon、Tue、Wed、Thu、Fri、Sat、Sun

    默认值为每个 Amazon Web Services 区域 8 小时的时间段中随机选择的 30 分钟时段（随机选取周中的某天进行）。

    至少 30 分钟的窗口。

  • --subnet-ids—可选。配置网络子网 ID。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic update-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
    --shard-capacity 8 \
    --shard-count 4 \
    --shard-instance-count 3 \
    --admin-user-password testPassword \
    --vpc-security-group-ids ec-65f40350 \
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

对于 Windows：

aws docdb-elastic update-cluster ^
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
    --shard-capacity 8 ^
    --shard-count 4 ^
    --shard-instance-count 3 ^
    --admin-user-password testPassword ^
    --vpc-security-group-ids ec-65f40350 ^
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

要在修改后监控弹性集群的状态，请参阅监控弹性集群。

监控弹性集群

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 以及以下说明监控您的弹性集群。

Using the Amazon Web Services Management Console

要使用以下方法监控弹性集群配置 Amazon Web Services Management Console：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择集群。

    提示

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

  3. 在集群标识符列中选择您想要监控的集群的名称。

  4. 选择监控选项卡。

    图：弹性集群监控

Amazon CloudWatch 为以下监控类别显示了许多图表：

  • 资源利用率

  • 吞吐量

  • 延迟

  • 操作

  • 系统

您也可以 CloudWatch 通过访问 Amazon Amazon Web Services Management Console ，为您的弹性集群设置自己的监控环境。

Using the Amazon CLI

要使用监控特定的弹性集群配置 Amazon CLI，请使用带有以下参数的get-cluster操作：

  • --cluster-arn – 必填项。要获取其信息的集群的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic get-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

对于 Windows：

aws docdb-elastic get-cluster ^
    --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

此操作的输出将类似于以下内容：

"cluster": {
        ...
        "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
        "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
        "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
        "clusterName": "stretch-11",     
        "shardCapacity": 2,
        "shardCount": 3,
        "shardInstanceCount: 5,
        "status": "ACTIVE",
        ...
 }

有关更多信息，请参阅 Amazon DocumentDB 资源管理 API 参考中的 DescribeClusterSnapshot。

要使用查看所有弹性集群的详细信息 Amazon CLI，请使用带有以下参数的list-clusters操作：

  • --next-token—可选。如果项目输出的数量 (--max-results) 少于基础 API 调用所返回的项目总数，则输出将包含您可传递到后续命令的 NextToken 以检索下一组项目。

  • --max-results—可选。命令的输出中要返回的项目总数。如果存在的记录数超过了指定的max-results 值，则在响应中包含分页记号（next-token），以便检索剩余的结果。

    • 默认值：100

    • 最小值 20，最大值 100

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic list-clusters \
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
    --max-results 2

对于 Windows：

aws docdb-elastic list-clusters ^
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
    --max-results 2

此操作的输出将类似于以下内容：

{
   "Clusters": [
      {
         "ClusterIdentifier":"mycluster-1",
         "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
       {
         "ClusterIdentifier":"mycluster-2",
         "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
   ] 
}

删除弹性集群

在本节中，我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 以及以下说明删除弹性集群。

Using the Amazon Web Services Management Console

要使用 Amazon Web Services Management Console 删除弹性集群配置：

  1. 登录 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台。

  2. 在导航窗格中，选择集群。

    提示

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

  3. 在集群列表表中，选择在您想要删除的集群名称左侧的复选框，然后选择操作。从下拉菜单中，选择删除。

  4. 在是否删除“集群名称” 弹性集群？对话框中，选择删除。

    图：弹性集群修改

删除集群需要几分钟时间。要监控集群的状态，请参阅 监控 Amazon DocumentDB 集群的状态。

Using the Amazon CLI

要使用删除弹性集群 Amazon CLI，请使用带有以下参数的delete-cluster操作：:

  • --cluster-arn – 必填项。要删除的集群的 ARN 标识符。

  • --no-skip-final-backup—可选。如果您需要最终备份，则必须包含该参数和最终备份的名称。必须包含 --final-backup-identifier 或 --skip-final-backup。

  • --skip-final-backup—可选。仅当您不想在删除集群之前拍摄最终备份时，才使用此参数。默认设置是拍摄最终快照。

以下 Amazon CLI 代码示例删除 ARN 为 arn: aws: docdb: us-west-2:123456789012: sharded-cluster: sample-cluster 的集群，并进行最终备份。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --no-skip-final-backup \
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

对于 Windows：

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --no-skip-final-backup ^
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

以下 Amazon CLI 代码示例在不进行最终备份的情况下删除 ARN 为 arn: aws: docdb: us-west-2:123456789012: sharded-cluster: sample-cluster 的集群。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 Linux、macOS 或 Unix：

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --skip-final-backup \

对于 Windows：

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --skip-final-backup ^

delete-cluster 操作的输出是您要删除的集群的展示。

删除集群需要几分钟时间。要监控集群的状态，请参阅 监控 Amazon DocumentDB 集群的状态。