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

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

以下のスクリプトの URL では、すべての AWS リージョンから SSM エージェントをダウンロードできます。特定のリージョンからエージェントをダウンロードする場合は、「特定のリージョンから SSM エージェントをダウンロードする」を参照してください。

SSM エージェントを手動でインストールしたら、Systems Manager ステートマネージャーを使用して、新しいバージョンが利用可能になったときにインスタンスで自動的に SSM エージェントを更新できます。詳細については、「自動的に SSM エージェント (CLI) を更新する」を参照してください。

重要

これらの手順は、Amazon EC2 Linux インスタンスへの SSM エージェントのインストールまたは再インストールに適用されます。Systems Manager を使用できるようにするために、オンプレミスのサーバーまたは仮想マシン (VM) にエージェントをインストールする場合は、「ハイブリッド環境に SSM エージェントをインストールする (Linux)」を参照してください。

Amazon Linux および Amazon Linux 2

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

重要

SSM エージェントは、デフォルトでは、2017 年 9 月以降の Amazon Linux 基本 AMI にインストールされます。SSM エージェントは、デフォルトで、Amazon Linux 2 AMI にもインストールされます。
Amazon ECS 対応の AMI のようにベースイメージではないその他のバージョンの Linux では、手動で SSM エージェントをインストールする必要があります。
プロキシを使用している Amazon Linux AMI から作成されたインスタンスは、Patch Manager オペレーションをサポートするために、現在のバージョンの Python requests モジュールを実行している必要があります。詳細については、「プロキシサーバーを使用する Amazon Linux インスタンス上の Python リクエストモジュールをアップグレードする」を参照してください。

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

SSM エージェントインストーラをダウンロードして実行するには、次のコマンドのいずれかを使用します。

注記

次のダウンロード URL に「ec2-downloads-windows」と表示されていても、これらは Amazon Linux と Amazon Linux 2 をダウンロードするための正しい URL です。

Intel (x86_64) 64 ビットインスタンス:
```
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
```
ARM (arm64) 64 ビットインスタンス:
```
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
```
Intel (x86) 32 ビットインスタンス:
```
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
```
SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。このコマンドから "amazon-ssm-agent is running" というメッセージが返されます。

Amazon Linux
```
sudo status amazon-ssm-agent
```
Amazon Linux 2
```
sudo systemctl status amazon-ssm-agent
```
前のコマンドで "amazon-ssm-agent is stopped" というメッセージが返された場合は、以下のコマンドを実行します。
1. サービスを起動します。
  
  Amazon Linux
```
sudo start amazon-ssm-agent
```
  Amazon Linux 2
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
2. エージェントのステータスを確認します。
  
  Amazon Linux
```
sudo status amazon-ssm-agent
```
  Amazon Linux 2
```
sudo systemctl status amazon-ssm-agent
```

重要

新しい機能が Systems Manager に追加されるか、既存の機能が更新されると必ず、更新されたバージョンの SSM エージェントがリリースされます。古いバージョンのエージェントがインスタンスで実行されていると、SSM エージェントプロセスによっては失敗することがあります。そのため、インスタンス上で SSM エージェントを最新に維持するプロセスを自動化することをお勧めします。詳細については、SSM エージェントへの更新の自動化を参照してください。SSM エージェントの更新に関する通知を受け取るには、SSM エージェントのリリースノートのページをサブスクライブします。

Ubuntu Server

Ubuntu Server インスタンスに接続して、以下のいずれかの手順を実行し、Systems Manager を使用してコマンドを実行するインスタンスごとに SSM エージェントをインストールします。

トピック

64 ビット Ubuntu Server 16.04 インスタンスでの SSM エージェントのインストールについて
Ubuntu Server 18.04 および 16.04 LTS 64 ビットインスタンス (Snap パッケージ使用) への SSM エージェントのインストール
Ubuntu Server 16.04 および 14.04 64 ビットインスタンス (deb インストーラパッケージ使用) への SSM エージェントのインストール
Ubuntu Server 16.04 および 14.04 32 ビットインスタンスへの SSM エージェントのインストール

64 ビット Ubuntu Server 16.04 インスタンスでの SSM エージェントのインストールについて

20180627 で識別される Ubuntu Server 16.04 AMI から作成されたインスタンス以降は、SSM エージェントは Snap パッケージを使用してプリインストールされています。例: ubuntu/images/hvm-ssd/ubuntu-xenial-16.04-amd64-server-20180627。以前の AMI から作成されたインスタンスでは、deb インストーラパッケージを引き続き使用する必要があります。

