レプリケーション

Adobe Experience Manager as a Cloud Service では、Sling コンテンツ配布機能を使用して、AEM ランタイムの外部にある Adobe I/O 上で動作するパイプラインサービスに複製するコンテンツを移動します。

メモ

詳しくは、コンテンツ配布を参照してください。

コンテンツの公開方法

クイック公開／非公開 - 計画的公開／非公開

これにより、「公開を管理」のアプローチで可能な追加オプションを使用することなく、選択したページを直ちに公開できます。

詳しくは、「公開を管理」を参照してください。

オンタイムとオフタイム - トリガー設定

オンタイム​と​オフタイム​の追加設定をページのプロパティの「基本」タブで行えます。

これの自動レプリケーションを実現するには、OSGi 設定の「On Off Trigger Configuration」で「Auto Replicate」を有効にする必要があります。

OSGi の On Off Trigger Configuration ダイアログ

公開を管理

公開を管理には、クイック公開よりも多くのオプションがあります。子ページを含めたり、参照をカスタマイズしたり、使用可能なワークフローを開始したり、後日公開するためのオプションを提供したりします。

「後で公開する」オプションの対象にフォルダーの子を含めると、「コンテンツツリーを公開」ワークフローが呼び出されます（この記事で説明）。

「公開を管理」について詳しくは、公開の基本に関するドキュメントを参照してください。

ツリーのアクティベーション

メモ

このアプローチは非推奨（廃止予定）と見なされ、2021 年 9 月 30 日以降に削除される予定です。このアプローチはステータスを保持せず、他のアプローチに比べて拡張性が低いからです。アドビでは、「公開を管理」またはワークフロー手法を代わりに使用することをお勧めします。

ツリーのアクティベーションを実行するには：

  1. AEM 開始メニューで​ツール／デプロイメント／配布​に移動します。

  2. 公開​カードを選択します。

  3. 公開 Web コンソール UI で「配布」を選択します。

    配布

  4. パスブラウザーでパスを選択し、必要に応じてノードやツリーの追加または削除を選択し、「送信」をクリックします。

最高のパフォーマンスを得るには、この機能を使用する際に次のガイドラインに従ってください。

  • 一度にレプリケートするパスは 100 個未満にし、パスのハードリミットを 500 個にすることをお勧めします。
  • レプリケートされたコンテンツの合計サイズは 5 MB 未満にする必要があります。これには、ノードとプロパティのみが含まれ、バイナリ（ワークフローパッケージやコンテンツパッケージなど）は含まれません。

コンテンツツリーの公開ワークフロー

次に示すように、 ツール／ワークフロー／モデル​を選択し、「コンテンツツリーを公開」という標準のワークフローモデルをコピーして、ツリーレプリケーションをトリガーできます。

元のモデルを修正したり呼び出さないでください。必ずモデルをコピーして、そのコピーを修正または呼び出してください。

すべてのワークフローと同様に、API を使用して呼び出すこともできます。詳しくは、「プログラムによるワークフローの操作」を参照してください。

あるいは、Publish Content Tree プロセスステップを使用するワークフローモデルを作成して、これを行うこともできます。

  1. AEM as a Cloud Service のホームページから、ツール／ワークフロー／モデル​に移動します。

  2. ワークフローモデルページで、画面の右上隅にある「作成」を押します。

  3. モデルにタイトルと名前を追加します。詳しくは、「ワークフローモデルの作成」を参照してください。

  4. 新しく作成したモデルをリストから選択し、「編集」を押します。

  5. 次のウィンドウで、「プロセスステップ」を現在のモデルフローにドラッグ＆ドロップします。

    プロセスステップ

  6. フローのプロセスステップをクリックし、レンチアイコンを押して「設定」を選択します。

  7. 「プロセス」タブをクリックし、ドロップダウンリストから「Publish Content Tree」を選択します。

    Treeactivation

  8. 「引数」フィールドに追加のパラメーターを設定します。複数の引数はコンマでつなぐことができます。次に例を示します。

    enableVersion=true,agentId=publish

    メモ

    パラメーターのリストについては、以下の「パラメーター」の節を参照してください。

  9. 「完了」を押して、ワークフローモデルを保存します。

パラメーター

  • replicateAsParticipant（ブール値、デフォルト：false）。true に設定した場合、レプリケーションは、参加者ステップを実行したプリンシパルの userid を使用します。
  • enableVersion（ブール値、デフォルト：true）。このパラメーターは、レプリケーション時に新しいバージョンが作成されるかどうかを指定します。
  • agentId（文字列値。デフォルトは、パブリッシュのエージェントのみが使用されることを意味します）。agentId を明確にすることをお勧めします。例えば、値「publish」を設定します。エージェントを preview に設定すると、プレビューサービスに公開されます。
  • filters（文字列値。デフォルトは、すべてのパスがアクティブ化されることを意味します）。使用できる値は次のとおりです。
    • onlyActivated - アクティブ化されていないパスのみがアクティブ化されます。
    • onlyModified - 既にアクティブ化されており、変更日がアクティブ化の日付よりも後のパスのみをアクティブ化します。
    • 上記は、パイプ（|）で OR 結合できます。（例：onlyActivated|onlyModified）。

ログ

ツリーのアクティベーションワークフローステップが開始すると、その設定パラメーターが INFO ログレベルで記録されます。パスがアクティブ化されると、INFO 文も記録されます。

最後の INFO 文は、すべてのパスがワークフローステップでレプリケートされた後に記録されます。

さらに、com.day.cq.wcm.workflow.process.impl の下のロガーのログレベルを DEBUG/TRACE に上げると、さらに多くのログ情報を取得できます。

