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

将软件包版本添加到 Distributor

要添加软件包版本,您需要创建软件包和清单,将其上传到 Amazon S3,然后使用 Distributor 通过向旧版本已存在的文档中添加条目来添加软件包版本。为了节省时间,可以更新旧版本包的清单,更改清单中 version 条目的值(例如,从 Test_1.0 更改为 Test_2.0),并将其保存为新版本的清单。

新的软件包版本可以:

  • 替换附加到当前版本的至少一个 ZIP 文件。

  • 添加新的 ZIP 文件以支持其他平台。

  • 删除文件以停止对特定平台的支持。

较新的版本可以使用相同的 S3 存储桶,但必须具有末尾显示不同文件名的 URL。您可以使用 AWS Systems Manager 控制台或 AWS CLI 添加新版本。

添加软件包版本(控制台)

在执行以下步骤前,请按照创建软件包中的说明为此版本创建一个新软件包。然后,使用 AWS Systems Manager 控制台将新的软件包版本添加到 Distributor。

添加软件包版本(控制台)

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

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

  3. 在 Distributor 主页上,选择要为其添加其他版本的软件包。

  4. Add package version (添加软件包版本) 页面上,输入新软件包版本的说明。说明的最大长度为 512 个字符。

  5. (可选)如果未将 JSON 清单上传到存储 ZIP 文件的 S3 存储桶,则可以在 JSON manifest (JSON 清单) 字段中编写清单或粘贴整个 JSON 清单。有关如何创建 JSON 清单的更多信息,请参阅步骤 2:创建 JSON 软件包清单

  6. Version name (版本名称) 中,输入清单文件中 version 条目的确切值。

  7. Package location (软件包位置) 中,粘贴您将软件包上传到 S3 时复制的 URL,然后选择 Add package version (添加软件包版本)

  8. 在软件包的 Details (详细信息) 页面的 Versions (版本) 选项卡上,在可用软件包版本列表中查看新版本。通过以下方式设置软件包的默认版本:选择一个版本,然后选择 Set default version (设置默认版本)

    如果不设置默认版本,则最新的软件包版本即为默认版本。

添加软件包版本 (AWS CLI)

您可以使用 AWS CLI 将新的软件包版本添加到 Distributor。在运行以下命令前,必须创建新的软件包版本并将其上传到 S3,如本主题开头所述。

添加软件包版本 (AWS CLI)

  1. 运行下面的命令并附上新软件包版本的条目来编辑 AWS Systems Manager 文档。将 document-name 替换为您的文档的名称。将 S3-bucket-URL-to-manifest-file 替换为您在步骤 3:将软件包和清单上传到 Amazon S3 存储桶中复制的 JSON 清单的 URL。S3-bucket-URL-of-package 是存储整个软件包的 S3 存储桶的 URL。将 version-name-from-updated-manifest 替换为清单中 version 的值。将 --document-version 参数设置为 $LATEST,以使与此软件包版本关联的文档成为文档的最新版本。

    aws ssm update-document --name "document-name" --content "S3-bucket-URL-to-manifest-file" --attachments Key="SourceUrl",Values="S3-bucket-URL-of-package" --version-name version-name-from-updated-manifest --document-version $LATEST

    以下是示例。

    aws ssm update-document --name ExamplePackage --content "https://s3.amazonaws.com/mybucket/ExamplePackage/manifest.json" --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/mybucket/ExamplePackage" --version-name 1.1.1 --document-version $LATEST
  2. 运行以下命令来验证软件包已更新并显示包清单。将 package-name 替换为您的软件包名称,(可选)将 document-version 替换为更新的文档的版本号(不同于软件包的版本)。如果此软件包版本与文档的最新版本关联,则可以为可选的 --document-version 参数的值指定 $LATEST

    aws ssm get-document --name "package-name" --document-version "document-version"

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