AEM Dispatcher に関する主な問題とよくある質問

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Dispatcher

作成対象：

管理者

Dispatcher の設定

概要

Dispatcher とは？

Dispatcher は、Adobe Experience Manager のキャッシングツール、またはロードバランシングツール、あるいはその両方で、高速で動的な Web オーサリング環境を実現するのに役立ちます。キャッシュの際、Dispatcher は HTTP サーバー（Apache など）の一部として機能します。これは、静的 web サイトのコンテンツをできるだけ多く保存（または「キャッシュ」）することを目的としています。これにより、web サイトのエンジンのレイアウトへのアクセス頻度をできるだけ少なくします。ロードバランシングの役割では、Dispatcher はさまざまな AEM インスタンス（レンダー）間でユーザーリクエスト（読み込み）を分散します。

キャッシュ時、Dispatcher モジュールでは Web サーバーの静的コンテンツ提供機能を使用します。キャッシュされたドキュメントは、Dispatcher によって web サーバーのドキュメントルートに配置されます。

Dispatcher はどのようにキャッシュを実行しますか。

Dispatcherは、Webサーバーの静的コンテンツを提供する機能を使用します。キャッシュされたドキュメントは、Dispatcher によって web サーバーのドキュメントルートに格納されます。Web サイトに変更があったとき、Dispatcher では主に 2 つの方法でキャッシュコンテンツを更新します。

コンテンツの更新 によって、変更されたページや、そのページに直接関連付けられたファイルを削除します。
自動無効化 によって、キャッシュで変更があった部分を自動的に無効化し、更新後に期限切れとします。例えば、関連するページに期限切れのフラグを付けるだけで、削除はおこないません。

負荷分散のメリットは何ですか？

ロードバランシングによって、複数のAEMインスタンスにユーザーリクエスト（読み込み）を振り分けます。次のリストでは、ロードバランシングの利点を示します。

処理能力の向上：この方法を実行すると、Dispatcher と AEM の複数のインスタンス間でドキュメント要求が共有されます。各インスタンスで処理するドキュメントの数が少なくなるので、応答時間を短縮できます。Dispatcher はドキュメントカテゴリごとに内部統計を保持するので、負荷を予測してクエリを効率的に分散させることができます。
フェイルセーフカバレッジの向上：インスタンスからの応答が受信されない場合、Dispatcher は自動的に他のいずれかのインスタンスに要求をリレーします。したがって、1 つのインスタンスが無効になった場合の影響は、計算能力の低下と比例してサイトの処理が遅くなることだけです。

NOTE

詳しくは、Dispatcher の概要ページを参照してください。

インストールおよび設定

Dispatcher モジュールはどこからダウンロードできますか？

最新の Dispatcher モジュールは、Dispatcher リリースノートページからダウンローできます。

Dispatcher モジュールのインストール方法を教えてください。

Dispatcher のインストールページを参照してください。

Dispatcher モジュールの設定方法を教えてください。

Dispatcher 設定ページを参照してください。

オーサーインスタンス用に Dispatcher を設定する方法を教えてください。

詳細な手順については、オーサーインスタンスでの Dispatcher の使用を参照してください。

を複数のドメインで Dispatcher 設定する方法を教えてください。

ドメインが次の条件を満たしている場合、複数のドメインで CQ Dispatcher を設定できます。

両方のドメイン用の Web コンテンツが単一の AEM リポジトリに保存されている
Dispatcher キャッシュ内のファイルをドメインごとに個別に無効化できる

詳しくは、複数ドメインでの Dispatcher の使用を参照してください。

ユーザーからのすべての要求が同じパブリッシュインスタンスにルーティングされるように Dispatcher を設定する方法を教えてください。

スティッキー接続機能を使用すると、ユーザーのすべてのドキュメントが AEM の同じインスタンス上で処理されるようになります。この機能は、パーソナライズされたページとセッションデータを使用する場合に重要です。データはインスタンスに保存されます。そのため、以降の同じユーザーからの要求は、同じインスタンスに返す必要があります。

スティッキー接続をおこなうと、Dispatcher で要求を最適化する機能が制限されるので、このアプローチはは必要な場合にのみ使用してください。「スティッキー」ドキュメントを保存するフォルダーは指定できるので、そのフォルダー内のすべてのドキュメントをユーザーごとに同じインスタンスで処理できます。

スティッキー接続とキャッシュを組み合わせることはできますか？

スティッキー接続を使用するほとんどのページでは、キャッシュをオフにする必要があります。そうしないと、セッションコンテンツに関係なく、ページの同じインスタンスがすべてのユーザーに表示されます。

一部のアプリケーションでは、スティッキー接続とキャッシュの両方を使用できます。例えば、データをセッションに書き込むフォームを表示する場合、スティッキー接続とキャッシュを組み合わせて使用できます。

Dispatcher とAEM パブリッシュインスタンスは同じ物理マシンに配置できますか？

マシンの性能が十分でれば可能です。ただし、異なるコンピューター上に Dispatcher と AEM パブリッシュインスタンスを設定することをお勧めします。

通常、パブリッシュインスタンスはファイアウォールの内側に存在し、Dispatcher は DMZ に存在します。同じ物理マシンにパブリッシュインスタンスと Dispatcher の両方を配置する場合は、必ずファイアウォールの設定で外部ネットワークからパブリッシュインスタンスへの直接アクセスを禁止します。

特定の拡張子を持つファイルのみキャッシュできますか？

