Assets のオフロードのベストプラクティス

Adobe Experience Manager（AEM）Assets で大きなファイルを扱ったり、ワークフローを実行したりすると、CPU、メモリ、I/O リソースを大量に消費する場合があります。特に、アセットのサイズ、ワークフロー、ユーザー数、アセットの取り込み頻度が、システム全体のパフォーマンスに影響を与える可能性があります。最もリソースを消費する操作には、AEM アセットの取り込みやレプリケーションのワークフローがあります。単一の AEM オーサリングインスタンスでこれらのワークフローを頻繁に使用すると、オーサリングの効率に悪影響を与える可能性があります。

これらのタスクを専用のワーカーインスタンスにオフロードすると、CPU、メモリおよび IO のオーバーヘッドを低減できます。一般的に、オフロードは、大量に CPU／メモリ／IO リソースを消費するタスクを専用のワーカーインスタンスに分配するというアイデアが基礎になっています。以降の節では、Assets のオフロードの推奨される使用例について説明します。

AEM Assets のオフロード

AEM Assets は、オフロードのためのネイティブなアセット固有のワークフロー拡張を実装しています。オフロードフレームワークが備える汎用的なワークフロー拡張を基礎とし、アセット固有の機能を追加で実装しています。Assets のオフロードの目標は、アップロードされたアセットに対する DAM アセットの更新ワークフローを効率的に実行することです。Assets のオフロードにより、取り込みワークフローをより詳細に制御できるようになります。

AEM Assets のオフロードのコンポーネント

以下の図は、Assets のオフロードプロセスにおける主なコンポーネントを示しています。

DAM アセットの更新のオフロードワークフロー

DAMアセットの更新のオフロードワークフローは、ユーザーがアセットをアップロードするプライマリ（オーサー）サーバーで実行されます。 このワークフローは、通常のワークフローランチャーによって実行されます。このオフロードワークフローは、アップロードされたアセットを処理する代わりに、トピック com/adobe/granite/workflow/offloading を使用して新しいジョブを作成します。オフロードワークフローは、ジョブのペイロードに、ターゲットワークフローの名前（この場合は DAM アセットの更新ワークフロー）およびアセットのパスを追加します。オフロードジョブを作成した後、プライマリインスタンスのオフロードワークフローは、オフロードジョブの実行が完了するまで待機します。

ジョブマネージャー

ジョブマネージャーは、新しいジョブをワーカーインスタンスに分配します。分配のメカニズムを設計する場合、トピックのイネーブルメントについて考慮することが重要です。ジョブは、ジョブのトピックが有効になっているインスタンスにのみ割り当てることができます。プライマリでトピック com/adobe/granite/workflow/offloading を無効にし、ワーカーでこのトピックを有効にして、ジョブがワーカーに割り当てられるようにします。

AEM のオフロード

オフロードフレームワークは、ワーカーインスタンスに割り当てられたワークフローオフロードジョブを特定し、レプリケーションを使用して、それらを物理的にワーカーにトランスポートします（取り込む画像などのペイロードを含む）。

ワークフローオフロードジョブコンシューマー

ジョブがワーカーに書き込まれると、ジョブマネージャーは​com/adobe/granite/workflow/offloading​トピックを担当するジョブコンシューマーを呼び出します。 その後、ジョブコンシューマーはアセットで DAM アセットの更新ワークフローを実行します。

Sling トポロジ

Sling トポロジは、AEM インスタンスをグループ化し、基礎となる持続性とは独立して相互に認識できるようにします。Sling トポロジのこの特性により、非クラスター、クラスターおよび混合シナリオのトポロジを作成できます。インスタンスは、トポロジ全体にプロパティを公開できます。フレームワークは、トポロジの変更（インスタンスおよびプロパティ）をリスンするコールバックを提供します。Sling トポロジは、Sling 分配ジョブの基礎となります。

Sling 分配ジョブ

Sling 分配ジョブにより、トポロジのメンバーである一連のインスタンス間でのジョブの分配が容易になります。Sling ジョブは、機能のアイデアに基づいています。ジョブは、ジョブトピックにより定義されます。ジョブを実行するには、インスタンスが特定のジョブトピックのジョブコンシューマーを提供している必要があります。ジョブトピックは、分配メカニズムの主な推進要素です。

ジョブは、トピックのジョブコンシューマーを提供しているインスタンスにのみ分配されます。インスタンスのジョブコンシューマーを有効／無効にすることで、インスタンスの機能を定義し、分配メカニズムを制御できます。インスタンスの利用可能なジョブコンシューマーは、トポロジ全体にブロードキャストされます。

