View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSPremiumSupport-ExtendVolumesOnWindows

説明

AWSPremiumSupport-ExtendVolumesOnWindows ランブックは、ターゲット Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの Amazon Elastic Block Store (Amazon EBS) ボリューム、パーティション、ファイルシステムを拡張します。

重要な考慮事項

  • オペレーションの影響とボリュームの状態: Amazon EBS ボリュームの変更は、modifying、、optimizingおよび の 3 つのフェーズで行われますcompleted。ボリュームが optimizing状態になると、この自動化はファイルシステム拡張子で続行されます。optimizing 状態では、パーティションのサイズ変更中に一時的なパフォーマンスへの影響やファイルシステムレベルの中断が発生する可能性があります。Amazon EBS ボリュームの変更の進行状況をモニタリングできます。

  • コストと制限: Amazon EBS ボリュームサイズを大きくすると、毎月のストレージコストが高くなります。詳細については、「Amazon EBS の料金」を参照してください。このランブックによって作成されたバックアップ AMI および関連するスナップショットには、サイズと保持期間に基づいて追加料金が発生します。一部のボリュームタイプでは、拡張後に GB あたりの IOPS 比率を同じにする必要がある場合、プロビジョニングされた IOPS を変更する必要がある場合があります。

  • バックアップとリカバリ: ランブックは、ボリュームに変更を加える前にバックアップ AMI を作成します。AMI および関連するスナップショットは、アカウントから自動的に削除されません。これらのバックアップが不要になった場合は、手動で削除する必要があります。障害が発生した場合は、「スナップショットを使用して Amazon EBS ボリュームを置き換える」の説明に従って、関連付けられた AMI のスナップショットからボリュームを復元できます。

動作の仕組み

このランブックは次のオペレーションを実行します。

  • ターゲットインスタンスが Systems Manager によって管理され、Windows Server が実行されていることを確認します。

  • 現在の Amazon EC2 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します

  • ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。

  • 拡張用に指定された Amazon EBS ボリュームを拡張します

  • PowerShell コマンドを使用してターゲットインスタンスのファイルシステムを拡張します

重要

AWSPremiumSupport-* ランブックにアクセスするには、Business + Support、Enterprise Support、または Unified Operations Subscription が必要です。詳細については、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. ドキュメントの Systems Manager AWSPremiumSupport-ExtendVolumesOnWindowsで に移動します。

  2. [Execute automation] (オートメーションを実行) を選択します。

  3. 入力パラメータには、次のように入力します。

    • AutomationAssumeRole（オプション):

      • 説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする IAM ロールの Amazon リソースネーム (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 (必須):

      • 説明: (必須) 1 行 CSV 形式のDiagnoseDiskUsageドキュメントの事前チェックスクリプトの結果。文字列は で始まり、ボリュームごとにカンマ区切りのボリューム情報が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 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します。

    • CreateImage:

      ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。

    • WaitUntilImageReady:

      Amazon マシンイメージ (AMI) の作成が完了し、 available状態になるまで待ちます。

    • ExtendEBSVolume:

      拡張用に指定されたターゲットインスタンスの Amazon EBS ボリュームを拡張します。

    • DescribeVolumes:

      拡張用に指定されたターゲットインスタンスの Amazon EBS ボリュームについて説明します。

    • ExtendFilesystem:

      PowerShell コマンドを使用して、ターゲットインスタンスのファイルシステムを拡張します。

  7. 完了したら、出力セクションで実行の詳細な結果を確認します。

リファレンス

Systems Manager Automation