`AWSPremiumSupport-ExtendVolumesOnLinux`

説明

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

動作の仕組み

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

ターゲットインスタンスが Systems Manager によって管理され、Linux が実行されていることを確認します。
現在の Amazon EC2 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します
ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。
拡張用に指定された Amazon EBS ボリュームを拡張します
シェルスクリプトコマンドを使用してターゲットインスタンスのファイルシステムを拡張します

重要

AWSPremiumSupport-* ランブックにアクセスするには、Business + Support、Enterprise Support、または Unified Operations Subscription が必要です。詳細については、AWS サポートプランの比較を参照してください。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

オートメーション

[所有者]

Amazon

[Platforms] (プラットフォーム)

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": "*"
         }
     ]
 }

指示

次の手順に従って自動化を設定します。

Systems Manager のドキュメントで AWSPremiumSupport-ExtendVolumesOnLinux を開きます。
[Execute automation (自動化の実行)] を選択してください。
入力パラメータには、次のように入力します。
- AutomationAssumeRole（オプション):
  - 説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
  - 型: AWS::IAM::Role::Arn
- InstanceId (必須):
  - 説明: (必須) Amazon EC2 インスタンスの ID。
  - 型: String
  - 許可パターン: ^i-[a-z0-9]{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}$
[実行] を選択してください。
自動化が開始されます。
ランブックは次のステップを実行します。
- AssertInstanceIsManagedInstance:
  
  ターゲットインスタンスが Systems Manager によって管理されていることを確認します。
- DescribeInstance:
  
  ターゲット Amazon EC2 インスタンスPlatformの情報を取得します。
- BranchOnPlatform:
  
  ターゲット Amazon EC2 インスタンスプラットフォームが Linux であることを確認します。
- CheckConcurrency:
  
  現在の Amazon EC2 インスタンスを対象とするこのランブックの実行が 1 つだけであることを確認します。
- CreateImage:
  
  ターゲットインスタンスからバックアップ Amazon マシンイメージ (AMI) を作成します。
- WaitUntilImageReady:
  
  Amazon マシンイメージ (AMI) の作成が完了し、 available状態になるまで待ちます。
- ExtendEBSVolume:
  
  拡張用に指定されたターゲットインスタンスの Amazon EBS ボリュームを拡張します。
- DescribeVolumes:
  
  ターゲットインスタンスにアタッチされた Amazon EBS ボリュームについて説明します。
- ExtendFilesystem:
  
  シェルスクリプトコマンドを使用して、ターゲットインスタンスのファイルシステムを拡張します。
完了したら、出力セクションで実行の詳細な結果を確認します。

リファレンス

Systems Manager Automation

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWSSupport-EnableWindowsEC2SerialConsole

AWSPremiumSupport-ExtendVolumesOnWindows