

• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 在 Amazon Linux 2 和 Amazon Linux 2023 实例上手动安装 SSM Agent
<a name="agent-install-al2"></a>

在大多数情况下，AWS 提供的适用于 Amazon Linux 2 和 Amazon Linux 2023 的 Amazon Machine Images（AMIs）附带默认情况下预安装的 AWS Systems Manager 代理（SSM Agent）。有关更多信息，请参阅 [查找预装了 SSM Agent 的 AMIs](ami-preinstalled-agent.md)。

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

**开始前的准备工作**  
在 Amazon Linux 2 或 Amazon Linux 2023 实例上安装 SSM Agent 之前，请注意以下事项：
+ 有关适用于在所有基于 Linux 的操作系统上安装 SSM Agent 的重要信息，请参阅 [在适用于 Linux 的 EC2 实例上手动安装和卸载 SSM Agent](manually-install-ssm-agent-linux.md)。
+ 如果您在使用 SSM 文档 `AWS-UpdateSSMAgent` 成功安装或更新代理之后，使用 `yum` 命令来更新托管节点上的 SSM Agent，系统可能会显示以下消息：`"Warning: RPMDB altered outside of yum."`。此消息是预期中的，您可以安全地将其忽略。

**Topics**
+ [Amazon Linux 2 或 Amazon Linux 2023 上的 SSM Agent 的快速安装命令](#quick-install-al2)
+ [为您所在区域的 Amazon Linux 2 或 Amazon Linux 2023 创建自定义代理安装命令](#custom-url-al2)

## Amazon Linux 2 或 Amazon Linux 2023 上的 SSM Agent 的快速安装命令
<a name="quick-install-al2"></a>

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

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

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

1. 复制实例架构的命令并在实例上运行它。
**注意**  
即使以下命令中的 URL 包含 `ec2-downloads-windows` 目录，这些也是 Amazon Linux 2 和 Amazon Linux 2023 的正确全局安装文件。  
 **x86\$164**   

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

1. （建议）请使用以下命令验证代理是否正在运行。

   ```
   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 创建自定义代理安装命令
<a name="custom-url-al2"></a>

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

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

**提示**  
您还可以使用您构造的自定义区域 URL 替换本主题前面的 [Amazon Linux 2 或 Amazon Linux 2023 上的 SSM Agent 的快速安装命令](#quick-install-al2) 程序中的全局 URL。

在下面的命令中，将 *region* 替换为您自己的信息。有关支持的 *region* 值的列表，请参阅《Amazon Web Services 一般参考》**中的 [Systems Manager service endpoints](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) 的 **Region** 列。

**x86\$164**  

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