• Amazon Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
# 自动更新到 SSM Agent
在添加或更新 Systems Manager 工具时，Amazon 会发布一个新版本的 Amazon Systems Manager Agent（SSM Agent）。如果托管式节点使用旧版本的代理，则您无法使用全新的工具或从更新后的工具中受益。出于这些原因，我们建议您使用以下任意一种方法自动完成托管式节点上的 SSM Agent 更新过程。
**Bottlerocket 操作系统上的代理更新**
Bottlerocket 操作系统上的 SSM Agent 无法使用 Systems Manager 命令文档 `AWS-UpdateSSMAgent` 进行更新。更新在 Bottlerocket 控制容器中托管。有关更多信息，请参阅 GitHub 上的 [Bottlerocket 控制容器](https://github.com/bottlerocket-os/bottlerocket-control-container/blob/develop/README.md) 和 [Bottlerocket 更新操作员](https://github.com/bottlerocket-os/bottlerocket-update-operator/blob/develop/README.md)。
**macOS 版本要求**
如果实例运行 macOS 版本 11.0（Big Sur）或更高版本，则该实例必须具有 SSM Agent 版本 3.1.941.0 或更高版本才能运行 AWS-UpdateSSMAgent 文档。如果实例运行 3.1.941.0 之前发布的 SSM Agent 版本，则可以通过运行 `brew update` 和 `brew upgrade amazon-ssm-agent` 命令来更新 SSM Agent，从而运行 AWS-UpdateSSMAgent。
****
| 方法 | Details |
| --- | --- |
| 所有托管式节点上的一键式自动更新（建议） | 可以将您的 Amazon Web Services 账户 中的所有托管式节点配置为自动检查并下载新版本的 SSM Agent。为此，请在的 Fleet Manager 中的**设置**选项卡上选择 **自动更新 SSM Agent**，如本主题后面所述。 |
| 全局或选择性更新 | 您可以使用State Manager（Amazon Systems Manager 中的一项工具）创建一个关联，在托管式节点上自动下载并安装 SSM Agent。如果要限制对工作负载的中断，您可以创建 Systems Manager 维护时段在指定的时间段内执行安装。通过这两种方法，您可以为所有托管式节点创建全局更新配置，或者有选择地选择要更新的实例。有关创建 State Manager 关联的信息，请参阅 [演练：使用 Amazon CLI 自动更新 SSM Agent](state-manager-update-ssm-agent-cli.md)。有关创建维护时段的信息，请参阅 [教程：使用控制台创建修补的维护时段](maintenance-window-tutorial-patching.md)。 |
| 针对新环境的全局或选择性更新 | 如果要开始使用 Systems Manager，建议使用Quick Setup（Amazon Systems Manager 中的一项工具）中的**每两周更新 Systems Manager（SSM）Agent**选项。使用Quick Setup，您可以为所有托管式节点创建全局更新配置，或者有选择地选择要更新的托管式节点。有关更多信息，请参阅 [使用 Quick Setup 设置 Amazon EC2 主机管理](quick-setup-host-management.md)。 |
如果您希望手动更新托管式节点上的 SSM Agent，您可以订阅新代理版本发布时 Amazon 发布的通知。有关信息，请参阅[订阅 SSM Agent 通知](ssm-agent-subscribe-notifications.md)。在订阅通知后，您可以使用 Run Command 手动将一个或多个托管式节点更新为最新版本。有关更多信息，请参阅 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample)。
## 自动更新 SSM Agent
您可以将 Systems Manager 配置为自动更新 Amazon Web Services 账户 中所有基于 Linux 和基于 Windows 的托管式节点上的 SSM Agent。如果启用该选项，Systems Manager 每两周自动检查一次是否存在新版本的代理。如果存在新版本，则 Systems Manager 将自使用 `AWS-UpdateSSMAgent` 中的 SSM 文档自动将代理更新为发布的最新版本。建议您选择该选项，以确保您的托管式节点始终运行最新版本的 SSM Agent。
**注意**
如果您在使用 SSM 文档 `AWS-UpdateSSMAgent` 成功安装或更新代理之后，使用 `yum` 命令来更新托管节点上的 SSM Agent，系统可能会显示以下消息：`"Warning: RPMDB altered outside of yum."`。此消息是预期中的，您可以安全地将其忽略。
**自动更新 SSM Agent**
1. 访问 [https://console.aws.amazon.com/systems-manager/](https://console.amazonaws.cn/systems-manager/)，打开 Amazon Systems Manager 控制台。
1. 在导航窗格中，请选择 **Fleet Manager**。
1. 选择**设置**选项卡。
1. 在**代理自动更新**区域中，选择**自动更新 SSM Agent**。
要更改机群要更新到的 SSM Agent 版本，请在**设置**选项卡上的**代理自动更新**下选择**编辑**。然后，在**参数**下的**版本**中输入要更新到的 SSM Agent 版本号。如果未指定，代理将更新为最新版本。
要停止将更新后的 SSM Agent 版本自动部署到账户中的所有托管式节点，请在**设置**选项卡上的**代理自动更新**下选择**删除**。此操作将删除在托管式节点上自动更新 SSM Agent 的 State Manager 关联。