在 Amazon Linux 2 和 Amazon Linux 2023 实例上手动安装 SSM Agent - Amazon Systems Manager
Amazon Linux 2 或 Amazon Linux 2023 上的 SSM Agent 的快速安装命令为您所在区域的 Amazon Linux 2 或 Amazon Linux 2023 创建自定义代理安装命令
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

重要

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

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

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

开始前的准备工作

在 Amazon Linux 2 或 Amazon Linux 2023 实例上安装 SSM Agent 之前，请注意以下事项：

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

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

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

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

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

  1. 使用首选方法（例如 SSH）连接到您的 Amazon Linux 2 或 Amazon Linux 2023 实例。

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

    注意

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

    x86_64
    sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/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. （建议）请使用以下命令验证代理是否正在运行。

    sudo systemctl status amazon-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--

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

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

    要在这些情况下激活代理，请运行以下命令。

    sudo systemctl start amazon-ssm-agent

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

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

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

提示

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

在下面的命令中，将 region 替换为您自己的信息。有关支持的 region 值的列表，请参阅《Amazon Web Services 一般参考》中的 Systems Manager service endpoints 的 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
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