View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Automation Runbook 參考

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWSPremiumSupport-ExtendVolumesOnWindows

Description

AWSPremiumSupport-ExtendVolumesOnWindows Runbook 會在目標 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上擴展 Amazon Elastic Block Store (Amazon EBS) 磁碟區、其分割區和檔案系統。

重要考量

  • 操作影響和磁碟區狀態：Amazon EBS 磁碟區修改分為三個階段：modifying、 optimizing和 completed。當磁碟區達到 optimizing 狀態時，此自動化會繼續進行檔案系統延伸。在 optimizing 狀態期間，您可能會在分割區調整大小期間遇到暫時效能影響和潛在的檔案系統層級中斷。您可以監控 Amazon EBS 磁碟區修改的進度。

  • 成本和限制：增加 Amazon EBS 磁碟區大小會導致更高的每月儲存成本。如需詳細資訊，請參閱 Amazon EBS 定價。此 Runbook 建立的備份 AMI 和相關聯的快照，會根據其大小和保留時間長度而產生額外費用。對於某些磁碟區類型，如果您在擴展後需要維持相同的每 GB IOPS 比率，您可能需要修改佈建的 IOPS。

  • 備份與復原：執行手冊會先建立備份 AMI，再對磁碟區進行任何變更。AMI 和相關聯的快照不會自動從您的帳戶中移除。如果不再需要，您應該手動移除這些備份。如果失敗，可以從相關聯 AMI 的快照復原磁碟區，如使用快照取代 Amazon EBS 磁碟區中所述。

如何運作？

此 Runbook 會執行下列操作：

  • 驗證目標執行個體是由 Systems Manager 管理，且正在執行 Windows Server

  • 確保只有一個針對目前 Amazon EC2 執行個體的 Runbook 執行

  • 從目標執行個體建立備份 Amazon Machine Image (AMI)

  • 擴展指定用於擴展的 Amazon EBS 磁碟區

  • 使用 PowerShell 命令擴展目標執行個體上的檔案系統

重要

存取 AWSPremiumSupport-* Runbook 需要 Business + Support、Enterprise Support 或 Unified Operations Subscription。如需詳細資訊，請參閱比較 AWS 支援 計劃。

執行此自動化 （主控台）

必要的 IAM 許可

AutomationAssumeRole 參數需要下列動作才能成功使用 Runbook。

  • 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. 在文件下的 Systems Manager AWSPremiumSupport-ExtendVolumesOnWindows中導覽至 。

  2. 選擇 Execute automation (執行自動化)。

  3. 針對輸入參數，輸入下列內容：

    • AutomationAssumeRole （選用）：

      • 描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 IAM 角色的 Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 之使用者的許可。

      • 類型：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 Server。

    • CheckConcurrency：

      確保只有一個針對目前 Amazon EC2 執行個體的 Runbook 執行。

    • CreateImage：

      從目標執行個體建立備份 Amazon Machine Image (AMI)。

    • WaitUntilImageReady：

      等待 Amazon Machine Image (AMI) 完成建立並達到 available 狀態。

    • ExtendEBSVolume：

      擴展指定用於擴展之目標執行個體的 Amazon EBS 磁碟區。

    • DescribeVolumes：

      描述指定用於擴展之目標執行個體的 Amazon EBS 磁碟區。

    • ExtendFilesystem：

      使用 PowerShell 命令擴展目標執行個體的檔案系統。

  7. 完成後，請檢閱輸出區段以取得執行的詳細結果。

參考

Systems Manager Automation