AWS Systems Manager エージェント（SSM Agent）の現行のバージョンを確認して最新バージョンにアップデートする

AWS Systems Manager の最新機能を試すためにバージョンが気になるあなたへ

#AWS Systems Manager Session Manager

#AWS Systems Manager（SSM）

#AWS

千葉幸宏（チバユキ）

2022.05.30

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

コンバンハ、千葉（幸）です。

先日、AWS Systems Manager セッションマネージャーでリモートホストへのポートフォワードが可能になる新機能が提供されました。

こういった新機能を利用するために、AWS Systems Manager エージェント（SSM Agent）の一定以上のバージョンが要求されることがあります。（なお、今回で言えば 3.1.1374.0 以上が必要なようです。）

上記のようなケースを想定し、以下の手順を確認してみます。

インストール済みの SSM Agent のバージョンを確認する
最新版の SSM Agent にアップデートする
（おまけ）SSM Agent のリリース履歴を確認する

インストール済みの SSM Agent のバージョンを確認する（コマンド）

まずはすでにインストール済みの SSM Agent が存在するケースを想定し、そのバージョンを確認してみます。

今回は現時点で最新であろう以下の AMI を使用し EC2 インスタンスを立ち上げます。Amazon Linux2 であるため、SSM Agent がインストール済みです。

amzn2-ami-kernel-5.10-hvm-2.0.20220426.0-x86_64-gp2

また、以下の条件も満たし、Systems Manager マネージドインスタンスとして管理された状態にしています。

IAM ロール（インスタンスプロファイル）で必要な権限を付与している
SSM エンドポイントに疎通可能な状態である

セッションマネージャーで接続し、yum info amazon-ssm-agentを実行します。

sh-4.2$ yum info amazon-ssm-agent
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name        : amazon-ssm-agent
Arch        : x86_64
Version     : 3.1.1188.0
Release     : 1.amzn2
Size        : 115 M
Repo        : installed
Summary     : Manage EC2 Instances using SSM APIs
URL         : http://docs.aws.amazon.com/ssm/latest/APIReference/Welcome.html
License     : ASL 2.0
Description : This package provides Amazon SSM Agent for managing EC2 Instances using SSM APIs

インストール済みの SSM Agent のバージョンが3.1.1188.0であることがわかりました。

OS によって確認方法が変わる場合もあります。他の OS でのコマンド例は以下をご参照ください。

SSM Agent バージョン番号の確認 - AWS Systems Manager

インストール済みの SSM Agent のバージョンをアップデートする（yum）

yum で管理されているなら yum でアップデートしてみるか、とsudo yum update amazon-ssm-agentを実行してみます。

sh-4.2$ sudo yum update amazon-ssm-agent
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
No packages marked for update

アップデートできるものがない、と言われてしまいました。yum での管理上では、3.1.1188.0が最新とされているようです。

戯れにsudo yum installも試してみますが、もちろん結果は変わりません。

h-4.2$ sudo yum install amazon-ssm-agent
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
amzn2-core                                                                                                                                             | 3.7 kB  00:00:00
Package matching amazon-ssm-agent-3.1.1188.0-1.amzn2.x86_64 already installed. Checking for update.
Nothing to do

インストール済みの SSM Agent のバージョンをアップデートする（Run Command）

冒頭の例で必要になるのは3.1.1374.0以上なので、別のアプローチでアップデートを試みます。

Systems Manager ドキュメントではAWS-UpdateSSMAgentという Command タイプのドキュメントが用意されています。

AWS_Systems_Manager_-_Documents_UpdateSSM_Agent

これを実行して SSM エージェントのバージョンがどうなるかを確認してみましょう。

AWS_Systems_Manager_-_Documents_SSM_Update

コマンドの実行画面から、パラメータやターゲット、出力オプションなどを適宜選択し実行します。パラメータとして SSM Agent バージョンを指定できますが、今回は特に指定しませんでした。その場合、最新版が適用されます。

Update_SSMAgent

実行履歴を確認してみると、以下のログが出力されていました。

Successfully downloaded manifest
Successfully downloaded updater version 3.1.1476.0
Updating amazon-ssm-agent from 3.1.1188.0 to 3.1.1476.0
Successfully downloaded https://s3.ap-northeast-1.amazonaws.com/amazon-ssm-ap-northeast-1/amazon-ssm-agent/3.1.1188.0/amazon-ssm-agent-linux-amd64.tar.gz
Successfully downloaded https://s3.ap-northeast-1.amazonaws.com/amazon-ssm-ap-northeast-1/amazon-ssm-agent/3.1.1476.0/amazon-ssm-agent-linux-amd64.tar.gz
Initiating amazon-ssm-agent update to 3.1.1476.0
amazon-ssm-agent updated successfully to 3.1.1476.0

3.1.1476.0にアップデートされたことが確認できました。先ほどのコマンドで確認しても、きちんと反映されています。

sh-4.2$ yum info amazon-ssm-agent
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name        : amazon-ssm-agent
Arch        : x86_64
Version     : 3.1.1476.0
Release     : 1
Size        : 108 M
Repo        : installed
Summary     : Manage EC2 Instances using SSM APIs
URL         : http://docs.aws.amazon.com/ssm/latest/APIReference/Welcome.html
License     : Apache License, Version 2.0
Description : This package provides Amazon SSM Agent for managing EC2 Instances using SSM APIs