重要

インスタンスに SSM エージェントのインストールが複数ある場合は注意してください (たとえば、1 つは Snap を使用してインストールされたもの、1 つは deb インストーラを使用してインストールされたものの場合)。エージェントのオペレーションは正しく機能しません。

以下の手順に従って、インスタンスのソース AMI ID を確認できます。

Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.
左のナビゲーションで、[Instances] を選択します。
インスタンスを選択します。
[Description (説明)] タブで、[AMI ID] フィールドの値を見つけます。

64 ビット Ubuntu Server16.04 AMI から作成されたインスタンスの場合、SSM エージェントのインストールタイプの正しい手順に従ってください。

20180627 以降の識別子を使用して AMI から作成されたインスタンス: Ubuntu Server 18.04 および 16.04 LTS 64 ビットインスタンス (Snap パッケージ使用) への SSM エージェントのインストール
20180627 以前の AMI から作成されたインスタンス: Ubuntu Server 16.04 および 14.04 64 ビットインスタンス (deb インストーラパッケージ使用) への SSM エージェントのインストール

Ubuntu Server 18.04 および 16.04 LTS 64 ビットインスタンス (Snap パッケージ使用) への SSM エージェントのインストール

デフォルトでは、SSM エージェントは、20180627 以降の識別子のある Ubuntu Server 18.04 および 16.04 LTS 64 ビット AMI にインストールされます。バージョン 16.04 AMI の詳細については、64 ビット Ubuntu Server 16.04 インスタンスでの SSM エージェントのインストールについてを参照してください。

SSM エージェントオンプレミスサーバーにインストールする場合やエージェントを再インストールする場合は、次のスクリプトを使用できます。ダウンロードの URL を指定する必要はありません。snap コマンドでは、エージェントが Snap アプリストア https://snapcraft.io から自動的にダウンロードされます。
```
sudo snap install amazon-ssm-agent --classic
```
注記

Ubuntu Server 18.04 および 16.04 の SSM エージェントに関する以下の詳細に注意してください。
- Snap の既知の問題により、snap コマンドの使用時に Maximum timeout exceeded エラーが表示される場合があります。このエラーが表示された場合は、以下のコマンドを一度に 1 つずつ実行してエージェントの起動、停止、およびステータスの確認を行います。
```
sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.service
```
```
sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service
```
```
sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
```
- Ubuntu Server 18.04 および 16.04 の場合、SSM エージェントインストーラファイル (エージェントバイナリや設定ファイルなど) は /snap/amazon-ssm-agent/current/ ディレクトリに保存されます。設定ファイル (amazon-ssm-agent.json.template および seelog.xml.template) を変更した場合、これらのファイルを /snap フォルダから /etc/amazon/ssm/ フォルダにコピーする必要があります。ログファイルおよびライブラリファイルは変更されていません (/var/lib/amazon/ssm、/var/log/amazon/ssm)。
- Ubuntu Server18.04 では Snaps のみを使用します。deb パッケージをインストールしないでください。また、エージェントの 1 つのインスタンスのみがインスタンスにインストールされて実行されていることを確認してください。
- Ubuntu Server 18.04 および 16.04 で、SSM エージェントは arm64 プロセッサアーキテクチャーをサポートしています。
- 16.04 AMI のバージョンに応じて、Snap または deb インストールパッケージのいずれかを使用して SSM エージェントが Ubuntu Server 16.04 にインストールされます。詳細については、「64 ビット Ubuntu Server 16.04 インスタンスでの SSM エージェントのインストールについて」を参照してください。
SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。
```
sudo snap list amazon-ssm-agent
```
前のコマンドから、amazon-ssm-agent is stopped、inactive、または disabled が返された場合は、以下のコマンドを実行してサービスを開始します。
```
sudo snap start amazon-ssm-agent
```
エージェントのステータスを確認します。
```
sudo snap services amazon-ssm-agent
```

重要

Ubuntu Server 16.04 および 14.04 64 ビットインスタンス (deb インストーラパッケージ使用) への SSM エージェントのインストール

SSM エージェントオンプレミスサーバーにインストールする場合やエージェントを再インストールする場合は、次のスクリプトを使用できます。

重要

デフォルトでは、SSM エージェントは、20180627 以降の識別子のある Ubuntu Server 16.04 LTS 64 ビット AMI から作成されたインスタンスにインストールされます。以前の識別子で AMI から作成されたインスタンス (例: 20171121.1 および 20180522) には、deb インストーラを引き続き使用する必要があります。

