预安装了 SSM Agent 的 Amazon Machine Images(AMIs) - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

预安装了 SSM Agent 的 Amazon Machine Images(AMIs)

Amazon Systems Manager 代理(SSM Agent)预安装在 Amazon 提供的一些 Amazon Machine Images(AMIs)上。

例如,使用以下操作系统之一启动从 AMI 创建的 Amazon Elastic Compute Cloud(Amazon EC2)实例时,您可能会发现 SSM Agent 已安装:

  • 2017 年 9 月及更高版本的 Amazon Linux Base AMI

  • Amazon Linux 2

  • Amazon Linux 2 ECS 优化基础 AMIs

  • Amazon EKS 优化版 Amazon Linux AMIs

  • macOS 10.14.x (Mojave)、10.15.x (Catalina) 和 11.x (Big Sur)

  • SUSE Linux Enterprise Server (SLES) 12 和 15

  • Ubuntu Server 16.04、18.04 和 20.04

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

  • Windows Server 2016、2019 和 2022

虽然非常少见,但从上述列表中的 AMIs 创建的实例可能没有安装代理,或者已安装代理但未运行。因此,我们建议您每次从 Amazon 托管的 AMI 安装实例时,使用以下程序。这样,您可以在尝试使用 System s Manager 之前验证 SSM Agent 是否已安装且正在运行。

如果您发现 SSM Agent 未安装,则可以在 LinuxmacOSWindows Server 上手动安装。

注意

SSM Agent 可能已预安装在 Amazon Web Services Marketplace 或社区 AMIs 存储库中的 AMIs 上,但是,Amazon 不支持这些 AMIs。

SSM Agent 也可能已预安装在 Amazon 托管的 AMIs 上,而其操作系统不在上述列表中。这通常表明并非所有的 Systems Manager 组件或功能都支持该操作系统。在这种情况下,虽然预计 Systems Manager 在将来会完全支持该操作系统,但该预期得不到保证。

要验证实例上是否已安装 SSM Agent

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

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

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

    Amazon Linux

    sudo systemctl status amazon-ssm-agent

    Amazon Linux 2

    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-bit)

    sudo status amazon-ssm-agent

    Ubuntu Server (64-bit - Deb)

    sudo systemctl status amazon-ssm-agent

    Ubuntu Server (64-bit - Snap)

    sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service

    Windows Server

    在 PowerShell 中运行以下命令。

    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

    sudo systemctl start amazon-ssm-agent

    Amazon Linux 2

    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-bit)

    sudo start amazon-ssm-agent

    Ubuntu Server (64-bit - Deb)

    sudo systemctl enable amazon-ssm-agent

    sudo systemctl start amazon-ssm-agent

    Ubuntu Server (64-bit - 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--

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