AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

从控制台运行命令

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

开始前的准备工作

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

根据您使用的服务 (AWS Systems Manager 或 Amazon EC2 Systems Manager),请采用下列过程之一:

使用 Run Command 发送命令 (AWS Systems Manager)

  1. https://console.www.amazonaws.cn/systems-manager/ 上打开 AWS Systems Manager 控制台。

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

    -或者-

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

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

  4. 目标部分中,指定标签或手动选择实例以指定要在其中运行该操作的实例。

    注意

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

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

  6. 对于其他参数

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

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

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

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

      注意

      如果通过选择 Amazon EC2 标签选择了目标,但不确定有多少个实例使用所选标签,则可以通过指定百分比来限制可同时运行此文档的实例的数量。

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

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

    注意

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

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

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

  10. 选择 Run

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

使用 Run Command 发送命令 (Amazon EC2 Systems Manager)

  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

  2. 在导航窗格中,展开Systems Manager服务,然后选择 Run Command

  3. 选择 Run a command

  4. Command document 部分中,选择一个文档。

  5. Select Targets by 部分中,选择 Manually Selecting Instances 以选择各个实例。或选择指定标签,通过指定一个或多个 Amazon EC2 标签选择一组实例。

  6. Execute on 字段中,选择列表中的 TargetsPercent。如果选择 Targets,则可以指定一次应允许运行命令的确切实例数,例如 10。如果选择 Percent,则可以选择一次应允许运行命令的实例的百分比,例如 30。在将 EC2 标签设为目标且您不确定将运行命令的实例总数时,Percent 是一个有用的选项。

    此功能允许您限制一次运行命令的实例数,以免影响实例性能和可用性。有关更多信息,请参阅使用目标和速率控制将命令发送到队列

  7. Stop after __ errors 字段中,指定系统停止向其他实例发送命令之前所允许的最大错误数。例如,如果您指定 1,则系统会在收到第二个错误时停止向其他实例发送命令。

    当达到此值时,将允许完成已经在运行命令的实例,但是其中一些执行也可能失败。有关更多信息,请参阅 使用目标和速率控制将命令发送到队列

  8. 在下一个部分,为您的 SSM 文档指定参数或选项。每个文档的参数和选项都不同。

  9. 对于 Comment,我们建议提供信息以帮助您在命令列表中标识此命令。

  10. 对于超时 (秒),键入在实例被视为无法访问且命令执行失败之前,Run Command 应尝试连接实例的秒数。最短为 30 秒,最长为 30 天,默认值为 10 分钟。

  11. (可选)如果要将命令输出写入 Amazon S3 存储桶,则选择将输出写入 S3 存储桶。如果选择此选项,则指定 S3 存储桶以及可选的 S3 键前缀。S3 键前缀是 S3 存储桶中的一个子文件夹。如果您对多个实例运行多个命令,子文件夹可帮助您组织 Run Command 输出。

    重要

    Amazon EC2 控制台中的 Run Command 输出页面在 2500 个字符后截断输出。在使用 Run Command 执行命令之前配置 Amazon S3 存储桶。如果命令输出超过 2500 个字符,您可在 Amazon S3 存储桶中查看完整输出。有关更多信息,请参阅创建存储桶

  12. (可选)如果要接收 Run Command 所运行命令的状态的通知,请选择 Enable SNS notifications (启用 SNS 通知)。有关为 Run Command 配置 Amazon SNS 通知的更多信息,请参阅为 AWS Systems Manager 配置 Amazon SNS 通知

    注意

    为 SSM 文档指定参数和选项之后,展开 AWS Command Line Interface命令部分。此部分包括面向不同命令行平台的可重用命令。

  13. 选择 Run,然后选择 View results

  14. 在命令列表中,选择刚刚运行的命令。如果命令仍在执行中,则选择控制台右上角的“刷新”图标。

  15. Status 列显示 SuccessFailed 时,选择 Output 选项卡。

  16. 选择 View Output。命令输出页面将显示命令执行的结果。

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