SSM エージェントが Snap と組み合わせてインスタンスにインストールされていて、deb インストーラパッケージを使用して SSM エージェントをインストールまたは更新すると、インストールまたは SSM エージェントオペレーションが失敗することがあります。詳細については、「64 ビット Ubuntu Server 16.04 インスタンスでの SSM エージェントのインストールについて」を参照してください。

インスタンスに一時ディレクトリを作成します。
```
mkdir /tmp/ssm
```
一時ディレクトリに変更します。
```
cd /tmp/ssm
```
以下のコマンドを実行します.
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
以下のコマンドのいずれかを実行し、SSM エージェントが実行中であるかどうかを判断します。

Ubuntu Server 16.04:
```
sudo systemctl status amazon-ssm-agent
```
Ubuntu Server 14.04:
```
sudo status amazon-ssm-agent
```
前のコマンドから、amazon-ssm-agent is stopped、inactive、または disabled が返された場合は、次のいずれかのコマンドを実行してサービスを開始します。

Ubuntu Server 16.04:
```
sudo systemctl enable amazon-ssm-agent
```
Ubuntu Server 14.04:
```
sudo start amazon-ssm-agent
```
次のいずれかのコマンドを実行してエージェントのステータスを確認します。

Ubuntu Server 16.04:
```
sudo systemctl status amazon-ssm-agent
```
Ubuntu Server 14.04:
```
sudo status amazon-ssm-agent
```

重要

Ubuntu Server 16.04 および 14.04 32 ビットインスタンスへの SSM エージェントのインストール

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


mkdir /tmp/ssm

一時ディレクトリに変更します。


cd /tmp/ssm

以下のコマンドを実行します.


wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb


sudo dpkg -i amazon-ssm-agent.deb

SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。
```
sudo status amazon-ssm-agent
```
前のコマンドから、amazon-ssm-agent is stopped、inactive、または disabled が返された場合は、以下のコマンドを実行します。
1. エージェントを開始します。
```
sudo start amazon-ssm-agent
```
2. エージェントのステータスの確認:
```
sudo status amazon-ssm-agent
```

重要

Red Hat Enterprise Linux (RHEL)

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

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

SSM エージェントインストーラをダウンロードして実行するには、次のコマンドのいずれかを使用します。

Intel (x86_64) 64 ビットインスタンス:


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

ARM (arm64) 64 ビットインスタンス:


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

Intel (x86) 32 ビットインスタンス:


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

以下のコマンドのいずれかを実行し、SSM エージェントが実行中であるかどうかを判断します。コマンドはメッセージ amazon-ssm-agent is running を返します。

RHEL 7.x:
```
sudo systemctl status amazon-ssm-agent
```
RHEL 6.x:
```
sudo status amazon-ssm-agent
```
前のコマンドから amazon-ssm-agent is stopped が返された場合は、以下のコマンドを実行します。
1. サービスを起動します。
  
  RHEL 7.x:
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
  RHEL 6.x:
```
sudo start amazon-ssm-agent
```
2. エージェントのステータスを確認します。
  
  RHEL 7.x:
```
sudo systemctl status amazon-ssm-agent
```
  RHEL 6.x:
```
sudo status amazon-ssm-agent
```

重要

CentOS

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

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

SSM エージェントインストーラをダウンロードして実行するには、次のコマンドのいずれかを使用します。

64 ビットのインスタンス:


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

32 ビットのインスタンス:


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

以下のコマンドのいずれかを実行し、SSM エージェントが実行中であるかどうかを判断します。コマンドはメッセージ amazon-ssm-agent is running. を返します。

CentOS 7.x:
```
sudo systemctl status amazon-ssm-agent
```
CentOS 6.x:
```
sudo status amazon-ssm-agent
```
前のコマンドから amazon-ssm-agent is stopped が返された場合は、以下のコマンドを実行します。
1. サービスを起動します。
  
  CentOS 7.x:
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
  CentOS 6.x:
```
sudo start amazon-ssm-agent
```
2. エージェントのステータスを確認します。
  
  CentOS 7.x:
```
sudo systemctl status amazon-ssm-agent
```
  CentOS 6.x:
```
sudo status amazon-ssm-agent
```

重要

SUSE Linux Enterprise Server (SLES) 12

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

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

