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

原因: バージョン 2.3.274.0 より前の Distributor で SSM Agent のバージョンを使用しています。

解決策: 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

原因: バージョン 2.3.274.0 より前の Distributor で SSM Agent のバージョンを使用しています。

解決策: 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 ファイルを絶対パスに直接作成します。.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 はアップロードに失敗するでしょう。