使用 Run Command 更新 SSM 代理

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

注意

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

根据您使用的服务 (AWS Systems Manager 或 Amazon EC2 Systems Manager),请采用下列过程之一:

使用 Run Command 更新 SSM 代理 (AWS Systems Manager)

  1. https://console.www.amazonaws.cn/systems-manager/ 上打开 AWS Systems Manager 控制台。

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

    -或者-

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

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

  4. 目标部分中,指定标签或手动选择实例以指定要在其中运行该操作的实例。

    注意

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

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

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

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

  6. 对于其他参数

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

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

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

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

      注意

      如果通过选择 Amazon EC2 标签选择了目标,但不确定有多少个实例使用所选标签,则可以通过指定百分比来限制可同时运行此文档的实例的数量。

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

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

    注意

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

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

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

  10. 选择 Run

使用 Run Command 更新 SSM 代理 (Amazon EC2 Systems Manager)

  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

  2. 在导航窗格中的Systems Manager服务下,选择 Run Command

  3. 选择 Run a command

  4. 对于 Command document,选择 AWS-UpdateSSMAgent

  5. Select Targets by 部分中,选择 Manually Selecting Instances 以选择各个实例。或选择指定标签,以通过指定一个或多个 Amazon EC2 标签来选择一组实例。

  6. Execute on 字段中,选择列表中的 TargetsPercent。如果选择 Targets,则可以指定一次应允许运行命令的确切实例数,例如 10。如果选择 Percent,则可以选择一次应允许运行命令的实例的百分比,例如 30。在将 EC2 标签设为目标且您不确定将运行命令的实例总数时,Percent 是一个有用的选项。

    此功能允许您限制一次运行命令的实例数,以免影响实例性能和可用性。有关更多信息,请参阅使用目标和速率控制将命令发送到队列

  7. Stop after __ errors 字段中,指定系统停止向其他实例发送命令之前所允许的最大错误数。例如,如果您指定 1,则系统会在收到第二个错误时停止向其他实例发送命令。有关更多信息,请参阅 使用目标和速率控制将命令发送到队列

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

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

  10. 对于 Comment,我们建议提供将帮助您在命令列表中标识此命令的信息。

  11. 对于超时 (秒),键入在实例被视为无法访问且命令执行失败之前,Run Command 应尝试连接实例的秒数。最短为 30 秒,最长为 30 天,默认值为 10 分钟。

  12. (可选)如果要将命令输出写入 Amazon S3 存储桶,则选择将输出写入 S3 存储桶。如果选择此选项,则指定 S3 存储桶以及可选的 S3 键前缀。S3 键前缀是 S3 存储桶中的一个子文件夹。如果您对多个实例运行多个命令,子文件夹可帮助您组织 Run Command 输出。

    重要

    Amazon EC2 控制台中的 Run Command 输出页面在 2500 个字符后截断输出。在使用 Run Command 执行命令之前配置 Amazon S3 存储桶。如果命令输出超过 2500 个字符,您可在 Amazon S3 存储桶中查看完整输出。有关更多信息,请参阅创建存储桶

  13. (可选)如果要接收 Run Command 所运行命令的状态的通知,请选择 Enable SNS notifications (启用 SNS 通知)。有关为 Run Command 配置 Amazon SNS 通知的更多信息,请参阅为 AWS Systems Manager 配置 Amazon SNS 通知

    注意

    为 SSM 文档指定参数和选项之后,展开 AWS Command Line Interface命令部分。此部分包括面向不同命令行平台的可重用命令。

  14. 选择 Run,然后选择 View results

  15. 在命令列表中,选择刚刚运行的命令。如果命令仍在执行中,则选择控制台右上角的“刷新”图标。

  16. Status 列显示 SuccessFailed 时,选择 Output 选项卡。

  17. 选择 View Output。命令输出页面将显示命令执行的结果。