查找预装了 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 Base 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

  • 2016 年 11 月或以后发布的 Windows Server 2008-2012 R2 AMIs

  • Windows Server 2016、2019 和 2022（排除 Nano 版本）

注意

预装在 AMI 上的 SSM Agent 版本可能不是最新的可用版本。作为最佳实操，我们建议您始终在受管节点上使用最新可用的 SSM Agent 版本。有关自动 SSM Agent 更新的更多信息，请参阅 自动更新到 SSM Agent。

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

  1. 启动新实例后，请等待几分钟，以便其完成初始化。

  2. 使用您的首选方法连接到实例。例如，您可以使用 SSH 连接到 Linux 实例，或使用远程桌面连接到 Windows Server 实例。

  3. 根据实例的操作系统类型运行命令，以检查 SSM Agent 的状态。

    操作系统 命令
    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

    如果代理已安装但并未运行，您可以根据实例的操作系统类型使用命令手动激活代理。

    操作系统 命令
    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--

    如果未安装代理，您可以根据操作系统类型使用程序手动安装：