はい。例えば、GIF ファイルのみをキャッシュする場合は、dispatcher. any 設定ファイルのキャッシュセクションで「*. gif」と指定します。

キャッシュからファイルを削除する方法を教えてください。

HTTP リクエストを使用して、キャッシュからファイルを削除できます。HTTP リクエストを受信すると、Dispatcher はキャッシュからファイルを削除します。Dispatcher は、そのページに対するクライアント要求を受信した場合にのみ、ファイルを再びキャッシュします。このようなやり方でキャッシュファイルを削除する方法は、同じページに対する要求を同時に受信する可能性が低い Web サイトに適しています。

HTTP 要求の構文は以下のとおりです。

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

Dispatcher は、CQ-Handle ヘッダーの値に一致する名前を持つ、キャッシュされたファイルおよびフォルダーを削除します。例えば、/content/geomtrixx-outdoors/en という CQ-Handle は、以下のアイテムに一致します。

geometrixx-outdoors ディレクトリ内の en という名前を持つ（あらゆるファイル拡張子の）すべてのファイル
en ディレクトリ（存在する場合、ページのサブノードのキャッシュされたレンダリングが含まれます）の下にある _jcr_content という名前のすべてのディレクトリ
ディレクトリ en は、CQ-Action が Delete または Deactivate である場合のみ削除されます。

このトピックの詳細については、手動での Dispatcher キャッシュの無効化を参照してください。

権限に影響を受けるキャッシュの実装について教えてください。

セキュリティ保護されたコンテンツのキャッシュページを参照してください。

Dispatcher インスタンスと CQ インスタンス間の通信を保護する方法を教えてください。

Dispatcher セキュリティチェックリストページおよび AEM セキュリティチェックリストページを参照してください。

Dispatcher の問題：`jcr:content` が `jcr%3acontent` に変更される

質問：ビジネスでは最近、Dispatcher レベルで問題に直面しています。CQ リポジトリからデータを取得していた AJAX 呼び出しの 1 つに、jcr:content が含まれていました。これが jcr%3acontent にエンコードされたので、間違った結果セットが発生しました。

回答：ResourceResolver.map() メソッドを使用して、要求を取得するのに使用または発行される「わかりやすい URL」を取得します。このメソッドは、Dispatcher のキャッシュのイシューも解決できます。map() メソッドは : コロンをアンダースコアにエンコードし、resolve() メソッドはそれらを読み取り可能な SLING JCR 形式に戻します。map() メソッドを使用して、Ajax 呼び出しで使用される URL を生成します。

詳しくはこちらをご覧ください。https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html?#namespace-mangling

Dispatcher をフラッシュする

パブリッシュインスタンスで Dispatcher フラッシュエージェントを設定する方法を教えてください。

レプリケーションページを参照してください。

Dispatcher のフラッシュ問題のトラブルシューティング方法を教えてください。

こちらのトラブルシューティング記事を参照してください。

削除操作によって Dispatcher がフラッシュされる場合は、Sensei Martin によるコミュニティブログの投稿に記載された回避策を使用してください。

Dispatcher キャッシュから DAM アセットをフラッシュする方法を教えてください。

「チェーンレプリケーション」機能を使用できます。この機能を有効にすると、オーサーインスタンスから複製を受信したとき、Dispatcher フラッシュエージェントがフラッシュリクエストを送信します。

有効にするには：

この手順に従って、公開時にエージェントをフラッシュします
各エージェントの設定に移動します。
「トリガー」タブで、「受信時」ボックスをオンにします。

その他

Dispatcher はドキュメントが最新かどうかをどう判断しますか？
ドキュメントが最新かどうかを判断するために、Dispatcher は次の操作を実行します。

ドキュメントが自動無効化の対象であるかどうかチェックします。そうでない場合、ドキュメントは最新と見なされます。
ドキュメントが自動無効化の対象として設定されている場合、Dispatcher は最新の変更情報と比べてドキュメントが古いかどうかチェックします。ドキュメントが古い場合、Dispatcher は AEM インスタンスに最新バージョンを要求し、キャッシュ内のバージョンを置き換えます。

Dispatcher はどのようにドキュメントを返しますか？

Dispatcher 設定ファイル dispatcher.any を使用して、Dispatcher がドキュメントをキャッシュするかどうかを定義できます。Dispatcher は、要求とキャッシュ可能なドキュメントのリストを照合します。ドキュメントがこのリストにない場合は、AEM インスタンスにドキュメントを要求します。

/rules プロパティは、ドキュメントパスに応じてキャッシュされるドキュメントを制御します。/rules プロパティにかかわらず、Dispatcher は以下の状況にあるドキュメントをキャッシュしません。

要求 URI に疑問符（(?)）が含まれています。
疑問符は、キャッシュの必要がない、検索結果などの動的ページを指します。
ファイル拡張子が不明の場合。
Web サーバーでドキュメントのタイプ（MIME タイプ）を判別するために、拡張子が必要です。
認証ヘッダーが設定されている（設定可能）場合。
AEM インスタンスが以下のヘッダーで応答する場合。
- no-cache
- no-store
- must-revalidate

Dispatcher はキャッシュされたファイルを、静的 Web サイトに含まれる場合と同様に、Web サーバー上に格納しています。ユーザーがキャッシュ可能なドキュメントを要求すると、Dispatcher はそのドキュメントが Web サーバーのファイルシステムに存在するかどうかをチェックします。ファイルシステムに存在する場合、Dispatcher はそのドキュメントを返します。ドキュメントがキャッシュされていない場合、Dispatcher は AEM インスタンスにドキュメントを要求します。