View a markdown version of this page

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

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

AWSPremiumSupport-ExtendVolumesOnLinux

描述

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

重要注意事项

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

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

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

如何工作？

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

  • 验证目标实例是否由系统管理器管理并且正在运行 Linux

  • 确保本运行手册仅针对当前 Amazon EC2 实例执行一次

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

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

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

重要

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

运行此自动化（控制台）

文档类型

自动化

所有者

Amazon

平台

Linux

参数

所需的 IAM 权限

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

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

示例 IAM 策略：


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

说明

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

  1. 在 “系统管理器” AWSPremiumSupport-ExtendVolumesOnLinux 中的 “文档” 下打开。

  2. 选择执行自动化。

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

    • AutomationAssumeRole （可选）：

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

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

    • InstanceId （必填）：

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

      • 类型：String

      • 允许图案：^i-[a-z0-9]{8,17}$

    • VolumeExpansionCapSize （必填）：

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

      • 类型：String

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

    • DiagnosticResults （必填）：

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

      • 类型：String

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

  4. 选择执行。

  5. 自动化启动。

  6. 运行手册执行以下步骤：

    • AssertInstanceIsManagedInstance:

      验证目标实例是否由系统管理器管理。

    • DescribeInstance:

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

    • BranchOnPlatform:

      确认目标亚马逊 EC2 实例平台是 Linux。

    • CheckConcurrency:

      确保本运行手册仅针对当前 Amazon EC2 实例执行一次。

    • CreateImage:

      从目标实例创建备份的亚马逊系统映像 (AMI)。

    • WaitUntilImageReady:

      等待亚马逊系统映像 (AMI) 完成创建并达到available状态。

    • 扩展 B SVolume：

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

    • DescribeVolumes:

      描述连接到目标实例的 Amazon EBS 卷。

    • ExtendFilesystem:

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

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

参考

Systems Manager Automation