AEM Package Managerのアップロード/アクセスのエラー(権限、ネットワーク、URL、ランタイムの制限)の解決
パッケージが表示されない、アクセスがブロックされる、またはインストールで未定義のメッセージが返される場合、パッケージマネージャーのアップロードまたはインストールが失敗する可能性があります。
パッケージマネージャーを開いたり、パッケージをアップロードしたり、アップロードしたパッケージを表示したり、インストールを完了したりできない場合があります。 場合によっては、アップロードは完了したように見えますが、パッケージがリストに表示されません。 クラウド環境では、パッケージに実行時にサポートされていない不変コンテンツが含まれている場合、インストールが失敗することがあります。
一般的な原因には、権限の欠落、不正なURL、ネットワーク制限、ブラウザー干渉、クラウド環境の不変パスを含むパッケージなどが含まれます。 アクセスパスを確認し、権限とブラウザーの動作をテストし、サポートされていないコンテンツのパッケージフィルターを確認します。 ランタイムパッケージのインストールは、可変コンテンツに対してのみ使用し、デプロイメントパイプラインを通じて不変コンテンツをデプロイします。
説明 description
環境:
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Experience Manager オンプレミス
問題/症状:
/crx/packmgrでパッケージマネージャーにアクセスできない場合は、ターゲット環境の正しいパッケージマネージャーURLを開き、/crx/packmgr/index.jspがリダイレクトエラーまたはアクセスエラーなしで読み込まれることを確認します。- パッケージマネージャーにパッケージが表示されない場合は、予想されるアクセス権を持つ別のユーザーがパッケージを表示できるか、アップロードできるかを確認して、問題が権限に関連しているかどうかを判断します。
- パッケージのアップロードが完了しても、パッケージがパッケージマネージャーに表示されない場合は、インターフェイスを更新し、小さなテストパッケージで再試行して、アップロードが正しく受け入れられ、表示されているかどうかを確認します。
- アップロードが失敗し、明確なエラーが表示されない場合は、別のネットワークから同じアクションを再試行して、ファイアウォールまたはプロキシの制限がAEMに到達する前にリクエストをブロックしているかどうかを判断します。
- インストール中にブラウザーで未定義のエラーが表示された場合は、シークレットセッションまたはサポートされている別のブラウザーでアクションを繰り返して、拡張機能、セッション、ブラウザー固有の干渉を除外します。
- サポートされていないランタイムコンテンツが含まれているため、クラウド環境がパッケージを拒否する場合は、パッケージフィルターを確認し、パッケージにランタイムインストール用の可変コンテンツのみが含まれ、
/appsなどの不変パスが含まれていないことを確認します。
根本原因:
これらのエラーは、通常、パッケージパスに対する権限の欠落、パッケージマネージャーのURLの誤り、ネットワークまたはファイアウォールの制限、リクエストを妨げるブラウザー拡張機能またはセッションの動作、アップロードをブロックするローカルセキュリティツール、クラウド環境の/appsなどの不変パスを含むパッケージフィルターが原因で発生します。
解決策 resolution
次の手順を試してください。
- ターゲット環境の正しいPackage Manager URLを開き、
/crx/packmgr/index.jspがリダイレクトエラーまたはアクセスエラーなしで読み込まれることを確認します。 - 影響を受けるユーザーが、同じレベルのアクセス権を持つと予想される別のユーザーと結果を比較して、パッケージを作成、アップロード、表示、インストールする権限を持っていることを確認します。
- パッケージマネージャーが開かない、またはアップロードが開始しない場合は、別のネットワークから同じアクションを再試行して、ファイアウォールまたはプロキシの制限がリクエストをブロックしているかどうかを判断します。
- ブラウザーでアップロードまたはインストールに失敗した場合は、シークレットセッションまたはサポートされている別のブラウザーでアクションを繰り返し、拡張機能、セッション、ブラウザー固有の干渉を除外します。
- 同じアップロードがターゲット環境とローカル SDKの両方で失敗した場合は、リクエストがAEMに到達する前にブロックされる可能性があるので、ローカルまたは組織のセキュリティ制御を確認します。
- クラウド環境の場合は、パッケージフィルターを確認し、パッケージにランタイムインストール用の可変コンテンツのみが含まれ、
/appsなどの不変パスが含まれていないことを確認します。 - パッケージに不変コンテンツが含まれる場合は、そのコンテンツをパッケージマネージャーではなくデプロイメントパイプラインを通じてデプロイします。
- 変更を行った後、小さなテストパッケージをアップロードし、パッケージマネージャーを更新して、パッケージがリストに表示され、新しいエラーなしでインストールされることを確認します。
これらのチェック後も問題が発生し続ける場合は、複数のブラウザーでアップロードが失敗し、すべてのユーザーがPackage Managerにアクセスできない場合は、Adobe サポート にチケットを送信します。影響を受けるユーザーがアクセスできない間、同じアクセス権を持つ別のユーザーがアクションを完了する可能性があります。または、テストでリクエストがAEMに届かないことが示されます。 スクリーンショット、HAR ファイル、ブラウザーコンソールのログ、パッケージ名、トラブルシューティング結果の概要を含めます。
関連トピックス
- パッケージマネージャー
- AEM as a Cloud Serviceへのデプロイ
- AEMaaCSでのパッケージのインストールに関する問題
- AEM プロジェクト構造