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
将无法上传。