AWS Systems Manager
ユーザーガイド

コンソールからコマンドを実行する

コンソールから Run Command を使用して、各インスタンスにログインせずにインスタンスを設定できます。このトピックでは、Run Command を使用してインスタンスで SSM エージェント を更新する方法の例を示します。

開始する前に

Run Command を使用してコマンドを送信する前に、インスタンスが Systems Manager の要件を満たすことを確認します。

Run Command を使用してコマンドを送信するには

  1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

  2. ナビゲーションペインで、[Run Command] を選択します。

    -または-

    AWS Systems Manager ホームページが最初に開く場合は、メニューアイコン ( ) を選択してナビゲーションペインを開き、[Run Command] を選択します。

  3. [Command document (コマンドのドキュメント)] リストで、Systems Manager ドキュメントを選択します。

  4. [ターゲット] セクションで、手動でタグを指定するかインスタンスを選択することにより、スクリプトをダウンロードおよび実行するインスタンスを指定します。

    注記

    インスタンスを手動で選択することにしたが、そのインスタンスがリストに表示されない場合、トラブルシューティングのヒントについては、「インスタンスの場所」を参照してください。

  5. [Command parameters] セクションで、必須パラメータの値を指定します。

  6. [Other parameters] で、次のようにしています。

    • [Comment] ボックスに、このコマンドに関する情報を入力します。

    • [Timeout (seconds)] に、コマンドの実行全体を失敗とするまでにシステムが待機する秒数を指定します。

  7. (オプション) [Rate control] で、次のように設定します。

    • [Concurrency] で、コマンドを同時に実行するインスタンスの数または割合 (%) を指定します。

      注記

      Amazon EC2 タグを選択してターゲットを選択し、選択したタグを使用するインスタンスの数が不明な場合は、同時に割合 (%) を指定してドキュメントを実行できるインスタンスの数を制限します。

    • [Error threshold] で、インスタンスの数または割合 (%) で失敗した後で他のインスタンスでのコマンドの実行をいつ停止するか指定します。たとえば、3 つのエラーを指定した場合、4 番目のエラーが受信されると、Systems Manager はコマンドの送信を停止します。コマンドを処理しているインスタンスもエラーを送信する可能性があります。

  8. [Output options] セクションで、コマンド出力をファイルに保存する場合は、[Write command output to an Amazon S3 bucket] を選択します。ボックスにバケット名とプレフィックス名 ()フォルダー を入力します。

    注記

    S3 バケットにデータを書き込む機能を許可する S3 アクセス許可は、このタスクを実行する IAM ユーザーのものではなく、インスタンスに割り当てられたインスタンスプロファイルのものです。詳細については、「Systems Manager のアクセス設定」を参照してください。

  9. [SNS Notifications] セクションで、コマンドの実行状態に関する通知を受け取る場合は、[Enable SNS notifications] チェックボックスをオンにします。

    コマンドの実行の Amazon SNS 通知の設定の詳細については、「Run Command のための Amazon SNS 通知を設定する」を参照してください。

  10. [Run] を選択します。

コマンドのキャンセルの詳細については、コマンドをキャンセルする を参照してください。

Run Command を使用して SSM エージェント を更新する

以下の手順は、Windows と Linux インスタンスで実行されている SSM エージェント をすばやく更新する方法について説明しています。最新バージョンに更新することも、古いバージョンにダウングレードすることもできます。コマンドを実行すると、システムは該当するバージョンを AWS からダウンロードし、インストールして、コマンドの実行前に存在していたバージョンをアンインストールします。このプロセスの実行中にエラーが発生すると、システムはコマンドの実行前のサーバーバージョンにロールバックし、コマンドステータスにはコマンドの失敗が示されます。

Run Command を使用して SSM エージェント を更新するには

  1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

  2. ナビゲーションペインで、[Run Command] を選択します。

    -または-

    AWS Systems Manager ホームページが最初に開く場合は、メニューアイコン ( ) を選択してナビゲーションペインを開き、[Run Command] を選択します。

  3. [Command document] リストで、AWS-UpdateSSMAgent を選択します。

  4. [ターゲット] セクションで、手動でタグを指定するかインスタンスを選択することにより、スクリプトをダウンロードおよび実行するインスタンスを指定します。

    注記

    インスタンスを手動で選択することにしたが、そのインスタンスがリストに表示されない場合、トラブルシューティングのヒントについては、「インスタンスの場所」を参照してください。

  5. [Command parameters] セクションで、必要に応じて以下のパラメータの値を指定します。

    1. (オプション) [Version (バージョン)] に、インストールする SSM エージェント のバージョンを入力します。エージェントの古いバージョンをインストールすることもできます。バージョンを指定しないと、サービスは最新バージョンをインストールします。

    2. (オプション) 以前のバージョンの SSM エージェント をインストールするには、[Allow Downgrade (ダウングレードの許可)] で [true] を選択します。このオプションを選択した場合は、以前のバージョン番号を指定する必要があります。[false] を選択すると、最新バージョンのサービスのみがインストールされます。

  6. [Other parameters] で、次のようにしています。

    • [Comment] ボックスに、このコマンドに関する情報を入力します。

    • [Timeout (seconds)] に、コマンドの実行全体を失敗とするまでにシステムが待機する秒数を指定します。

  7. (オプション) [Rate control] で、次のように設定します。

    • [Concurrency] で、コマンドを同時に実行するインスタンスの数または割合 (%) を指定します。

      注記

      Amazon EC2 タグを選択してターゲットを選択し、選択したタグを使用するインスタンスの数が不明な場合は、同時に割合 (%) を指定してドキュメントを実行できるインスタンスの数を制限します。

    • [Error threshold] で、インスタンスの数または割合 (%) で失敗した後で他のインスタンスでのコマンドの実行をいつ停止するか指定します。たとえば、3 つのエラーを指定した場合、4 番目のエラーが受信されると、Systems Manager はコマンドの送信を停止します。コマンドを処理しているインスタンスもエラーを送信する可能性があります。

  8. [Output options] セクションで、コマンド出力をファイルに保存する場合は、[Write command output to an Amazon S3 bucket] を選択します。ボックスにバケット名とプレフィックス名 ()フォルダー を入力します。

    注記

    S3 バケットにデータを書き込む機能を許可する S3 アクセス許可は、このタスクを実行する IAM ユーザーのものではなく、インスタンスに割り当てられたインスタンスプロファイルのものです。詳細については、「Systems Manager のアクセス設定」を参照してください。

  9. [SNS Notifications] セクションで、コマンドの実行状態に関する通知を受け取る場合は、[Enable SNS notifications] チェックボックスをオンにします。

    コマンドの実行の Amazon SNS 通知の設定の詳細については、「Run Command のための Amazon SNS 通知を設定する」を参照してください。

  10. [Run] を選択します。