この文脈での分配という用語は、ジョブコンシューマーを提供する特定のインスタンスへのジョブの割り当てを意味しています。インスタンスへの割り当ては、リポジトリに保管されます。つまり、Sling 分配ジョブは、デフォルトで、トポロジ内の任意のインスタンスに割り当てることができます。ただし、他のジョブは、同じリポジトリを共有するインスタンスによってのみ実行できます。これは、これらのジョブは、同じクラスターの一部であるインスタンスによってのみ実行できることを意味しています。異なるクラスターのインスタンスに割り当てられたジョブは実行されません。

Granite オフロードフレームワーク

Granite オフロードフレームワークは、Sling ジョブ分配を補完するもので、非クラスターインスタンスに割り当てられたジョブを実行します。分配（インスタンスの割り当て）はおこないません。ただし、非クラスターインスタンスに分配された Sling ジョブを特定し、それらを実行のためのターゲットインスタンスにトランスポートします。現在、オフロードでは、レプリケーションを使用してこのジョブのトランスポートを実行します。ジョブを実行するために、オフロードでは入力と出力が定義され、それらがジョブと組み合わされて、ジョブのペイロードが構築されます。

Sling 分配ジョブは、ジョブおよび分配のフレームワークを提供します。Granite オフロードは、ジョブが非クラスターインスタンスに分配される特別なケースのトランスポートのみをおこないます。

トランスポートに加えて、オフロードフレームワークは、ワークフローエンジンの拡張も提供します。これにより、フレームワークで、ワークフローの一環として分配ジョブを作成し、それらの完了を待機してから、ワークフローを先に進めることができます。これは、ワークフローエンジンのワークフロー外部ステップ API を使用して実装されています。拡張には、ワークフローの全体的な分配を支援するものもあります。単一ワークフローステップの分配はサポートされていません。

オフロードフレームワークには、トポロジ全体でのジョブトピックのイネーブルメントを可視化し、制御できるユーザーインターフェイス（UI）も備えられています。UI により、Sling 分配ジョブのトピックのイネーブルメントを効率的に設定できます。UI を使用せずにオフロードを設定することもできます。

アセットのオフロードの一般的なガイダンスとベストプラクティス

実装はそれぞれ異なるので、あらゆる場合に使用できるオフロード設定はありません。以降の項では、アセット取り込みのオフロードについてのガイダンスとベストプラクティスを示します。

アセットのオフロードは、操作のオーバーヘッドを含め、システムへのオーバーヘッドを発生させます。アセット取り込みの負荷で問題が発生した場合、まずは、オフロードなしで設定を見直すことをお勧めします。アセットのオフロードに進む前に、以下のオプションを検討してください。

• ハードウェアの拡張
• ワークフローの最適化
• 一時的なワークフローの使用
• ワークフローに使用するコア数の制限

Assets のオフロードが適切だと判断した場合は、以下のガイダンスに従います。

• TarMK ベースの導入を推奨します。
• TarMK ベースの Assets のオフロードは、広範な水平スケーリングには適していません。
• オーサーとワーカーとの間のネットワークのパフォーマンスが十分であることを確認します。

推奨される Assets のオフロードの導入

AEM および Oak を使用する場合、複数の導入シナリオが考えられます。Assets のオフロードでは、共有データストアを使用した TarMK ベースの導入を推奨します。以下の図は、推奨される導入の概要を示しています。

データストアの設定について詳しくは、AEM でのノードストアとデータストアの設定を参照してください。

自動エージェント管理の無効化

自動エージェント管理はバイナリレスレプリケーションをサポートしておらず、新しいオフロードテクノロジを設定するときに混乱を生じさせる可能性があるので、無効にすることをお勧めします。また、バイナリレスレプリケーションで必要なフォワードレプリケーションフローも自動的にはサポートされません。

