メニュー
Amazon EC2 Systems Manager
ユーザーガイド

SSM エージェントのインストール

Amazon EC2 Systems Manager (SSM) エージェントは Systems Manager 要求を処理し、要求に指定されたとおりにマシンを設定します。

SSM は EC2 メッセージングサービスを使用してインスタンスの SSM エージェントと通信します。トラフィックをモニタリングすると、ec2messages と通信中のインスタンスが表示されます。* エンドポイント.

SSM エージェントのインストール、設定、またはアンインストールには、次の手順を使用します。

Windows に SSM エージェントをインストールする

インスタンスで実行しているエージェントは、Systems Manager 要求を処理し、要求に指定されたとおりにインスタンスを設定します。SSM エージェントは、デフォルトで、Windows Server 2016 インスタンスと、2016 年 11 月以降に公開された Windows Server 2003-2012 R2 AMI から作成されたインスタンスにインストールされます。

2016 年 11 月以前に発行された Windows AMI は、EC2Config サービスを使用して要求を処理し、インスタンスを設定します。

EC2Config サービスまたは以前のバージョンの SSM エージェントを使用して Systems Manager 要求を処理する理由が特にない限り、各 Amazon EC2 インスタンスまたはマネージドインスタンス (ハイブリッド環境のサーバーと VM) で最新バージョンの SSM エージェントをダウンロードしてインストールすることをお勧めします。

注記

マネージドインスタンスでの SSM エージェントのダウンロードとインストールのプロセスは、Amazon EC2 インスタンスとは異なります。詳細については、「Windows ハイブリッド環境のサーバーおよび VM に SSM エージェントをインストールする」を参照してください。

SSM エージェントのバージョン別の詳細を確認するには、リリースノートを参照してください。

SSM エージェントのインストール

インスタンスが 2016 年 11 月よりに作成された Windows Server 2003-2012 R2 インスタンスである場合は、EC2Config でインスタンスの Systems Manager リクエストが処理されます。既存のインスタンスをアップグレードして最新バージョンの EC2Config を使用することをお勧めします。アップグレードすると、SSM エージェントが EC2Config と一緒にインストールされます。このバージョンの SSM エージェントは、以前の Windows AMI から作成されたインスタンスと互換性があり、2016 年 11 月より後に公開された SSM の機能を使用できます。Run Command を使用して、リモートから 1 つ以上のインスタンスで EC2Config の更新と SSM エージェントのインストールができます。詳細については、「EC2 コンソールからコマンドを実行する」を参照してください。

または、次の手順を使用して、最新バージョンの SSM エージェントを手動でダウンロードしてインストールできます。

最新バージョンの SSM エージェントをダウンロードしてインストールするには

  1. インスタンスにログインします。

  2. 最新バージョンの SSM エージェントをインスタンスにダウンロードします。

    https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_amd64/AmazonSSMAgentSetup.exe

    この URL で、どの AWS リージョン からでも SSM エージェントをダウンロードすることができます。特定のリージョンからエージェントをダウンロードする場合は、代わりにリージョン固有の URL を使用します。

    https://amazon-ssm-region.s3.amazonaws.com/latest/windows_amd64/AmazonSSMAgentSetup.exe

  3. Windows サービスのコントロールパネルを使用するか、PowerShell で次のコマンドを送信して、SSM エージェント (AmazonSSMAgent.exe) を開始または再起動します。

    Copy
    Restart-Service AmazonSSMAgent

SSM エージェントログ

Windows の場合、SSM エージェントは次の場所にログファイルを保存します。

  • %PROGRAMDATA%\Amazon\SSM\Logs\amazon-ssm-agent.log

  • %PROGRAMDATA%\Amazon\SSM\Logs\errors.log

SSM エージェントがプロキシを使用するように設定する

プロキシを使用するための EC2Config の設定の詳細については、「EC2Config Service サービスのプロキシ設定の構成」を参照してください。