エラーが発生した場合、ワークフローステップは WorkflowException で終了し、基になる例外をラップします。

サンプルのパブリッシュコンテンツツリーワークフローで生成されるログの例を以下に示します。

21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false

21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms

サポートの再開

ワークフローは、コンテンツをチャンク単位で処理し、チャンクは公開されるコンテンツ全体のサブセットを表します。何らかの理由で、ワークフローがシステムによって停止された場合、ワークフローは再起動し、まだ処理されていないチャンクが処理されます。コンテンツが特定のパスから再開されたことを示すログステートメントが表示されます。

レプリケーション API

AEM as a Cloud Service の特長となっているレプリケーション API を使用して、コンテンツを公開できます。

詳しくは、API のドキュメントを参照してください。

API の基本的な使用法

@Reference
Replicator replicator;
@Reference
ReplicationStatusProvider replicationStatusProvider;

....
Session session = ...
// Activate a single page to all agents, which are active by default
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en");
// Activate multiple pages (but try to limit it to approx 100 at max)
replicator.replicate(session,ReplicationActionType.ACTIVATE, new String[]{"/content/we-retail/en","/content/we-retail/de"});

// ways to get the replication status
Resource enResource = resourceResolver.getResource("/content/we-retail/en");
Resource deResource = resourceResolver.getResource("/content/we-retail/de");
ReplicationStatus enStatus = enResource.adaptTo(ReplicationStatus.class);
// if you need to get the status for more more than 1 resource at once, this approach is more performant
Map<String,ReplicationStatus> allStatus = replicationStatusProvider.getBatchReplicationStatus(enResource,deResource);

特定のエージェントを使用したレプリケーション

上記の例のようにリソースをレプリケートする場合は、デフォルトでアクティブになっているエージェントのみが使用されます。AEM as a Cloud Service では、これは、オーサーをパブリッシュ層に接続する「パブリッシュ」と呼ばれるエージェントのみです。

プレビュー機能をサポートするために、「プレビュー」と呼ばれる新しいエージェントが追加されました。このエージェントは、デフォルトではアクティブになっていません。このエージェントは、オーサーをプレビュー層に接続するために使用されます。プレビューエージェント経由でのみレプリケートする場合は、AgentFilter を使用して、このプレビューエージェントを明示的に選択する必要があります。

その方法については、以下の例を参照してください。

private static final String PREVIEW_AGENT = "preview";

ReplicationStatus beforeStatus = enResource.adaptTo(ReplicationStatus.class); // beforeStatus.isActivated == false

ReplicationOptions options = new ReplicationOptions();
options.setFilter(new AgentFilter() {
  @Override
  public boolean isIncluded (Agent agent) {
    return agent.getId().equals(PREVIEW_AGENT);
  }
});
// will replicate only to preview
replicator.replicate(session,ReplicationActionType.ACTIVATE,"/content/we-retail/en", options);

ReplicationStatus afterStatus = enResource.adaptTo(ReplicationStatus.class); // afterStatus.isActivated == false
ReplicationStatus previewStatus = afterStatus.getStatusForAgent(PREVIEW_AGENT); // previewStatus.isActivated == true

このようなフィルターを指定せず、「パブリッシュ」エージェントのみを使用する場合、「プレビュー」エージェントは使用されず、レプリケーションアクションはプレビュー層には影響しません。

リソースの ReplicationStatus 全体が変更されるのは、デフォルトでアクティブになっているエージェントがレプリケーションアクションに少なくとも 1 つ含まれている場合のみです。上記の例では、レプリケーションは「プレビュー」エージェントを使用するだけなので、このケースには該当しません。したがって、新しい getStatusForAgent() メソッドを使用する必要があります。これにより、特定のエージェントのステータスを問い合わせることができます。このメソッドは、「パブリッシュ」エージェントに対しても機能します。指定されたエージェントを使用して実行されたレプリケーションアクションがある場合、このメソッドは null 以外の値を返します。

レプリケーション API のパスとサイズの制限

レプリケートするパスは 100 個未満にし、ハードリミットを 500 個にすることをお勧めします。ハードリミットを超えると、ReplicationException がスローされます。アプリケーションロジックにアトミックレプリケーションが必要ない場合は、ReplicationOptions.setUseAtomicCalls を false に設定することで、この制限を解除できます。この設定の場合は、任意の数のパスを扱えますが、内部的には、この制限内に収まるようにバケットが作成されます。レプリケーション呼び出しごとに送信されるコンテンツの量は、5 MB 以下にする必要があります。この中には、ノードとプロパティは含まれますが、バイナリは含まれません（ワークフローパッケージやコンテンツパッケージはバイナリと見なされます）。

トラブルシューティング

レプリケーションのトラブルシューティングを行うには、AEM オーサーサービス Web UI のレプリケーションキューに移動します。

  1. AEM 開始メニューで​ツール／デプロイメント／配布​に移動します。
  2. 公開カードを選択します。
    ステータス
  3. キューのステータスが緑色かどうかを確認します。
  4. レプリケーションサービスへの接続をテストできます。
  5. 「ログ」タブを選択すると、コンテンツパブリケーションの履歴が表示されます。

ログ

コンテンツを公開できなかった場合は、パブリケーション全体が AEM パブリッシュサービスから戻されます。
その場合は、メインの編集可能なキューのステータスが赤く表示され、パブリケーションのキャンセル原因となった項目を特定するために、そのキューを確認する必要があります。そのキューをクリックすると、保留中の項目が表示されるので、その中から 1 つの項目またはすべての項目を必要に応じてクリアできます。

このページ