CloudConsole

Run Command:インスタンスでシェルコマンドを実行する

Systems Manager 経由で、マネージド EC2 インスタンスで df -h や free -m などのコマンドを実行し、進行をリアルタイムで追って出力を確認できます。

Services → Systems Manager → Run Command を開くか、EC2 インスタンスの More → Run command を使います(その場合はインスタンスが選択済みになります)。

Run Command の結果:web-1 と checkout-api-1 で df -h が成功し、インスタンスごとの終了コードと出力を表示
インスタンスごとの出力
  1. インスタンスを選びます。一覧には、マネージドインスタンスごとに ping ステータス、プラットフォーム、SSM エージェントのバージョンが表示されます。エージェントが接続されていないインスタンスは選択できません。
  2. コマンドを入力します。1 行に 1 つずつ入力するか、スニペットをタップします:Disk(df -h)、Memory(free -m)、Uptime、Service status(systemctl status <service>:プレースホルダーを置き換えてください)、上位のプロセス、最近のエラー。Windows インスタンスには PowerShell のスニペットと AWS-RunPowerShellScript、Linux インスタンスには AWS-RunShellScript が使われます。
  3. 実行します。Pro の操作で、ガードレールを通ります。名前が本番環境らしいアカウント(prod、production、live)では、確認のため常にアカウント名の入力が必要です。

コマンドの画面は、すべてのインスタンスが終わるまで数秒ごとに更新され、その後インスタンスごとに終了コード、出力、エラーを表示します。API が保持するのはそれぞれ先頭の 24,000 文字までです。それ以上が必要な場合は、コマンドの出力先に S3 バケットか CloudWatch Logs を設定する必要があり、設定されていれば画面からリンクされます。Recent commands には最近のコマンドとその結果が並びます。

マネージドでないインスタンス

Systems Manager に表示されない実行中の EC2 インスタンスは、考えられる理由とともに一覧表示されます:No instance profile(AmazonSSMManagedInstanceCore を含むロールをアタッチしてください)、または SSM agent not connected(ロールにそのポリシーがない、エージェントが停止している、またはインスタンスがインターネットや VPC エンドポイント経由で SSM のエンドポイントに到達できない)。

権限

内容IAMアクションReadOnlyAccess / ViewOnlyAccess に含まれるか
マネージドインスタンスssm:DescribeInstanceInformation(マネージドでないインスタンスの一覧には ec2:DescribeInstances も)はい / いいえ(追加してください)
最近のコマンド、ステータス、出力ssm:ListCommands, ssm:ListCommandInvocations, ssm:GetCommandInvocationはい / いいえ(追加してください)
Runドキュメントとインスタンスに対する ssm:SendCommandいいえ / いいえ

よくある質問

シェルセッションが開きますか?

いいえ。Run Command はコマンドを送って出力を返すだけで、何も開いたままにはなりません。対話型のセッションが必要な場合は、インスタンスの Copy SSM session command を使い、パソコンで実行してください。

解決しない場合

試したことと、アプリに表示されたメッセージを添えて[email protected]までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。