AWS Systems Manager
用户指南

从控制台运行命令

您无需登录到每个实例就可以从控制台使用 Run Command 配置实例。此主题中的示例说明如何使用 Run Command 在实例上更新 SSM 代理

开始前的准备工作

在使用 Run Command 发送命令之前,请验证实例是否符合 Systems Manager 要求

使用 Run Command 发送命令

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择Run Command

    -或者-

    如果 AWS Systems Manager 主页首先打开,请选择菜单图标 ( ) 以打开导航窗格,然后选择 Run Command

  3. Command document (命令文档) 列表中,选择一个 Systems Manager 文档。

  4. Targets (目标) 部分中,指定标签、手动选择实例或者指定资源组以确定要在其中运行该操作的实例。

    注意

    如果选择手动选择实例,而列表中不包含您预期看到的实例,请参阅我的实例在哪里?中的故障排除提示。

  5. 命令参数部分中,为必需的参数指定值。

  6. 对于其他参数

    • 对于注释,请键入有关该命令的信息。

    • 对于超时 (秒),请指定在整个命令执行失败之前系统等待的秒数。

  7. (可选)对于速率控制

    • 对于并发,请指定要同时运行该命令的实例数或百分比。

      注意

      如果通过指定应用于托管实例的标记或通过指定 AWS 资源组选择了目标,并且您不确定针对的是多少实例,则可以通过指定百分比来限制可同时运行此文档的实例的数量。

    • 对于错误阈值,请指定在一定数量或百分比的实例上失败后何时在其他实例上停止运行该命令。例如,如果您指定三个错误,Systems Manager 将在收到第四个错误时停止发送该命令。仍在处理命令的实例也可能发送错误。

  8. 输出选项部分中,如果您要将命令输出保存到文件,请选择将命令输出写入 Amazon S3 存储桶。在框中键入存储桶和前缀 (文件夹) 名称。

    注意

    授予将数据写入 S3 存储桶的能力的 S3 权限是分配给实例的实例配置文件的权限,而不是执行此任务的 IAM 用户的权限。有关更多信息,请参阅 为 Systems Manager 创建 IAM 实例配置文件

  9. SNS 通知部分中,如果您希望发送有关命令执行状态的通知,请选中启用 SNS 通知复选框。

    有关为 Run Command 配置 Amazon SNS 通知的更多信息,请参阅为 AWS Systems Manager 配置 Amazon SNS 通知

  10. 选择运行

有关取消命令的信息,请参阅 取消命令

使用 Run Command 更新 SSM 代理

以下过程介绍了如何快速更新在 Windows 和 Linux 实例上运行的 SSM 代理。您可以更新到最新版本或降级到较旧版本。在运行命令时,系统将从 AWS 下载并安装需要的版本,然后卸载运行命令前存在的版本。如果此过程中出现错误,系统将回滚到命令运行之前服务器上的版本,并且命令状态将显示命令失败。

注意

要获得有关 SSM 代理 更新的通知,请在 GitHub 上订阅 SSM 代理 发布说明页面。

使用 Run Command 更新 SSM 代理

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.aws.amazon.com/systems-manager/

  2. 在导航窗格中,选择Run Command

    -或者-

    如果 AWS Systems Manager 主页首先打开,请选择菜单图标 ( ) 以打开导航窗格,然后选择 Run Command

  3. Command document 列表中,选择 AWS-UpdateSSMAgent

  4. Targets (目标) 部分中,指定标签、手动选择实例或者指定资源组以确定要在其中运行该操作的实例。

    注意

    如果选择手动选择实例,而列表中不包含您预期看到的实例,请参阅我的实例在哪里?中的故障排除提示。

  5. 命令参数部分中,根据需要为以下参数指定值:

    1. (可选)对于 Version (版本),键入要安装的 SSM 代理的版本。您可以安装代理的较旧版本。如果您不指定版本,则服务将安装最新版本。

    2. (可选)对于 Allow Downgrade (允许降级),选择 true (真) 以安装 SSM 代理的早期版本。如果选择此选项,则必须指定较早的版本号。选择 false 以仅安装此服务的最新版本。

  6. 对于其他参数

    • 对于注释,请键入有关该命令的信息。

    • 对于超时 (秒),请指定在整个命令执行失败之前系统等待的秒数。

  7. (可选)对于速率控制

    • 对于并发,请指定要同时运行该命令的实例数或百分比。

      注意

      如果通过指定应用于托管实例的标记或通过指定 AWS 资源组选择了目标,并且您不确定针对的是多少实例,则可以通过指定百分比来限制可同时运行此文档的实例的数量。

    • 对于错误阈值,请指定在一定数量或百分比的实例上失败后何时在其他实例上停止运行该命令。例如,如果您指定三个错误,Systems Manager 将在收到第四个错误时停止发送该命令。仍在处理命令的实例也可能发送错误。

  8. 输出选项部分中,如果您要将命令输出保存到文件,请选择将命令输出写入 Amazon S3 存储桶。在框中键入存储桶和前缀 (文件夹) 名称。

    注意

    授予将数据写入 S3 存储桶的能力的 S3 权限是分配给实例的实例配置文件的权限,而不是执行此任务的 IAM 用户的权限。有关更多信息,请参阅 为 Systems Manager 创建 IAM 实例配置文件

  9. SNS 通知部分中,如果您希望发送有关命令执行状态的通知,请选中启用 SNS 通知复选框。

    有关为 Run Command 配置 Amazon SNS 通知的更多信息,请参阅为 AWS Systems Manager 配置 Amazon SNS 通知

  10. 选择运行