インスタンスに一時ディレクトリを作成します。
```
mkdir /tmp/ssm
```
一時ディレクトリに変更します。
```
cd /tmp/ssm
```
SSM エージェントインストーラをダウンロードして実行するには、次のコマンドを一度に 1 つずつ実行します。

64 ビットのインスタンス:
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
```
```
sudo rpm --install amazon-ssm-agent.rpm
```
SSM エージェントが実行中であるかどうかを判断するために次のコマンドを実行します。コマンドはメッセージ amazon-ssm-agent is running を返します。
```
sudo systemctl status amazon-ssm-agent
```
前のコマンドからメッセージ amazon-ssm-agent is stopped が返された場合は、以下のコマンドを実行します。
1. サービスを起動します。
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
2. エージェントのステータスを確認します。
```
sudo systemctl status amazon-ssm-agent
```

重要

Raspbian

このセクションには、Raspberry Pi (32 ビット) デバイスを含めて、Raspbian Jessie および Raspbian Stretch に SSM エージェントをインストールする方法に関する情報が含まれています。

開始する前に

Raspbian デバイスを Systems Manager マネージドインスタンスとして設定するには、マネージドインスタンスのアクティベーションを作成する必要があります。アクティベーションが完了したら、アクティベーションコードと ID を受け取ります。このコードと ID の組み合わせは、Amazon EC2 のアクセス ID とシークレットキーに似ており、マネージドインスタンスから Systems Manager サービスへのセキュアなアクセスが可能になります。アクティベーションコードと ID を安全な場所に保存します。アクティベーションプロセスの詳細については、「ハイブリッド環境で AWS Systems Manager を設定する」を参照してください。

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

SSM エージェントを Raspbian デバイスにインストールするには

インスタンスに一時ディレクトリを作成します。
```
mkdir /tmp/ssm
```

SSM エージェントインストーラをダウンロードして実行するには、次のコマンドを使用します。


sudo curl https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_arm/amazon-ssm-agent.deb -o /tmp/ssm/amazon-ssm-agent.deb

次のコマンドを実行して SSM エージェントをインストールします。
```
sudo dpkg -i /tmp/ssm/amazon-ssm-agent.deb
```
次のコマンドを実行して SSM エージェントを停止します。
```
sudo service amazon-ssm-agent stop
```
次のコマンドを実行し、マネージドインスタンスのアクティベーションプロセスを完了したときに受け取った、マネージドインスタンスのアクティベーションコードと ID を使用してエージェントを登録します。
```
sudo amazon-ssm-agent -register -code "code" -id "ID" -region "region"
```
次のコマンドを実行して SSM エージェントを起動します。
```
sudo service amazon-ssm-agent start
```

注記

SSM エージェントのエラーログに次のエラーが表示された場合、マシン ID は再起動後に保持されていません。

Unable to load instance associations, unable to retrieve associations unable to retrieve associations error occurred in RequestManagedInstanceRoleToken: MachineFingerprintDoesNotMatch: Fingerprint does not match

再起動後にマシン ID を保持するには、次のコマンドを実行します。
```
umount /etc/machine-id
systemd-machine-id-setup
```
新しい機能が Systems Manager に追加されるか、既存の機能が更新されると必ず、更新されたバージョンの SSM エージェントがリリースされます。古いバージョンのエージェントがインスタンスで実行されていると、SSM エージェントプロセスによっては失敗することがあります。そのため、インスタンス上で SSM エージェントを最新に維持するプロセスを自動化することをお勧めします。詳細については、SSM エージェントへの更新の自動化を参照してください。SSM エージェントの更新に関する通知を受け取るには、SSM エージェントのリリースノートのページをサブスクライブします。

特定のリージョンから SSM エージェントをダウンロードする

特定のリージョンからエージェントをダウンロードする場合は、オペレーティングシステムの URL をコピーし、region を適切な値に置き換えます。

リージョンは、AWS Systems Manager によってサポートされている AWS リージョンのリージョン ID (例: US East (Ohio) Region の場合は us-east-2) を表します。サポートされているリージョンのリストについては、AWS General Reference の「AWS Systems Manager リージョンとエンドポイント」のトピックのリージョン列を参照してください。

たとえば、US West 1 リージョンから Amazon Linux、RHEL、CentOS、および SLES 64 ビット用の SSM エージェントをダウンロードするには、次の URL を使用します。


https://s3.us-west-1.amazonaws.com/amazon-ssm-us-west-1/latest/linux_amd64/amazon-ssm-agent.rpm

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
Raspbian:

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

重要

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

« 前次 »

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