将软件包版本添加到 Distributor

访问 https://console.aws.amazon.com/systems-manager/，打开 Amazon Systems Manager 控制台。

在导航窗格中，选择 Distributor。

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

在 Add version (添加版本) 页面上，选择 Simple (简单)。

对于 Version name (版本名称)，请输入版本名称。新版本的版本名称必须与旧版本名称不同。版本名称最多可以包含 512 个字符，并且不能包含特殊字符。

对于 S3 存储桶名称，从列表中选择现有的 S3 存储桶。这可以是用于存储旧版本的可安装文件的同一个存储桶，但可安装文件名必须不同，以避免覆盖存储桶中的现有可安装文件。

对于 S3 key prefix (S3 键前缀)，请输入存储可安装资产的存储桶子文件夹。

对于 Upload software (上载软件)，请导航到要附加到新版本的可安装软件文件。现有版本中的可安装文件不会自动复制到新版本；如果您希望任何相同的可安装文件成为新版本的一部分，则必须上载旧版软件包中的任何可安装文件。您可以在单个操作中上传多个软件文件。

对于目标平台，请验证为每个可安装文件显示的目标操作系统平台是否正确。如果显示的操作系统不正确，请从下拉列表中选择正确的操作系统。

在简单版本控制工作流程中，由于您只上传每个可安装文件一次，因此需要额外的步骤在多个操作系统上将单个文件指定为目标。例如，如果您上传名为 Logtool_v1.1.1.rpm 的可安装软件文件，则必须更改简单工作流程中的某些默认值，以指示 Distributor 同时在 Amazon Linux 和 Ubuntu 操作系统上将相同的软件指定为目标。您可以执行以下操作之一来解决此限制。

对于 Platform version (平台版本)，验证并确保所显示的操作系统平台版本是 _any（主要发行版本后跟一个通配符 (7.*)），或您希望软件适用于的确切操作系统发行版本。有关指定平台版本的更多信息，请参阅 步骤 2：创建 JSON 软件包清单 中的步骤 4。

对于架构，请从下拉列表中为每个可安装文件选择正确的处理器架构。有关支持的架构的更多信息，请参阅 支持的软件包平台和架构。

（可选）展开 Scripts (脚本)，然后查看 Distributor 为可安装软件生成的安装和卸载脚本。

要向新版本添加更多可安装的软件文件，请选择 Add software (添加软件)。否则，转到下一步。

（可选）展开清单，然后审核 Distributor 为您的可安装软件包生成的 JSON 清单。如果您在开始此过程后更改了有关可安装软件的任何信息（例如平台版本或目标平台），请选择生成清单以显示更新的软件包清单。

如果要将可在多个操作系统上安装的软件指定为目标，则可以手动编辑清单，如步骤 9 中所述。有关编辑该清单的更多信息，请参阅 步骤 2：创建 JSON 软件包清单。

完成添加软件和审核目标平台、版本和架构数据时，请选择 Add version (添加版本)。

等待 Distributor 完成上传软件和创建新的软件包版本。Distributor 显示每个可安装文件的上传状态。根据要添加的软件包的数量和大小，这可能需要几分钟时间。Distributor 会自动将您重定向到软件包的 Package details (软件包详细信息) 页面，但您可以选择在上传软件之后自行打开此页面。Package details (软件包详细信息) 页面不会显示有关软件包的所有信息，直到 Distributor 完成创建新的软件包版本为止。要停止上传和软件包版本创建，请选择 Stop upload (停止上传)。

如果 Distributor 无法上载任何软件可安装文件，它会显示 Upload failed (上载失败) 消息。要重试上传，请选择 Retry upload (重试上传)。有关如何排除软件包版本创建失败的更多信息，请参阅 排除 Amazon Systems ManagerDistributor 的故障。

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

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

访问 https://console.aws.amazon.com/systems-manager/，打开 Amazon Systems Manager 控制台。

在导航窗格中，选择 Distributor。

在 Distributor 主页上，选择要向其添加其他版本的软件包，然后选择 Add version (添加版本)。

对于 Version name (版本名称)，请输入位于清单文件的 version 条目中的确切值。

对于 S3 存储桶名称，从列表中选择现有的 S3 存储桶。这可以是用于存储旧版本的可安装文件的同一个存储桶，但可安装文件名必须不同，以避免覆盖存储桶中的现有可安装文件。

对于 S3 key prefix (S3 键前缀)，请输入存储可安装资产的存储桶子文件夹。

对于 Manifest (清单)，请选择 Extract from package (从软件包提取) 以使用随 .zip 文件上传到 S3 存储桶的清单。

（可选）如果未将修订的 JSON 清单上载到存储 .zip 文件的 Amazon S3 存储桶，请选择 New manifest (新建清单)。您可以在 JSON 编辑器字段中编写或粘贴整个清单。有关如何创建 JSON 清单的更多信息，请参阅 步骤 2：创建 JSON 软件包清单。

当您完成处理清单后，选择 Add package version (添加软件包版本)。

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

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

运行下面的命令并附上新软件包版本的条目来编辑 Amazon Systems Manager 文档。将 document-name 替换为您的文档的名称。将 DOC-EXAMPLE-BUCKET 替换为您在 步骤 3：将软件包和清单上载到 Amazon S3 存储桶 中复制的 JSON 清单的 URL。S3-bucket-URL-of-package 是存储整个软件包的 Amazon 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="DOC-EXAMPLE-BUCKET" \
    --version-name version-name-from-updated-manifest \
    --document-version $LATEST

以下是示例。

aws ssm update-document \
    --name ExamplePackage \
    --content "https://s3.amazonaws.com/DOC-EXAMPLE-BUCKET/ExamplePackage/manifest.json" \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/DOC-EXAMPLE-BUCKET/ExamplePackage" \
    --version-name 1.1.1 \
    --document-version $LATEST

运行以下命令来验证软件包已更新并显示包清单。将 package-name 替换为您的软件包名称，（可选）将 document-version 替换为更新的文档的版本号（不同于软件包的版本）。如果此软件包版本与文档的最新版本关联，则可以为可选的 --document-version 参数的值指定 $LATEST。

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