在 Amazon EC2 Linux 实例上手动安装 SSM 代理

使用以下脚本之一在下列 Linux 实例上安装 SSM 代理。

Raspbian

本部分包括有关如何在 Raspbian Jessie 和 Raspbian Stretch (包括 Raspberry Pi (32 位) 设备) 上安装 SSM 代理的信息。

开始前的准备工作

要将 Raspbian 设备设置为 Systems Manager 托管实例，您需要创建托管实例激活。完成激活后，您将收到一个激活代码和 ID。此代码/ID 组合具有 Amazon EC2 访问 ID 和秘密访问密钥的功能，可提供从托管实例对 Systems Manager 服务的安全访问。在安全位置存储激活代码和 ID。有关激活流程的更多信息，请参阅为混合环境设置 AWS Systems Manager。

连接到您的 Raspbian 设备并执行下列步骤来安装 SSM 代理。使用 Systems Manager 对每个将运行命令的实例执行这些步骤。

在 Raspbian 设备上安装 SSM 代理

在实例上创建临时目录。
```
mkdir /tmp/ssm
```

使用以下命令下载和运行 SSM 代理安装程序。

sudo curl https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_arm/amazon-ssm-agent.deb -o /tmp/ssm/amazon-ssm-agent.deb

运行以下命令安装 SSM 代理：

sudo dpkg -i /tmp/ssm/amazon-ssm-agent.deb

运行以下命令停止 SSM 代理。
```
sudo service amazon-ssm-agent stop
```
运行以下命令，以使用您完成托管实例激活过程时收到的托管实例激活代码和 ID 注册代理。
```
sudo amazon-ssm-agent -register -code "code" -id "ID" -region "region"
```
运行以下命令启动 SSM 代理。
```
sudo service amazon-ssm-agent start
```

注意

如果在 SSM 代理错误日志中看到以下错误，说明计算机 ID 在重启后发生变更：

Unable to load instance associations, unable to retrieve associations unable to retrieve associations error occurred in RequestManagedInstanceRoleToken: MachineFingerprintDoesNotMatch: Fingerprint does not match

运行以下命令使计算机 ID 在重启后保持不变。
```
umount /etc/machine-id
systemd-machine-id-setup
```
SSM 代理的更新版本在有新功能添加到 Systems Manager 或者对现有功能进行了更新时发布。如果较早版本的代理运行在实例上，一些 SSM 代理过程会失败。因此，我们建议您自动完成确保实例上的 SSM 代理为最新的过程。有关信息，请参阅自动更新到 SSM 代理。要获得有关 SSM 代理更新的通知，请在 GitHub 上订阅 SSM 代理发布说明页面。