AMIs使用預先安SSM Agent裝的查找

AWS Systems Manager Agent (SSM Agent) 已預先安裝在由受信任的協力廠商提供的 AWS 某些 Amazon Machine Images (AMIs) 上。

例如，當您使用下列其中一個作業系統，啟動透過 AMI 建立的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體時，您可能會發現已經安裝 SSM Agent：

AlmaLinux
Amazon Linux 1 基礎 AMI 日期為 2017.09 及更高版本
Amazon Linux 2
Amazon Linux 2 ECS 最佳化基礎 AMIs
Amazon Linux 2023 (AL2023)
Amazon EKS 最佳化的 Amazon Linux AMIs
macOS10.14.x（莫哈韋），10.15.x（卡塔利娜），11.x（大蘇爾），12 倍（蒙特雷），13.x（文圖拉）和 14.x（索諾瑪）
SUSE Linux Enterprise Server (SLES) 12 和 15
Ubuntu Server 16.04、18.04、20.04 和 22.04
Windows Server 2008-2012 R2 AMIs 發佈於 2016 月 11 月或之後
Windows Server 2016、2019 和 2022

注意

SSM Agent可能會預先安裝在不在此清單中的 AWS 受管理AMIs上。這通常表示並非所有 Systems Manager 功能都完全支援該作業系統 (OS)。

SSM Agent也可能預先安裝在社群存放庫中 AWS Marketplace 或在社群AMIs存放庫中AMIs找到，但 AWS 不支援這些AMIs資訊。

驗證 SSM Agent 的狀態

根據初始化的時間而定，從上述清單中的 AMI 建立的執行個體可能沒有預先安裝 SSM Agent。執行個體也有可能已預先安裝代理程式，但代理程式未執行。因此，建議您首次嘗試在執行個體上使用 Systems Manager 之前，先檢查 SSM Agent 的狀態。

使用下列程序驗證 SSM Agent 已安裝並正在執行個體上執行。如果發現未安裝代理程式，您可以在 Linux、macOS 以及 Windows Server 執行個體上手動安裝。

驗證 SSM Agent 已安裝在執行個體

啟動新的執行個體之後，請等待幾分鐘使其完成初始化。
使用您偏好的方式連線至執行個體。例如，您可以使用 SSH 連線至 Linux 執行個體，或使用遠端桌面連線至 Windows Server 執行個體。

針對執行個體的作業系統類型執行命令，以檢查 SSM Agent 的狀態。

作業系統	Command
Amazon Linux 1	`sudo status amazon-ssm-agent`
Amazon Linux 2 和 Amazon Linux 2023	`sudo systemctl status amazon-ssm-agent`
macOS	沒有用於在 macOS 上檢查 SSM Agent 狀態的命令。透過尋找和評估代理程式日誌檔案 `/var/log/amazon/ssm/amazon-ssm-agent.log`，您可以檢查狀態。
SUSE Linux Enterprise Server	`sudo systemctl status amazon-ssm-agent`
Ubuntu Server (32 位元)	`sudo status amazon-ssm-agent`
Ubuntu Server (64 位元 - Deb)	`sudo systemctl status amazon-ssm-agent`
Ubuntu Server (64 位元 - Snap)	`sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service`
Windows Server	`Get-Service AmazonSSMAgent`

提示

若要檢視命令以檢查 Systems Manager 所支援之所有作業系統類型的 SSM Agent 狀態，請參閱檢查 SSM Agent 狀態並啟動代理程式。

評估命令輸出，以了解 SSM Agent 的狀態。

狀態：已安裝且正在執行

在大多數情況下，命令輸出表明代理程式已安裝且正在執行。

下列範例顯示在 Amazon Linux 2 執行個體上已安裝且正在執行 SSM Agent。

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 執行個體上已安裝且正在執行 SSM Agent。

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

狀態︰已安裝但未執行

在某些情況下，命令輸出表明代理程式已安裝但未執行。

下列範例顯示在 Amazon Linux 2 執行個體上已安裝但未執行 SSM Agent。

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 執行個體上已安裝但未執行 SSM Agent。

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

如果代理程式已安裝但未執行，您可以使用適用於執行個體作業系統類型的命令手動啟用。

作業系統	Command
Amazon Linux 1	`sudo start amazon-ssm-agent`
Amazon Linux 2 和 Amazon Linux 2023	`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 (32 位元)	`sudo start amazon-ssm-agent`
Ubuntu Server (64 位元 - Deb)	`sudo systemctl enable amazon-ssm-agent` `sudo systemctl start amazon-ssm-agent`
Ubuntu Server (64 位元 - Snap)	`sudo snap start amazon-ssm-agent`
Windows Server	在中執行下列命令 PowerShell。 `Start-Service AmazonSSMAgent`

狀態：未安裝

在某些情況下，命令輸出表明代理程式未安裝。

下列範例顯示在 Amazon Linux 2 執行個體上未安裝 SSM Agent。

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

下列範例顯示在 Windows Server 執行個體上未安裝 SSM Agent。

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

如果未安裝代理程式，您可以使用適用於您作業系統類型的程序手動安裝︰

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

了解技術詳細資訊 SSM Agent

在 Linux 的 EC2 執行個體使用 SSM Agent