レプリケーション

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

コンテンツの公開方法

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

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

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

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

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

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

公開を管理

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

   

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

   enableVersion=true,agentId=publish,includeChildren=true

   メモ

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

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

パラメーター

• includeChildren（ブール値、デフォルト：false）。false の場合、パスのみが公開されます。 true の場合、子も公開されます。
• 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 以外の値を返します。

コンテンツの無効化方法

コンテンツを直接無効にするには、オーサーから Sling コンテンツ無効化 (SCD) を使用するか（推奨される方法）、レプリケーション API を使用してパブリッシュ Dispatcher フラッシュレプリケーションエージェントを呼び出します。 詳しくは、 キャッシュ ページを参照してください。

レプリケーション API の容量の制限

1 度に 100 個未満のパスをレプリケートすることをお勧めします。500 個がハードリミットです。 ハードリミットを超えて、 ReplicationException がスローされます。
アプリケーションロジックがアトミックレプリケーションを必要としない場合、この制限は、 ReplicationOptions.setUseAtomicCalls を false に設定します。この値は任意の数のパスを受け入れますが、内部的にグループを作成して、この制限を下回るようにします。

レプリケーション呼び出しごとに送信されるコンテンツのサイズは、 10 MB. ノードとプロパティが含まれますが、バイナリ（ワークフローパッケージとコンテンツパッケージはバイナリと見なされません）は含まれません。

トラブルシューティング

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

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

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

Business.Adobe.com リソース