オンデマンドパッチ | 実行 - AMS アドバンスト変更タイプリファレンス

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

オンデマンドパッチ | 実行

指定されたインスタンスでオンデマンド SSM パッチ適用を実行します。指定したタグ/キーペアを持つインスタンスのリスト。

完全分類: 管理 | パッチ適用 | オンデマンドパッチ適用 | 実行

変更タイプの詳細

変更タイプ ID

ct-3oy53m1qzl2s5

現在のバージョン

1.0

予想される実行期間

3600 分

AWS の承認

必須

お客様の承認

不要

実行モード

自動

追加情報

オンデマンドパッチ適用を実行する

AMS コンソールでのこの変更タイプのスクリーンショット:

On Demand Patching details showing description, ID, and version for SSM patching on instances.

仕組み:

  1. RFC の作成ページに移動します。AMS コンソールの左側のナビゲーションペインでRFCs をクリックして RFCsリストページを開き、RFC の作成をクリックします。

  2. デフォルトの変更タイプ参照ビューで一般的な変更タイプ (CT) を選択するか、カテゴリ別選択ビューで CT を選択します。

    • 変更タイプ別に参照: クイック作成エリアで一般的な CT をクリックすると、すぐに RFC の実行ページを開くことができます。クイック作成で古い CT バージョンを選択することはできません。

      CTs をソートするには、カードビューまたはテーブルビューですべての変更タイプ領域を使用します。どちらのビューでも、CT を選択し、RFC の作成をクリックして RFC の実行ページを開きます。必要に応じて、RFC の作成ボタンの横に古いバージョンで作成オプションが表示されます。

    • カテゴリ別に選択: カテゴリ、サブカテゴリ、項目、オペレーションを選択すると、CT 詳細ボックスが開き、必要に応じて古いバージョンで作成するオプションが表示されます。RFC の作成をクリックして、RFC の実行ページを開きます。

  3. RFC の実行ページで、CT 名エリアを開き、CT の詳細ボックスを表示します。件名は必須です (変更タイプの参照ビューで CT を選択した場合は入力されます)。追加設定エリアを開き、RFC に関する情報を追加します。

    実行設定領域で、使用可能なドロップダウンリストを使用するか、必要なパラメータの値を入力します。オプションの実行パラメータを設定するには、追加設定エリアを開きます。

  4. 完了したら、実行 をクリックします。エラーがない場合、RFC が正常に作成されたページに、送信された RFC の詳細と最初の実行出力が表示されます。

  5. Run parameters エリアを開き、送信した設定を確認します。ページを更新して RFC 実行ステータスを更新します。必要に応じて、RFC をキャンセルするか、ページ上部のオプションを使用してコピーを作成します。

仕組み:

  1. インライン作成 (すべての RFC と実行パラメータを含むcreate-rfcコマンドを発行) またはテンプレート作成 (2 つの JSON ファイルを作成し、1 つは RFC パラメータ用、もう 1 つは実行パラメータ用) のいずれかを使用し、2 つのファイルを入力としてcreate-rfcコマンドを発行します。どちらの方法もここで説明します。

  2. 返された RFC ID を使用して RFC: aws amscm submit-rfc --rfc-id ID コマンドを送信します。

    RFC: aws amscm get-rfc --rfc-id ID コマンドをモニタリングします。

変更タイプのバージョンを確認するには、次のコマンドを使用します。

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
注記

変更タイプのスキーマの一部であるかどうかにかかわらず、任意の RFC で任意のCreateRfcパラメータを使用できます。たとえば、RFC ステータスが変更されたときに通知を受け取るには、リクエストの RFC パラメータ部分 (実行パラメータではなく) --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"にこの行を追加します。すべての CreateRfc パラメータのリストについては、AMS 変更管理 API リファレンスを参照してください。

インライン作成

インラインで指定された実行パラメータ (インラインで実行パラメータを指定する場合は引用符をエスケープ) を指定して create RFC コマンドを発行し、返された RFC ID を送信します。たとえば、コンテンツを次のような内容に置き換えることができます。

aws amscm create-rfc --title my-test-patchbaseline --change-type-id ct-3oy53m1qzl2s5 --change-type-version 1.0 --execution-parameters '{"Name":"test-ODP","PatchingTargets":[{"Key":"tag:Patch Group","Values":"[test-odp]"}],"StartInactiveInstances":"True", "BackupVaultName":"test-backup-vault-name", "BackupIamRole":"test-backup-iam-role", "BackupRetentionInDays":"10"}'

テンプレートの作成

  1. この変更タイプの実行パラメータ JSON スキーマを JSON ファイルに出力します。この例では RunOndemandPatchParams.json:

    aws amscm get-change-type-version --change-type-id "ct-3oy53m1qzl2s5" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > RunOndemandPatchParams.json
  2. RunOndemandPatchParams ファイルを変更して保存します。

    { "Name": "test-ODP", "PatchingTargets": [ { "Key": "InstanceIds", "Values": ["INSTANCE_ID"] } ], "StartInactiveInstances": "True", "BackupVaultName": "test-backup-vault-name", "BackupIamRole": "test-backup-iam-role", "BackupRetentionInDays": "10" }
  3. RFC テンプレートを現在のフォルダ内のファイルに出力します。この例では RunOndemandPatchRfc.json:

    aws amscm create-rfc --generate-cli-skeleton > RunOndemandPatchRfc.json
  4. RunOndemandPatchRfc.json ファイルを変更して保存します。たとえば、コンテンツを次のような内容に置き換えることができます。

    { "ChangeTypeVersion": "1.0", "ChangeTypeId": "ct-3oy53m1qzl2s5", "Title": "Run-Ondemand-Patch-RFC" }
  5. RunOndemandPatchRfc ファイルと RunOndemandPatchParams ファイルを指定して、RFC を作成します。

    aws amscm create-rfc --cli-input-json file://RunOndemandPatchRfc.json --execution-parameters file://RunOndemandPatchParams.json

    レスポンスで新しい RFC の ID を受け取り、それを使用して RFC を送信およびモニタリングできます。送信するまで、RFC は編集状態のままであり、開始されません。

非アクティブなインスタンス

StartInactiveInstancesTrue に設定すると、非アクティブなインスタンスが開始され、パッチが適用され、パッチ適用が完了した後に元の停止状態に戻ります。

同時実行数の制限

メンテナンスウィンドウを同時に実行すると、この RFC の安全制限の実行に影響します。これは、SSM オートメーションがアカウントあたり 100 回の同時実行に制限されているためです。同時実行数の制限を超えるオートメーションは、最大 1,000 実行のキューに追加されます。メンテナンスウィンドウが 50 個のインスタンスで実行されている場合、オンデマンドパッチ適用の同時実行の余地は 50 個のみです。進行中の実行が完了したら、キューに追加のインスタンスを追加して実行します。

AMS パッチオーケストレーターと SSM パッチベースラインとパッチウィンドウの設定の詳細については、「AMS マルチアカウントランディングゾーンユーザーガイド」の「パッチオーケストレーター」を参照してください。

実行入力パラメータ

実行入力パラメータの詳細については、「」を参照してください変更タイプ ct-3oy53m1qzl2s5 のスキーマ

例: 必須パラメータ

Example not available.

例: すべてのパラメータ

{ "Description": "description", "Name": "Test1", "PatchingTargets": [ { "Key": "tag:Patch Group", "Values": [ "testGroup" ] } ], "StartInactiveInstances": "True", "BackupVaultName": "backup-vault-name", "BackupIamRole": "backup-iam-role", "BackupRetentionInDays": "1" }