View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager 自动化运行手册参考

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

AWSPremiumSupport-ExtendVolumesOnWindows

描述

该AWSPremiumSupport-ExtendVolumesOnWindows运行手册在目标亚马逊弹性计算云 (Amazon EC2) 实例上扩展了亚马逊弹性区块存储 (Amazon EBS) 卷、其分区和文件系统。

重要注意事项

  • 操作影响和交易量状态：Amazon EBS 卷修改分三个阶段进行：modifyingoptimizing、和completed。当卷达到optimizing状态时，这种自动化会继续进行文件系统扩展。在此optimizing状态下，在调整分区大小期间，您可能会遇到暂时的性能影响和潜在的文件系统级中断。您可以监控 Amazon EBS 卷修改的进度。

  • 成本和限制：增加 Amazon EBS 卷大小将导致每月存储成本增加。有关更多信息，请参阅 Amazon EBS 定价。本运行手册创建的备份 AMI 和关联快照将根据其大小和您保存的时间长短产生额外费用。对于某些卷类型，如果您需要在扩展后保持相同的每 GB IOPS 比率，则可能需要修改预配置的 IOPS。

  • 备份和恢复：在对卷进行任何更改之前，运行手册会创建备份 AMI。AMI 和关联的快照不会自动从您的账户中删除。如果不再需要这些备份，则应手动删除这些备份。如果出现故障，可以从相关 AMI 的快照中恢复卷，如使用快照替换 Amazon EBS 卷中所述。

如何工作？

此运行手册执行以下操作：

  • 验证目标实例是否由 Systems Manager 管理并且正在运行 Windows Server

  • 确保只有一次针对当前 Amazon EC2 实例执行此运行手册

  • 从目标实例创建备份 Amazon 系统映像 (AMI)

  • 扩展指定用于扩展的 Amazon EBS 卷

  • 使用命令扩展目标实例上的文件系统 PowerShell

重要

访问AWSPremiumSupport-*运行手册需要订阅 Business + Support、Enterprise Support 或统一运营订阅。有关更多信息，请参阅比较 AWS 支持 计划。

运行此自动化（控制台）

所需的 IAM 权限

AutomationAssumeRole 参数需要执行以下操作才能成功使用运行手册。

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

示例 IAM 策略：


 {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }

说明

按照这些步骤对自动化进行配置：

  1. AWSPremiumSupport-ExtendVolumesOnWindows在 Systems Manager 的 “文档” 下导航至。

  2. 选择 Execute automation（执行自动化）。

  3. 对于输入参数，请输入以下内容：

    • AutomationAssumeRole （可选）：

      • 描述：（可选）允许 Systems Manager Automation 代表您执行操作的 IAM 角色的亚马逊资源名称 (ARN)。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。

      • 类型：AWS::IAM::Role::Arn

    • InstanceId （必填）：

      • 说明：（必需）Amazon EC2 实例的 ID。

      • 类型：String

      • 允许模式：^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize （必填）：

      • 描述：（必填）Amazon EBS 卷将增加的最大大小（以 GiB 为单位）。

      • 类型：String

      • 允许模式：^[0-9]{1,4}$

    • DiagnosticResults （必填）：

      • 描述：（必填）DiagnoseDiskUsage文档中预检脚本的结果，格式为单行 CSV。字符串以开头，EXTEND;后面是每个卷的以逗号分隔的卷信息，卷之间用分号分隔。每个卷的信息包括：卷 ID、驱动器号、扩展标志（1 表示扩展，0 表示跳过）、以 GB 为单位的新大小、 AWS 区域和原因/操作。

      • 类型：String

      • 允许模式：^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. 选择执行。

  5. 自动化启动。

  6. 文档将执行以下步骤：

    • AssertInstanceIsManagedInstance:

      验证目标实例是否由 Systems Manager 管理。

    • DescribeInstance:

      检索目标 Amazon EC2 实例的平台信息。

    • BranchOnPlatform:

      确认目标 Amazon EC2 实例平台是 Windows 服务器。

    • CheckConcurrency:

      确保只有一次针对当前 Amazon EC2 实例执行此运行手册。

    • CreateImage:

      从目标实例创建备份 Amazon 系统映像 (AMI)。

    • WaitUntilImageReady:

      等待 Amazon 系统映像 (AMI) 完成创建并进入available状态。

    • 扩展 EBSVolume：

      扩展指定用于扩展的目标实例的 Amazon EBS 卷。

    • DescribeVolumes:

      描述指定用于扩展的目标实例的 Amazon EBS 卷。

    • ExtendFilesystem:

      使用 PowerShell 命令扩展目标实例的文件系统。

  7. 完成后，请查看 “输出” 部分，了解执行的详细结果。

参考

Systems Manager Automation