SSM Agent がプリインストールされた Amazon Machine Images (AMIs) - AWS Systems Manager

SSM Agent がプリインストールされた Amazon Machine Images (AMIs)

AWS Systems Manager エージェント (SSM Agent) は AWS が提供するいくつかの Amazon Machine Images (AMIs) にプリインストールされています。

ほとんどの場合、SSM Agent は、以下のオペレーティングシステム (OS) の AWS が提供する AMIs にプリインストールされています。

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

  • Amazon Linux 2

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

  • Amazon EKS 最適化 Amazon Linux AMIs

  • macOS 10.14.x (Mojave)、10.15.x (Catalina)、11.x (Big Sur)

  • SUSE Linux Enterprise Server(SLES) 12 と 15

  • Ubuntu Server 16.04、18.04、および 20.04

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

  • Windows Server 2016、2019、および 2022

まれに、エージェントがプリインストールされていないか、インストールされているにも関わらず、これらの OS の AWS マネージド AMIs のいずれかから作成された Amazon Elastic Compute Cloud (Amazon EC2) インスタンスで実行できない場合があります。このため、これらの AMIs のいずれかから作成されたインスタンスで Systems Manager を使用する前に、いずれかのインスタンスに接続して、SSM Agent がインストールされ、実行されているのを検証することをお勧めします。

注記

前のリストに含まれていない AMIs から起動されたインスタンスには、SSM Agent がプリインストールされていない場合があります。インスタンスにエージェントがインストールされているかどうかを確認するには、次の手順を使用します。エージェントがインストールされていないことが判明した場合は、エージェントを LinuxmacOSWindows Server インスタンスに手動でインストールします。また、ハイブリッド環境の仮想マシン、オンプレミスのサーバー、エッジデバイスにも SSM Agent を手動でインストールする必要があります。

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

インスタンスで SSM Agent のインストールを確認するには

  1. インスタンスの起動後、数分待ってから、Linux 用 SSH、Windows Server 用リモートデスクトップなど、任意の方法でインスタンスに接続します。

  2. インスタンスのオペレーティングシステムタイプに対応するコマンドを実行し、SSM Agent のステータスをチェックします。

    Amazon Linux

    sudo systemctl status amazon-ssm-agent

    Amazon Linux 2

    sudo systemctl status amazon-ssm-agent

    macOS

    /var/log/amazon/ssm/amazon-ssm-agent.log で、エージェントのログファイルをチェックします。

    SUSE Linux Enterprise Server

    sudo systemctl status amazon-ssm-agent

    Ubuntu Server 16.04 (32 ビット)

    sudo status amazon-ssm-agent

    Ubuntu Server 16.04 64 ビットインスタンス (deb パッケージのインストール)

    sudo systemctl status amazon-ssm-agent

    Ubuntu Server 16.04、18.04、20.04 LTS および 20.10 STR 64 ビット (Snap パッケージのインストール)

    sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service

    Windows Server

    PowerShell で実行する:

    Get-Service AmazonSSMAgent

    ヒント

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

  3. コマンドの結果をチェックして、エージェントのステータスを特定します。

    結果 1: インストールされ、実行中

    ほとんどの場合、コマンドは、エージェントが実行中であることを報告します。

    次の 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--

    次の Windows Server の例を参照してください。

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

    結果 2: インストールされているが、実行されていない

    まれに、コマンドは、エージェントがインストールされているが、実行されていないことを報告します。

    次の 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--

    次の Windows Server の例を参照してください。

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

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

    Amazon Linux

    sudo systemctl start amazon-ssm-agent

    Amazon Linux 2

    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 16.04 (32 ビット)

    sudo start amazon-ssm-agent

    Ubuntu Server 16.04 64 ビットインスタンス (deb パッケージのインストール)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server 16.04、18.04、20.04 LTS および 20.10 STR 64 ビット (Snap パッケージのインストール)

    sudo snap start amazon-ssm-agent

    Windows Server

    PowerShell で実行する:

    Start-Service AmazonSSMAgent

    結果 3: インストールされていない

    まれに、コマンドは、エージェントがインストールされていないことを報告します。

    次の Amazon Linux 2 の例を参照してください。

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

    次の Windows Server の例を参照してください。

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

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