尋找預先安裝了 SSM Agent的 AMIs - AWS Systems Manager
驗證 SSM Agent 的狀態

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

尋找預先安裝了 SSM Agent的 AMIs

AWS Systems Manager 代理程式 (SSM Agent) 預先安裝在由 AWS 和信任的第三方提供的某些 Amazon Machine Images(AMIs) 上。

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

  • AlmaLinux

  • 2017 年 9 月及更新版本的 Amazon Linux 1 基本 AMI

  • Amazon Linux 2

  • Amazon Linux 2 ECS 最佳化基礎 AMIs

  • Amazon Linux 2023 (AL2023)

  • Amazon EKS 最佳化的 Amazon Linux AMIs

  • macOS 10.14.x (Mojave)、10.15.x (Catalina)、11.x (Big Sur)、12.x (Monterey)、13.x (Ventura) 和 14.x (Sonoma)

  • 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 (Nano 版本除外） 和 2025

注意

AMI 上預先安裝的 SSM Agent版本可能不是可用的最新版本。作為最佳實務，建議在受管節點上一律使用 SSM Agent 的最新可用版本。如需有關 SSM Agent自動更新的詳細資訊，請參閱 自動化 SSM Agent 更新。

SSM Agent 可能預先安裝在未列於此清單AMIs的 AWS 受管 上。這通常表示並非所有 Systems Manager 工具都完全支援作業系統 (OS)。

SSM Agent 也可能預先安裝在 AMIs 或 社群AMIs儲存庫 AWS Marketplace 中的 ，但 AWS 不支援這些 AMIs。

驗證 SSM Agent 的狀態

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

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

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

  1. 啟動新的執行個體之後，請等待幾分鐘使其完成初始化。

  2. 使用您偏好的方式連線至執行個體。例如，您可以使用 SSH 連線至 Linux 執行個體，或使用遠端桌面連線至 Windows Server 執行個體。

  3. 針對執行個體的作業系統類型執行命令，以檢查 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 狀態並啟動代理程式。

  4. 評估命令輸出，以了解 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--

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