Show Menu
トピック×

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

この機能はAEM 6.4以降では非推奨となり、AEM 6.5では削除されます。それに応じて計画を立ててください。
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 アセットの更新ワークフロー)およびアセットのパスを追加します。オフロードジョブを作成した後、プライマリインスタンスのオフロードワークフローは、オフロードジョブが実行されるまで待機します。

ジョブマネージャー

ジョブマネージャーは、新しいジョブをワーカーインスタンスに分配します。分配のメカニズムを設計する場合、トピックのイネーブルメントについて考慮することが重要です。ジョブは、ジョブのトピックが有効になっているインスタンスにのみ割り当てることができます。Disable the topic com/adobe/granite/workflow/offloading on the primary, and enable it on the worker to ensure that the job is assigned to the worker.

AEM のオフロード

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

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

Once a job is written on the worker, the job manager calls the job consumer responsible for the com/adobe/granite/workflow/offloading topic. その後、ジョブコンシューマーはアセットで 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 のオフロードは、広範な水平スケーリングには適していません。
  • オーサーとワーカーとの間のネットワークのパフォーマンスが十分であることを確認します。

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

自動エージェント管理はバイナリレスレプリケーションをサポートしておらず、新しいオフロードテクノロジを設定するときに混乱を生じさせる可能性があるので、無効にすることをお勧めします。さらに、バイナリレス・レプリケーションで必要とされる転送レプリケーション・フローも自動的にはサポートされません。
  1. Open Configuration Manager from the URL http://localhost:4502/system/console/configMgr .
  2. ( OffloadingAgentManager``http://localhost:4502/system/console/configMgr/com.adobe.granite.offloading.impl.transporter.OffloadingAgentManager )の設定を開きます。
  3. 自動エージェント管理を無効にします。

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

デフォルトでは、オフロードトランスポートは逆複製を使用して、オフロードされたアセットをワーカーからプライマリに取り戻します。 リバースレプリケーションエージェントでは、バイナリレスレプリケーションをサポートしていません。オフロードを設定して、オフロードされたアセットをワーカーからプライマリにプッシュバックするには、転送レプリケーションを使用する必要があります。
  1. If you are migrating from the default configuration using reverse replication, disable or delete all agents named " offloading_outbox " and " offloading_reverse_* " on primary and worker, where * represents the Sling id of the target instance.
  2. 各ワーカーで、プライマリを指す新しい転送レプリケーションエージェントを作成します。 この手順は、プライマリからワーカーへの転送エージェントを作成するのと同じです。 See Creating Replication Agents For Offloading for instructions around setting up offloading replication agents.
  3. ( OffloadingDefaultTransporter )の設定を開き http://localhost:4502/system/console/configMgr/com.adobe.granite.offloading.impl.transporter.OffloadingDefaultTransporter ます。
  4. Change value of the property default.transport.agent-to-master.prefix from offloading_reverse to offloading .

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

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

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

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

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

By default, the DAM Update Asset Offloading offloading workflow adds the workflow model to call on the worker to the job payload. Because this workflow follows the out-of-the-box DAM Update Asset model by default, this additional payload can be removed.
ジョブのペイロードでワークフローモデルを無効にした場合は、パッケージマネージャーなどの他のツールを使用して、参照されているワークフローモデルにも変更を反映する必要があります。
ワークフローモデルのトランスポートを無効にするには、DAM アセットの更新のオフロードワークフローを変更します。
  1. 「モデル」タブを開きます。
  2. DAM Update Asset Offloadingワークフローモデルを開きます。
  3. DAMワークフローのオフロード手順の手順のプロパティを開きます。
  4. 「引数」タブを開き、「入力するモデル」追加および「出力するモデル追加」オプションの選択を解除します。
  5. 変更内容をモデルに保存します。

ポーリング間隔の最適化

ワークフローのオフロードは、プライマリの外部ワークフローを使用して実装されます。このワークフローは、ワーカーのオフロードされたワークフローの完了をポーリングします。 外部ワークフロープロセスのデフォルトのポーリング間隔は 5 秒です。アセットのオフロード処理のオーバーヘッドをプライマリのオフロードオーバーヘッドを減らすために、アセットのオフロード処理のポーリング間隔を少なくとも15秒に増やすことをお勧めします。
  1. 「モデル」タブを開きます。
  2. DAM Update Asset Offloadingワークフローモデルを開きます。
  3. DAMワークフローのオフロード手順の手順のプロパティを開きます。
  4. 「コモンズ」タブを開き、期間プロパティの値を調整します。
  5. 変更内容をモデルに保存します。

追加のリソース

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