疑難排解 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 將無法上傳。