在 Amazon Linux 实例上手动安装 SSM Agent - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

在 Amazon Linux 实例上手动安装 SSM Agent

重要

本主题提供了在 Amazon Linux 实例上使用 SSM Agent 的命令。其中一些命令不适用于 Amazon Linux 2 实例。在继续操作之前,请验证您正在查看的主题是否与您的实例类型对应。有关要在 Amazon Linux 2 实例上运行的命令,请参阅 在 Amazon Linux 2 实例上手动安装 SSM Agent

在大多数情况下,Amazon 提供的适用于 Amazon Linux 的 Amazon Machine Images(AMIs)附带默认情况下预安装的 Amazon Systems Manager 代理(SSM Agent)。有关更多信息,请参阅预安装了 SSM Agent 的 Amazon Machine Images(AMIs)

如果 SSM Agent 未预安装在新的 Amazon Linux 实例上,或者如果您需要手动重新安装代理,请使用此页面上的信息来帮助您。

开始前的准备工作

在 Amazon Linux 实例上安装 SSM Agent 之前,请注意以下事项:

  • 有关适用于在所有基于 Linux 的操作系统上安装 SSM Agent 的重要信息,请参阅 在适用于 Linux 的 EC2 实例上手动安装 SSM Agent

  • 通过使用代理的 Amazon Linux AMI 创建的托管式节点必须运行当前版本的 Python requests 模块,才能支持 Patch Manager 操作。有关更多信息,请参阅在使用代理服务器的 Amazon Linux 实例上升级 Python 请求模块

  • 如果您在代理已使用 SSM 文档 AWS-UpdateSSMAgent 成功安装或更新之后使用 yum 命令来更新托管式节点上的 SSM Agent,系统可能会显示以下消息:“Warning: RPMDB altered outside of yum.”(警告:RPMDB 在 yum 之外发生更改。) 该消息是预期消息,可以安全忽略。

Amazon Linux 上的 SSM Agent 的快速安装命令

使用以下步骤在单个实例上手动安装 SSM Agent。此过程使用全局可用的安装文件。

使用快速复制和粘贴命令在 Amazon Linux 上安装 SSM Agent

  1. 使用首选方法(例如 SSH)连接到您的 Amazon Linux 实例。

  2. 复制实例架构的命令并在实例上运行它。

    注意

    即使以下命令中的 URL 包含 ec2-downloads-windows 目录,这些也是 Amazon Linux 的正确全局安装文件。

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
    x86
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_386/amazon-ssm-agent.rpm
    ARM64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
  3. (推荐)为实例架构运行命令,以验证代理是否正在运行。

    x86_64–和–x86
    sudo status amazon-ssm-agent
    ARM64
    sudo systemctl status amazon-ssm-agent

    在大多数情况下,命令会报告代理正在运行,如下面的示例所示。

    x86_64–和–x86
    amazon-ssm-agent start/running, process 12345
    ARM64
    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--

    在极少数情况下,命令会报告代理已安装但未运行,如下面的示例所示。

    x86_64–和–x86
    amazon-ssm-agent stop/waiting
    ARM64
    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--

    要在这些情况下激活代理,请运行实例架构的命令。

    x86_64–和–x86
    sudo start amazon-ssm-agent
    ARM64
    sudo systemctl start amazon-ssm-agent

为您所在区域的 Amazon Linux 创建自定义代理安装命令

当您使用脚本或模板在多个实例上安装 SSM Agent 时,我们建议使用存储在您工作所在的 Amazon Web Services 区域 中的安装文件。

对于以下命令,我们提供了在美国东部(俄亥俄州)区域(us-east-2)使用可公开访问 Amazon S3 存储桶的示例。

提示

您还可以使用您构造的自定义区域 URL 替换本主题前面的 Amazon Linux 上的 SSM Agent 的快速安装命令 程序中的全局 URL。

在下面的命令中,将 region 替换为您自己的信息。有关受支持的 region 值的列表,请参阅 Amazon Web Services 一般参考中的 Systems Manager 服务终端节点中的 Region(区域)列。

x86_64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm

请参阅以下 示例。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
x86
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_386/amazon-ssm-agent.rpm

请参阅以下 示例。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_386/amazon-ssm-agent.rpm
ARM64
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm

请参阅以下 示例。

sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm