Amazon Systems Manager故障排查Distributor - Amazon Systems Manager
安装了具有相同名称的错误的软件包错误：“无法检索清单：找不到软件包的最新版本”错误：“无法检索清单：验证异常”软件包不受支持（软件包缺少安装操作）错误：无法下载清单：带有名称的文档不存在上传失败。错误：找不到平台：找不到平台清单：oracle，版本 8.9，架构 x86_64
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Systems Manager Change Manager 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 Amazon Systems Manager Change Manager 可用性变更。

Amazon Systems Manager故障排查Distributor

以下信息可帮助排查使用 Distributor（Amazon Systems Manager 中的一项工具）时可能出现的问题。

安装了具有相同名称的错误的软件包

问题：您已安装了一个软件包，但 Distributor 安装了一个不同的软件包。

原因：在安装过程中，Systems Manager 先查找 Amazon 发布的软件包作为结果，然后才查找用户定义的外部软件包。如果用户定义的软件包名称与 Amazon 发布的软件包名称相同，则将安装 Amazon 软件包而不是您的软件包。

解决方案：要避免此问题，请将您的软件包命名为与 Amazon 发布的软件包不同的名称。

错误：“无法检索清单：找不到软件包的最新版本”

问题：您收到类似如下内容的错误。

Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid

原因：您使用的 SSM Agent 版本的 Distributor 版本低于 2.3.274.0。

解决方案：将 SSM Agent 版本更新为 2.3.274.0 或更高版本。有关更多信息，请参阅使用 Run Command 更新 SSM Agent或演练：使用 Amazon CLI 自动更新 SSM Agent。

错误：“无法检索清单：验证异常”

问题：您收到类似如下内容的错误。

Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name

原因：您使用的 SSM Agent 版本的 Distributor 版本低于 2.3.274.0。

解决方案：将 SSM Agent 版本更新为 2.3.274.0 或更高版本。有关更多信息，请参阅使用 Run Command 更新 SSM Agent或演练：使用 Amazon CLI 自动更新 SSM Agent。

软件包不受支持（软件包缺少安装操作）

问题：您收到类似如下内容的错误。

Package is not supported (package is missing install action)

原因：软件包目录结构不正确。

解决方案：不要压缩包含软件和所需脚本的父目录。相反，应直接在绝对路径中创建一个包含所有所需内容的 .zip 文件。要验证是否已正确创建 .zip 文件，请解压缩目标平台目录，并审核目录结构。例如，安装脚本绝对路径应为 /ExamplePackage_targetPlatform/install.sh。

错误：无法下载清单：带有名称的文档不存在

问题：您收到类似如下内容的错误。

Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.

原因 1：在共享来自其他账户的 Distributor 软件包时，Distributor 无法通过软件包名称找到该软件包。

解决方案 1：在共享来自其他账户的软件包时，请使用软件包的 Amazon 资源名称（ARN），而不只是软件包名称。

原因 2：在使用 VPC 时，没有向自己的 IAM 实例配置文件提供对 Amazon 托管式 S3 存储桶的访问权限，而该存储桶包含目标 Amazon Web Services 区域适用的 AWS-ConfigureAWSPackage 档案。

解决方案 2：确保自己的 IAM 实例配置文件提供向 SSM Agent 提供了对 Amazon 托管式 S3 存储桶（该存储桶包含目标 Amazon Web Services 区域适用的 AWS-ConfigureAWSPackage 文档）的访问权限，如 SSM Agent 与 Amazon 托管 S3 存储桶进行通信中所述。

上传失败。

问题：您收到类似如下内容的错误：

Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.

原因：您软件包的名称中包含空格。例如，Hello World.msi 将无法上传。

错误：找不到平台：找不到平台清单：oracle，版本 8.9，架构 x86_64

问题：您收到类似如下内容的错误：

Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64

原因：此错误表示 JSON 软件包清单没有该平台（在本例中为 Oracle Linux）对应的任何定义。

解决方法：从 Trend Micro Deep Security Software 网站下载要分发的软件包。使用 使用简单工作流创建软件包 创建 .rpm 软件包。为软件包设置以下值，然后使用 Distributor 完成软件包上传：

Platform version: _any
Target platform: oracle
Architecture: x86_64