AWS Systems ManagerDistributor 故障排除

以下信息可帮助您对使用 AWS Systems Manager 的功能 Distributor 时可能发生的问题进行故障排除。

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

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

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

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

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

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

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或演练：使用 AWS 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或演练：使用 AWS 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.

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

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

上传失败。

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

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

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