AlmaLinux OS の EC2 インスタンスで amazon-ssm-agent の更新が失敗する原因と対処方法
困っていること
AlmaLinux OS で起動中に EC2 インスタンスをマネージドノードとして登録しています。
対象リソースは、古い amazon-ssm-agent Ver (例:3.1.1927.0) で稼働中のため SSM Agent の自動更新機能を利用してアップデートを行いました。
その際に、以下のエラーで失敗しました。原因と対処法を教えてください。
failed to download file reliably, https://s3.ap-northeast-1.amazonaws.com/amazon-ssm-ap-northeast-1/ssm-agent-manifest.json
原因
amazon-ssm-agent にて AlmaLinux をサポートしているバージョンは 3.2.815.0 以降です。
サポートされていない Ver からの更新であるため失敗します。
3.2.815.0
Add support for AlmaLinux
対処法
SSM Session Manager などで対象 EC2 インスタンスへ SSH 接続を行い、以下のコマンドを実行することで最新の amazon-ssm-agent Ver へ更新可能です。
sudo dnf install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
確認してみた
まずは、サポートされていない Ver で更新を行い、失敗するか確認します。
想定通り、該当エラーが出力され失敗しました。
それでは、EC2 インスタンスへ SSH 接続を行い dnf コマンドを用いて最新 Ver へ更新します。
正常に完了しました。それでは、マネジメントコンソール画面上でも確認します。
補足
amazon-ssm-agent のリリースノートを確認したところ、各バージョンで追加・拡張された OS / ディストリビューション対応は以下のとおりです。
| バージョン | OS / ディストリビューション対応内容 |
|---|---|
| 1.1.0 | CentOS、Ubuntu の追加プラットフォームに対応 |
| 1.2.290 | Ubuntu Xenial (16.04 LTS) に対応 |
| 1.2.371 | Windows Server 2016、Windows Server Nano に対応 |
| 2.0.805.0 | SLES (SuSE) 64-bit v12 以上に対応 |
| 2.0.922.0 | Raspbian armv6（Raspberry Pi 向け）に対応 |
| 2.3.274.0 | Amazon Linux 2、Ubuntu 16.04 / 18.04、RHEL 7.6 の arm64 アーキテクチャに対応 |
| 2.3.786.0 | Oracle Linux 7.5 / 7.7 に対応 |
| 2.3.978.0 | Debian arm64 に対応 |
| 3.0.502.0 | macOS 向けの SSM Agent をサポート |
| 3.1.941.0 | Rocky Linux に対応 |
| 3.2.815.0 | AlmaLinux に対応 |
| 3.2.1478.0 | RHEL 8.7 / 8.8 / 9.1 / 9.2、Rocky Linux 8.7 / 9.0 / 9.1 / 9.2、Oracle Linux 8.7 / 9.1 / 9.2 に対応 |
| 3.2.1705.0 | macOS 13 (Ventura) に対応 |
| 3.2.2016.0 | macOS 14 (Sonoma) に対応 |
| 3.2.2086.0 | Ubuntu 23.04、Debian 11.7 / 12、SUSE 15.5 に対応 |
| 3.3.217.0 | Oracle 8.8 / 8.9、Rocky 8.8 / 8.9、AlmaLinux 8.8 / 8.9、RHEL 8.9 / 9.3 に対応 |
| 3.3.808.0 | RHEL 8.10 / 9.4 に対応 |
※ 本ブログ執筆時点の情報です
参考資料
- SSM Agent への更新の自動化 - AWS Systems Manager
- amazon-ssm-agent/RELEASENOTES.md at mainline · aws/amazon-ssm-agent · GitHub
クラスメソッドオペレーションズ株式会社について
クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイト をぜひご覧ください。※2026年1月 アノテーション㈱から社名変更しました
