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

安装软件包

您可以使用 AWS Management Console 或 AWS CLI 通过 AWS Systems Manager Distributor 将软件包部署到 AWS Systems Manager 托管实例。目前,一条命令只能部署一个软件包的一个版本。您可以选择部署软件包的特定版本,也可以选择始终部署软件包的最新版本。

Preference AWS Systems Manager 操作 更多信息

立即安装软件包。

Run Command

一次性安装软件包(控制台) 或者 一次性安装软件包 (AWS CLI)

按计划安装软件包,以便安装始终包含默认版本。

状态管理器

计划软件包安装(控制台) 或者 计划软件包安装 (AWS CLI)

在具有特定标签或标签集的新实例上自动安装软件包。例如,在新实例上安装 Amazon CloudWatch 代理。

状态管理器

执行此操作的一种方法是向新实例应用标签,然后在 状态管理器 关联中将此标签指定为目标。状态管理器 自动将关联中的软件包安装到具有匹配标签的实例上。请参阅创建使用目标和速率控制的关联 (CLI)

一次性安装软件包(控制台)

您可以使用 AWS Systems Manager 控制台一次性安装软件包。配置一次性安装时,Distributor 使用 AWS Systems Manager Run Command 执行安装。

一次性安装软件包(控制台)

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

  2. 在导航窗格中,选择 Distributor

  3. 在 Distributor 主页上,选择要安装的软件包。

  4. 要安装默认软件包版本,您可以从包详细信息页面中选择 Install package (安装软件包)。要安装其他版本,请选择 Versions (版本) 选项卡,选择要安装的版本,然后选择 Install package (安装软件包)

  5. Install package (安装软件包) 中,选择 Install one time (一次性安装)

    此命令将打开 Systems Manager Run Command 并选中命令文档 AWS-ConfigureAWSPackage 和 Distributor 软件包。

  6. Action (操作) 的值保持为 Install (安装)。对于 Name (名称),输入要安装的软件包的名称。

  7. 对于 Version (版本),输入软件包的 Version name (版本名称) 值。如果将此字段留空,Run Command 将安装在 Distributor 中选择的默认版本。

  8. Targets (目标) 中,通过指定托管实例共享的标签键和值来选择目标托管实例,或使用七个属性中的任何一个(例如实例 ID、平台、 SSM 代理 版本)指定实例。

  9. 可以使用高级选项添加有关安装的注释、更改 Rate control (速率控制) 中的 Concurrency (并发)Error threshold (错误阈值) 值、指定输出选项或配置 Amazon Simple Notification Service (Amazon SNS) 通知。有关更多信息,请参阅本指南中的从控制台运行命令

  10. 做好安装软件包的准备后,选择 Run (运行),然后选择 View results (查看结果)

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

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

  13. 选择 View output (查看输出)。命令输出页面将显示命令执行的结果。

计划软件包安装(控制台)

您可以使用 AWS Systems Manager 控制台按计划安装软件包。指定按计划安装软件包时,Distributor 使用 AWS Systems Manager 状态管理器 执行安装。

计划软件包安装(控制台)

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

  2. 在导航窗格中,选择 Distributor

  3. 在 Distributor 主页上,选择要安装的软件包。

  4. 要安装默认软件包版本,您可以从包详细信息页面中选择 Install package (安装软件包)。要安装其他版本,请选择 Versions (版本) 选项卡,选择要安装的版本,然后选择 Install package (安装软件包)。如果未选择版本,Systems Manager 将安装默认版本。

  5. Install package (安装软件包) 中,选择 Install on a schedule (按计划安装)

    此命令将打开 Systems Manager 状态管理器 并跳转到为您创建的新关联。

  6. Name (名称) 中,输入名称(例如,Deploy-test-agent-package)。您可以自由选择,但我们建议您这样做。名称不得包含空格。

  7. Command document (命令文档) 列表中,文档名称 AWS-ConfigureAWSPackage 已处于选中状态。验证 Package (软件包) 的值已设置为软件包的名称。验证在 Parameters (参数)Operation (操作) 中,已选中 Install (安装)

  8. 对于 Targets (目标),选择 Selecting all managed instances in this account (选择此账户中的所有托管实例)Specifying tags (指定标签)Manually Selecting Instance (手动选择实例)。如果使用标签将资源设置为目标,请在提供的字段中输入标签键和标签值。

  9. 对于 Specify schedule (指定计划),选择 On Schedule (按计划) 定期运行此关联,或选择 No Schedule (无计划) 只运行此关联一次。有关这些选项的更多信息,请参阅本指南中的创建关联 (控制台)。使用控件为关联创建 cron 或频率计划。

  10. 有关高级选项(例如合规性严重级别、速率控制和输出选项)的更多信息,请参阅本指南中的创建关联 (控制台)。完成关联编辑后,选择 Save Changes (保存更改)

  11. 在关联的主页上,选择 Apply association now (立即应用关联)

    状态管理器 在指定的实例或目标中创建并立即运行关联。有关运行关联的结果的更多信息,请参阅本指南中的创建关联 (控制台)

一次性安装软件包 (AWS CLI)

您可以在 AWS CLI 中运行 send-command 一次性安装 Distributor 软件包。

一次性安装软件包 (AWS CLI)

  • 在 AWS CLI 中运行以下命令。

    aws ssm send-command --document-name "AWS-ConfigureAWSPackage" --instance-ids "instance-IDs" --parameters '{"action":["Install"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

    以下是示例。

    aws ssm send-command --document-name "AWS-ConfigureAWSPackage" --instance-ids "i-00000000000000" --parameters '{"action":["Install"],"name":["ExamplePackage"]}'

有关可以与 send-command 命令配合使用的其他选项的信息,请参阅 AWS Systems Manager section of the AWS CLI Command Reference 中的 send-command

计划软件包安装 (AWS CLI)

您可以在 AWS CLI 中运行 create-association 按计划安装 Distributor 软件包。--name的值(文档名称)始终为 AWS-ConfigureAWSPackage。以下命令使用键 InstanceIds 指定目标实例。

aws ssm create-association --name "AWS-ConfigureAWSPackage" --parameters '{"action":["Install"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

以下是示例。

aws ssm create-association --name "AWS-ConfigureAWSPackage" --parameters '{"action":["Install"],"name":["Test-ConfigureAWSPackage"]}' --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-000100010000010\",\"i-020100010000011\"]}]

有关可以在 create-association 命令中使用的其他选项的信息,请参阅《AWS Systems Manager section of the AWS CLI Command Reference》中的 create-association