SSM エージェントがプロキシを使用するように設定するには

  1. リモートデスクトップまたは Windows PowerShell を使用して、プロキシを使用するように設定するインスタンスに接続します。Nano インストールオプション (Nano Server) を使用する Windows Server 2016 インスタンスでは、PowerShell を使用して接続する必要があります。詳細については、「Windows Server 2016 Nano Server インスタンスへの接続」を参照してください。

  2. リモートデスクトップを使用して接続した場合は、管理者として PowerShell を起動します。

  3. PowerShell で次のコマンドブロックを実行します。

    Copy
    $serviceKey = "HKLM:\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent" $keyInfo = (Get-Item -Path $serviceKey).GetValue("Environment") $proxyVariables = @("http_proxy=hostname:port", "no_proxy=169.254.169.254") If($keyInfo -eq $null) { New-ItemProperty -Path $serviceKey -Name Environment -Value $proxyVariables -PropertyType MultiString -Force } else { Set-ItemProperty -Path $serviceKey -Name Environment -Value $proxyVariables } Restart-Service AmazonSSMAgent

SSM エージェントのプロキシ設定をリセットするには

  1. リモートデスクトップまたは Windows PowerShell を使用して、設定先のインスタンスに接続します。

  2. リモートデスクトップを使用して接続した場合は、管理者として PowerShell を起動します。

  3. PowerShell で次のコマンドブロックを実行します。

    Copy
    Remove-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent -Name Environment Restart-Service AmazonSSMAgent

Linux に SSM エージェントをインストールする

Amazon EC2 Systems Manager (SSM) エージェントは Systems Manager 要求を処理し、要求に指定されたとおりにマシンを設定します。SSM エージェントのインストール、設定、またはアンインストールには、次の手順を使用します。

ニーズに応じて調整できるように、SSM エージェントのソースコードは GitHub に用意されています。含めることを希望する変更について、プルリクエストを送信することをお勧めします。ただし、現在 AWS はこのソフトウェアの修正されたコピーの実行をサポートしていません。

注記

SSM エージェントのバージョン別の詳細を確認するには、リリースノートを参照してください。

EC2 インスタンスに SSM エージェントをインストールし起動する

