排除 Amazon Systems ManagerDistributor 的故障 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

排除 Amazon Systems ManagerDistributor 的故障

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

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

问题:您已安装了一个软件包,但 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演练:自动更新 SSM Agent (CLI)

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

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

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演练:自动更新 SSM Agent (CLI)

软件包不受支持(软件包缺少安装操作)

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

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 Resource Name (ARN)。