本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
疑難排解 AWS Systems ManagerDistributor
下列資訊可協助您疑難排解使用Distributor功能時可能發生的問題 AWS Systems Manager。
安裝了相同名稱的錯誤套件
問題:您已安裝套件,但 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 或 演練:自動更新 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),而不是只使用其名稱。
上傳失敗。
問題:您收到了以下錯誤:
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
原因:軟體套件的名稱包含空格。例如,Hello World.msi
將無法上傳。