SSM Agent がプリインストールされている AMIs を見つける - AWS Systems Manager

SSM Agent がプリインストールされている AMIs を見つける

AWS Systems Manager Agent (SSM Agent) は、AWS および信頼できるサードパーティが提供している一部の Amazon Machine Images (AMIs) にプリインストールされています。

たとえば、次のいずれかのオペレーティングシステムで AMI から作成された Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを起動すると、SSM Agent がすでにインストールされている場合があります。

  • AlmaLinux

  • 2017 年 9 月以降の Amazon Linux 1 Base AMI

  • Amazon Linux 2

  • Amazon Linux 2 ECS に最適化されたベース AMIs

  • Amazon Linux 2023 (AL2023)

  • Amazon EKS 最適化 Amazon Linux AMIs

  • macOS 10.14.x (Mojave)、10.15.x (Catalina)、11.x (Big Sur)、12.x (Monterey)、13.x (Ventura)、および 14.x (Sonoma)

  • SUSE Linux Enterprise Server(SLES) 12 と 15

  • Ubuntu Server 16.04、18.04、20.04、および 22.04

  • 2016 年 11 月以降に公開された Windows Server 2008-2012 R2 AMIs

  • Windows Server 2016、2019、2022 (Nano バージョンを除く)

注記

AMI にプリインストールされている SSM Agent のバージョンが利用可能な最新バージョンではない可能性があります。ベストプラクティスとして、マネージドノードで常に最新バージョンの SSM Agent を使用することをお勧めします。SSM Agent 更新の自動化の詳細については、「SSM Agent への更新の自動化」を参照してください。

このリストに含まれていない AWS マネージド AMIs には、SSM Agent が事前インストールされている場合があります。つまり一般的には、Systems Manager のすべての機能で、オペレーティングシステム (OS) が完全にサポートされているわけではないことになります。

また、AWS Marketplace またはコミュニティ AMIs リポジトリにある AMIs に、SSM Agent が事前インストールされている場合もあります。ただし AWS では、これらの AMIs をサポートしていません。

SSM Agent のステータスを確認する

上記のリストにある AMI から作成されたインスタンスには、その初期化の時期によって、SSM Agent が事前インストールされていない場合があります。さらに、インスタンスにエージェントが事前インストールされていても、そのエージェントが実行されていない場合もあり得ます。そのため、インスタンスで Systems Manager を初めて使用する際には、先に SSM Agent のステータスを確認することをお勧めします。

SSM Agent がインストール済みで、かつインスタンスで実行されていることを確認するには、次の手順を使用します。インストール済みのエージェントがみつからない場合は、手動で、LinuxmacOS、および Windows Server のインスタンスにインストールできます。

インスタンスで SSM Agent のインストールを確認するには
  1. 新しいインスタンスを起動すると、初期化されるまで数分待ちます。

  2. 好みの方法を使用してインスタンスに接続します。たとえば、SSH を使用して Linux インスタンスに接続したり、リモートデスクトップを使用して Windows Server インスタンスに接続したりできます。

  3. インスタンスのオペレーティングシステムタイプに対応するコマンドを実行し、SSM Agent の状態を確認します。

    オペレーティングシステム Command
    Amazon Linux 1 sudo status amazon-ssm-agent
    Amazon Linux 2 および Amazon Linux 2023 sudo systemctl status amazon-ssm-agent
    macOS macOS で SSM Agent 状態を確認するコマンドはありません。エージェント ログファイル /var/log/amazon/ssm/amazon-ssm-agent.log を見つけて評価することでステータスを確認できます。
    SUSE Linux Enterprise Server sudo systemctl status amazon-ssm-agent
    Ubuntu Server (32 ビット) sudo status amazon-ssm-agent
    Ubuntu Server (64 ビット - Deb) sudo systemctl status amazon-ssm-agent
    Ubuntu Server (64 ビット - Snap) sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
    Windows Server Get-Service AmazonSSMAgent
    ヒント

    Systems Manager でサポートされているすべてのオペレーティングシステムタイプの SSM Agent 状態を確認するコマンドを表示するには、「SSM Agent ステータスの確認とエージェントの起動」を参照してください。

  4. コマンド出力を評価して、SSM Agent の状態を確認します。

    状態: インストール済みおよび実行中

    ほとんどの場合、コマンド出力は、エージェントがインストールされ、実行中であることを示します。

    次の例は、SSM Agent が Amazon Linux 2 インスタンスにインストールされ、実行されていることを示しています。

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: active (running) since Wed 2021-10-20 19:09:29 UTC; 4min 6s ago
    --truncated--
                                

    次の例は、SSM Agent が Windows Server インスタンスにインストールされ、実行されていることを示しています。

    Status   Name               DisplayName
    ------   ----               -----------
    Running  AmazonSSMAgent     Amazon SSM Agent
    状態: インストール済みですが、実行されていません

    場合によっては、コマンド出力は、エージェントがインストールされているが、実行されていないことを示します。

    次の例は、SSM Agent が Amazon Linux 2 インスタンスにインストールされているが、実行されていないことを示しています。

    amazon-ssm-agent.service - amazon-ssm-agent
    Loaded: loaded (/usr/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: enabled)
    Active: inactive (dead) since Wed 2021-10-20 22:16:41 UTC; 18s ago
    --truncated--
                                

    次の例は、SSM Agent が Windows Server インスタンスにインストールされているが実行されていないことを示しています。

    Status   Name               DisplayName
    ------   ----               -----------
    Stopped  AmazonSSMAgent     Amazon SSM Agent
                                

    エージェントがインストールされていても実行されていない場合は、インスタンスのオペレーティングシステムタイプのコマンドを使用して、手動でアクティブ化できます。

    オペレーティングシステム Command
    Amazon Linux 1 sudo start amazon-ssm-agent
    Amazon Linux 2 および Amazon Linux 2023

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    macOS

    sudo launchctl load -w /Library/LaunchDaemons/com.amazon.aws.ssm.plist

    sudo launchctl start com.amazon.aws.ssm

    SUSE Linux Enterprise Server

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server (32 ビット)

    sudo start amazon-ssm-agent

    Ubuntu Server (64 ビット - Deb)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server (64 ビット - Snap) sudo snap start amazon-ssm-agent
    Windows Server

    PowerShell で、次のコマンドを実行します。

    Start-Service AmazonSSMAgent

    状態: インストールされていません

    場合によっては、コマンド出力は、エージェントがインストールされていないことを示します。

    次の例は、SSM Agent が Amazon Linux 2 インスタンスにインストールされていないことを示しています。

    Unit amazon-ssm-agent.service could not be found.

    次の例は、SSM Agent が Windows Server インスタンスにインストールされていないことを示しています。

    Get-Service : Cannot find any service with service name 'AmazonSSMAgent'.
    --truncated--

    エージェントがインストールされていない場合は、オペレーティングシステムタイプの手順を使用して、手動でインストールできます。