疑難排解 AWS Systems ManagerDistributor - AWS Systems Manager

疑難排解 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 版本或更新版本。如需詳細資訊,請參閱使用 SSM Agent 更新 Run Command演練:自動更新 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 版本或更新版本。如需詳細資訊,請參閱使用 SSM Agent 更新 Run Command演練:自動更新 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 資源名稱 (ARN)。