1. URL http://localhost:4502/system/console/configMgrからConfiguration Managerを開きます。
2. OffloadingAgentManager (http://localhost:4502/system/console/configMgr/com.adobe.granite.offloading.impl.transporter.OffloadingAgentManager)の設定を開きます。
3. 自動エージェント管理を無効にします。

フォワードレプリケーションの使用

オフロードトランスポートでは、デフォルトで、リバースレプリケーションを使用して、オフロードされたアセットをワーカーからプライマリにプルします。リバースレプリケーションエージェントでは、バイナリレスレプリケーションをサポートしていません。オフロードされたアセットをフォワードレプリケーションを使用してワーカーからプライマリにプッシュするようにオフロードを設定する必要があります。

1. リバースレプリケーションを使用してデフォルト設定から移行する場合は、&ast；のプライマリおよびワーカーで、「 offloading_outbox 」および「 offloading_reverse_* 」という名前のすべてのエージェントを無効または削除します。は、ターゲットインスタンスのSling idを表します。
2. 各ワーカーで、プライマリを指す新しいフォワードレプリケーションエージェントを作成します。手順は、プライマリからワーカーへの転送エージェントの作成と同じです。 オフロードレプリケーションエージェントの設定手順については、オフロード用のレプリケーションエージェントの作成を参照してください。
3. OffloadingDefaultTransporter (http://localhost:4502/system/console/configMgr/com.adobe.granite.offloading.impl.transporter.OffloadingDefaultTransporter)の設定を開きます。
4. プロパティdefault.transport.agent-to-master.prefixの値をoffloading_reverseからoffloadingに変更します。

オーサーとワーカーの間での共有データストアおよびバイナリレスレプリケーションの使用

アセットのオフロードのトランスポートオーバーヘッドを削減するには、バイナリレスレプリケーションの使用をお勧めします。 共有データストアでバイナリレスレプリケーションを設定する方法については、AEM でのノードストアとデータストアの設定を参照してください。アセットのオフロードでは、他のレプリケーションエージェントが関係するという点を除いて手順は同じです。バイナリレスレプリケーションはフォワードレプリケーションエージェントでのみ機能するので、すべてのオフロードエージェントでフォワードレプリケーションも使用する必要があります。

トランスポートパッケージの無効化

デフォルトで、オフロードにより、オフロードジョブおよびジョブのペイロード（元のアセット）を含むコンテンツパッケージが作成され、この単一のオフロードパッケージが単一のレプリケーションリクエストを使用してトランスポートされます。バイナリレスレプリケーションを使用する場合、パッケージを作成するときにバイナリが再度パッケージにシリアル化されるので、これらのオフロードパッケージを作成すると効率性が低下します。これらのトランスポートパッケージの使用をオフにできるので、オフロードジョブとペイロードは、ペイロードエントリごとに1つずつ、複数のレプリケーションリクエストでトランスポートされます。 これにより、バイナリレスレプリケーションのメリットを活かすことができます。

1. http://localhost:4502/system/console/configMgr/com.adobe.granite.offloading.impl.transporter.OffloadingDefaultTransporterにある​OffloadingDefaultTransporter​コンポーネントのコンポーネント設定を開きます。
2. プロパティ​レプリケーションパッケージ(default.transport.contentpackage)​を無効にします。

ワークフローモデルのトランスポートの無効化

デフォルトでは、DAMアセットの更新のオフロード​オフロードワークフローは、ワーカーに対して呼び出すワークフローモデルをジョブのペイロードに追加します。 このワークフローは、デフォルトで標準の​DAMアセットの更新​モデルに従うので、この追加のペイロードを削除できます。

ジョブのペイロードでワークフローモデルを無効にした場合は、パッケージマネージャーなどの他のツールを使用して、参照されているワークフローモデルにも変更を反映する必要があります。

ワークフローモデルのトランスポートを無効にするには、DAM アセットの更新のオフロードワークフローを変更します。

1. http://localhost:4502/libs/cq/workflow/content/console.htmlからワークフローコンソールを開きます。
2. 「モデル」タブを開きます。
3. 「 DAMアセットの更新のオフロード」ワークフローモデルを開きます。
4. DAMワークフローのオフロードステップのステップのプロパティを開きます。
5. 「引数」タブを開き、「入力にモデルを追加」および「出力にモデルを追加」オプションの選択を解除します。
6. 変更内容をモデルに保存します。

ポーリング間隔の最適化

ワークフローのオフロードは、プライマリ上の外部ワークフローを使用して実装され、ワーカー上のオフロードされたワークフローの完了をポーリングします。 外部ワークフロープロセスのデフォルトのポーリング間隔は 5 秒です。プライマリでのオフロードのオーバーヘッドを軽減するために、Assets のオフロードステップのポーリング間隔は 15 秒以上に設定することをお勧めします。

1. http://localhost:4502/libs/cq/workflow/content/console.htmlからワークフローコンソールを開きます。

2. 「モデル」タブを開きます。

3. 「 DAMアセットの更新のオフロード」ワークフローモデルを開きます。

4. 「 DAMワークフローのオフロード」ステップのステップのプロパティを開きます。

5. 「コモン」タブを開き、「期間」プロパティの値を調整します。

6. 変更内容をモデルに保存します。

追加のリソース

このドキュメントは、Assets のオフロードに重点を置いて説明しています。以下に、オフロードについての追加ドキュメントを示します。

• ジョブのオフロード
• アセットのワークフローオフローダー