EC2 ユーザーデータを使用してインスタンスを初めて起動する際に SSM エージェントをインストールできます。起動ウィザードの [Configure Instance Details] ページで、[Advanced Details] を展開し、次のスクリプトのいずれかをコピーして [User data] フィールドに貼り付けます。(例:

 開始時における SSM エージェントのインストール

注記

以下のスクリプトの URL では、すべての AWS リージョンから SSM エージェントをダウンロードできます。特定のリージョンからでエージェントをダウンロードするには、以下の URL を次のリージョン固有の URL の 1 つに置き換えます。Systems Manager が使用可能なリージョンを指定する必要があります。

ダウンロードに失敗した場合、https://s3-region を https://s3 に置き換えてみてください。リージョン.

  • Amazon Linux、RHEL、CentOS、および SLES 64 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

  • Amazon Linux、RHEL、および CentOS 32 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/linux_386/amazon-ssm-agent.rpm

  • Ubuntu Server 64 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/debian_amd64/amazon-ssm-agent.deb

  • Ubuntu Server 32 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/debian_386/amazon-ssm-agent.deb

Amazon Linux、RHEL、および CentOS 64 ビット

Copy
#!/bin/bash cd /tmp sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm

Amazon Linux、RHEL、および CentOS 32 ビット

Copy
#!/bin/bash cd /tmp sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm

Ubuntu Server 16 64 ビット

Copy
#!/bin/bash cd /tmp wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb sudo systemctl enable amazon-ssm-agent

Ubuntu Server 16 32 ビット

Copy
#!/bin/bash cd /tmp wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb sudo systemctl enable amazon-ssm-agent

SLES 64 ビット

Copy
#!/bin/bash cd /tmp wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm sudo rpm --install amazon-ssm-agent.rpm

Ubuntu Server 14 64 ビット

Copy
#!/bin/bash cd /tmp wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb sudo start amazon-ssm-agent

Ubuntu Server 14 32 ビット

Copy
#!/bin/bash cd /tmp wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb sudo start amazon-ssm-agent

変更を保存して、ウィザードを完了します。インスタンスが起動すると、システムは SSM エージェントをインスタンスにコピーし、それを起動します。インスタンスがオンラインの場合は、Run Command を使用して設定できます。詳細については、「Systems Manager Run Command を使用したコマンドの実行」を参照してください。

EC2 インスタンスに SSM エージェントを手動でインストールする

次に示す Linux インスタンスの 1 つに SSM エージェントをインストールするには、以下のスクリプトの 1 つを使用します。

注記

以下のスクリプトの URL では、すべての AWS リージョンから SSM エージェントをダウンロードできます。特定のリージョンからでエージェントをダウンロードするには、以下の URL を次のリージョン固有の URL の 1 つに置き換えます。Systems Manager が使用可能なリージョンを指定する必要があります。

ダウンロードに失敗した場合、https://s3-region を https://s3 に置き換えてみてください。リージョン.

  • Amazon Linux、RHEL、CentOS、および SLES 64 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

  • Amazon Linux、RHEL、および CentOS 32 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/linux_386/amazon-ssm-agent.rpm

  • Ubuntu Server 64 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/debian_amd64/amazon-ssm-agent.deb

  • Ubuntu Server 32 ビット:

    https://s3-region.amazonaws.com/amazon-ssm-region/latest/debian_386/amazon-ssm-agent.deb

Amazon Linux

SSM エージェントをインストールするには、Amazon Linux インスタンスに接続して次のステップを実行します。Systems Manager を使用してコマンドを実行するインスタンスごとに以下のステップを実行します。

SSM エージェントを Amazon Linux にインストールするには

  1. インスタンスに一時ディレクトリを作成します。

    Copy
    mkdir /tmp/ssm
  2. 一時ディレクトリに変更します。

    Copy
    cd /tmp/ssm
  3. SSM インストーラーをダウンロードして実行するには、次のコマンドのいずれかを使用します。

    64 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm

    32 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
  4. SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。このコマンドによって "amazon-ssm-agent is running" と返されるはずです。

    Copy
    sudo status amazon-ssm-agent
  5. 前のコマンドで "amazon-ssm-agent is stopped" と返された場合は、以下のコマンドを実行します。

    1. サービスの開始.

      Copy
      sudo start amazon-ssm-agent
    2. エージェントのステータスを確認します。

      Copy
      sudo status amazon-ssm-agent

Ubuntu

SSM エージェントをインストールするには、Ubuntu インスタンスに接続して次のステップを実行します。Systems Manager を使用してコマンドを実行するインスタンスごとに以下のステップを実行します。

Ubuntu に SSM エージェントをインストールするには

  1. インスタンスに一時ディレクトリを作成します。

    Copy
    mkdir /tmp/ssm
  2. SSM インストーラーをダウンロードして実行するには、次のコマンドのいずれかを使用します。

    64 ビット

    Copy
    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb

    32 ビット

    Copy
    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb sudo dpkg -i amazon-ssm-agent.deb
  3. SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。

    Ubuntu Server 14

    Copy
    sudo status amazon-ssm-agent

    Ubuntu Server 16

    Copy
    sudo systemctl status amazon-ssm-agent
  4. 前のコマンドから "amazon-ssm-agent is stopped"、"inactive" または "disabled" が返された場合は、以下のコマンドを実行します。

    1. サービスの開始.

      Ubuntu Server 14

      Copy
      sudo start amazon-ssm-agent

      Ubuntu Server 16

      Copy
      sudo systemctl enable amazon-ssm-agent
      Copy
      sudo systemctl start amazon-ssm-agent
    2. エージェントのステータスを確認します。

      Ubuntu Server 14

      Copy
      sudo status amazon-ssm-agent

      Ubuntu Server 16

      Copy
      sudo systemctl status amazon-ssm-agent

Red Hat Enterprise Linux

SSM エージェントをインストールするには、Red Hat Enterprise Linux (RHEL) インスタンスに接続して次のステップを実行します。Systems Manager を使用してコマンドを実行するインスタンスごとに以下のステップを実行します。

Red Hat Enterprise Linux に SSM エージェントをインストールするには

  1. インスタンスに一時ディレクトリを作成します。

    Copy
    mkdir /tmp/ssm
  2. SSM インストーラーをダウンロードして実行するには、次のコマンドのいずれかを使用します。

    64 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm

    32 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
  3. 以下のコマンドのいずれかを実行し、SSM エージェントが実行中であるかどうかを判断します。このコマンドによって "amazon-ssm-agent is running" と返されるはずです。

    RHEL 7.x

    Copy
    sudo systemctl status amazon-ssm-agent

    RHEL 6.x

    Copy
    sudo status amazon-ssm-agent
  4. 前のコマンドで "amazon-ssm-agent is stopped" と返された場合は、以下のコマンドを実行します。

    1. サービスの開始.

      RHEL 7.x

      Copy
      sudo systemctl enable amazon-ssm-agent
      Copy
      sudo systemctl start amazon-ssm-agent

      RHEL 6.x

      Copy
      sudo start amazon-ssm-agent
    2. エージェントのステータスを確認します。

      RHEL 7.x

      Copy
      sudo systemctl status amazon-ssm-agent

      RHEL 6.x

      Copy
      sudo status amazon-ssm-agent

CentOS

SSM エージェントをインストールするには、CentOS インスタンスに接続して以下のステップを実行します。Systems Manager を使用してコマンドを実行するインスタンスごとに以下のステップを実行します。

CentOS に SSM エージェントをインストールするには

  1. インスタンスに一時ディレクトリを作成します。

    Copy
    mkdir /tmp/ssm
  2. SSM インストーラーをダウンロードして実行するには、次のコマンドのいずれかを使用します。

    64 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm

    32 ビット

    Copy
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
  3. 以下のコマンドのいずれかを実行し、SSM エージェントが実行中であるかどうかを判断します。このコマンドによって "amazon-ssm-agent is running" と返されるはずです。

    CentOS 7.x

    Copy
    sudo systemctl status amazon-ssm-agent

    CentOS 6.x

    Copy
    sudo status amazon-ssm-agent
  4. 前のコマンドで "amazon-ssm-agent is stopped" と返された場合は、以下のコマンドを実行します。

    1. サービスの開始.

      CentOS 7.x

      Copy
      sudo systemctl enable amazon-ssm-agent
      Copy
      sudo systemctl start amazon-ssm-agent

      CentOS 6.x

      Copy
      sudo start amazon-ssm-agent
    2. エージェントのステータスを確認します。

      CentOS 7.x

      Copy
      sudo systemctl status amazon-ssm-agent

      CentOS 6.x

      Copy
      sudo status amazon-ssm-agent

SLES

SSM エージェントをインストールするには、SLES インスタンスに接続して次のステップを実行します。Systems Manager を使用してコマンドを実行するインスタンスごとに以下のステップを実行します。

SSM エージェントを SLES にインストールするには

  1. インスタンスに一時ディレクトリを作成します。

    Copy
    mkdir /tmp/ssm
  2. 一時ディレクトリに変更します。

    Copy
    cd /tmp/ssm
  3. SSM インストーラをダウンロードして実行するには、次のコマンドを使用します。

    64 ビット

    Copy
    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm sudo rpm --install amazon-ssm-agent.rpm
  4. SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。このコマンドによって "amazon-ssm-agent is running" と返されるはずです。

    Copy
    sudo systemctl status amazon-ssm-agent
  5. 前のコマンドで "amazon-ssm-agent is stopped" と返された場合は、以下のコマンドを実行します。

    1. サービスの開始.

      Copy
      sudo systemctl enable amazon-ssm-agent sudo systemctl start amazon-ssm-agent
    2. エージェントのステータスを確認します。

      Copy
      sudo systemctl status amazon-ssm-agent

SSM エージェントがプロキシを使用するように設定する

SSM エージェント設定ファイルに http_proxy 設定と no_proxy 設定を追加して、HTTPプロキシを通じて通信するように SSM エージェントを設定できます。このセクションには、upstart 環境および systemd 環境の手順が含まれています。

SSM エージェントがプロキシ (Upstart) を使用するように設定する

  1. SSM エージェントをインストールした先のインスタンスに接続します。

  2. VIM などのエディタで amazon-ssm-agent.conf ファイルを開きます。デフォルトでは、このファイルは次の場所にあります。

    /etc/init/amazon-ssm-agent.conf

  3. このファイルに次の設定を次の形式で追加します。

    Copy
    env http_proxy=http://hostname:port env https_proxy=http://hostname:port env HTTP_PROXY=http://hostname:port env HTTPS_PROXYy=http://hostname:port
  4. このファイルに no_proxy 設定を次の形式で追加します。以下に示す IP アドレスを指定する必要があります。これは SSM のインスタンスメタデータのエンドポイントであり、この IP アドレスがないと SSM に対する呼び出しは失敗します。

    Copy
    env no_proxy=169.254.169.254
  5. 変更内容を保存し、エディタを閉じます。

  6. 次のコマンドを使用して SSM エージェントを再起動します。

    Copy
    sudo stop amazon-ssm-agent sudo start amazon-ssm-agent

次の Upstart の例は、amazon-ssm-agent.conf ファイルでの http_proxy 設定と no_proxy 設定を示しています。

Copy
description "Amazon SSM Agent" author "Amazon.com" start on (runlevel [345] and started network) stop on (runlevel [!345] or stopping network) respawn env http_proxy=http://i-1234567890abcdef0:443 env no_proxy=169.254.169.254 chdir /usr/bin/ exec ./amazon-ssm-agent

SSM エージェントがプロキシ (systemd) を使用するように設定する

  1. SSM エージェントをインストールした先のインスタンスに接続します。

  2. VIM などのエディタで amazon-ssm-agent.service ファイルを開きます。デフォルトでは、このファイルは次の場所にあります。

    /etc/systemd/system/amazon-ssm-agent.service

  3. ファイルに次の設定を追加します。

    Copy
    Environment="http_proxy=http://hostname:port" Environment="https_proxy=http://hostname:port" Environment="HTTP_PROXY=http://hostname:port" Environment="HTTPS_PROXYy=http://hostname:port"
  4. このファイルに no_proxy 設定を次の形式で追加します。以下に示す IP アドレスを指定する必要があります。これは SSM のインスタンスメタデータのエンドポイントであり、この IP アドレスがないと SSM に対する呼び出しは失敗します。

    Copy
    Environment="no_proxy=169.254.169.254"
  5. 変更内容を保存し、エディタを閉じます。

  6. 以下のコマンドを使用して SSM エージェントを再起動します。

    Copy
    sudo systemctl stop amazon-ssm-agent sudo systemctl daemon-reload

次の systemd の例は、amazon-ssm-agent.service ファイルでの http_proxy 設定と no_proxy 設定を示しています。

Copy
Type=simple Environment="HTTP_PROXY=http://i-1234567890abcdef0:443" Environment="no_proxy=169.254.169.254" WorkingDirectory=/opt/amazon/ssm/ ExecStart=/usr/bin/amazon-ssm-agent KillMode=process Restart=on-failure RestartSec=15min

SSM エージェントログ

SSM エージェントは、次のファイルに情報を記録します。これらのファイルの情報は、問題をトラブルシューティングするのに役立ちます。

  • /var/log/amazon/ssm/amazon-ssm-agent.log

  • /var/log/amazon/ssm/errors.log

Linux では、seelog.xml ファイルを更新することで、ログを拡張することができます。デフォルトでは、設定ファイルここにあります: /etc/amazon/ssm/seelog.xml。

cihub/seelog の設定について詳しくは、cihub/seelog Wiki を参照してください。cihub/seelog 設定の例については、cihub/seelog examples を参照してください。

Linux で SSM エージェントをアンインストールする

SSM エージェントをアンインストールするには、次のコマンドを使用します。

Amazon Linux、RHEL、または Cent OS

Copy
sudo yum erase amazon-ssm-agent –y

Ubuntu

Copy
sudo dpkg -r amazon-ssm-agent

SLES

Copy
sudo rpm --erase amazon-ssm-agent