mcpField
A
aem-replication

aem-replication

github.com/adobeクラウド・DevOps316570 回インストール今日更新
リポジトリ

aem-replication について

AEM 6.5 LTS のレプリケーション作業を、設定、コンテンツ公開、API 利用、トラブルシューティングなどの専門スキルへ振り分けるスキルです。環境構築やインシデント対応、性能調整など複数スキルにまたがる作業も調整します。

主な機能

  1. 01ユーザー意図に応じたスキル振り分け
  2. 02レプリケーションエージェントの設定
  3. 03複数の方法によるコンテンツ公開
  4. 04レプリケーション API のプログラム利用
  5. 05キューと接続の問題診断
  6. 06エンドツーエンド作業の調整

活用シーン

  1. 01公開インスタンスの初期設定
  2. 02ページやアセットの公開予約
  3. 03カスタムコードへのレプリケーション統合
  4. 04コンテンツ配信失敗の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/adobe/skills --skill aem-replication

インストール後、Claude Code で/aem-replicationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/replication-foundation/
65-lts-guardrails.md
agent-types.md
api-reference.md
queue-mechanics.md
replicate-content/references/
PACKAGE_REPLICATION.md
REPLICATION_API.md
TREE_ACTIVATION.md

詳細

AEM 6.5 LTS レプリケーション

ユーザーのリクエストの意図に基づいて、適切な専門スキルに振り分けます。

意図ルーター

ユーザーの意図スキルパス
レプリケーションエージェントを設定する（デフォルト、Dispatcher フラッシュ、逆レプリケーション）レプリケーションエージェントの設定configure-replication-agent/SKILL.md
UI またはワークフローを使用してコンテンツを有効化または無効化するコンテンツのレプリケーションreplicate-content/SKILL.md
カスタムコードで Replication API をプログラムから使用するReplication APIreplication-api/SKILL.md
キューの停止、接続の問題、配信の問題を診断するレプリケーションのトラブルシューティングtroubleshoot-replication/SKILL.md
エンドツーエンドのワークフロー：新しい環境のセットアップ、インシデント対応、パフォーマンスの最適化レプリケーションオーケストレーターreplication-orchestrator/SKILL.md

使用方法

  1. 上記の意図ルーターの表で、ユーザーのリクエストに該当する行を選びます。
  2. 該当する専門スキルにリンクされた SKILL.md を読みます。
  3. そのスキルで定義されたワークフローとガイダンスに従います。
  4. 複数のスキルにまたがる複雑なシナリオ（例：エージェントを設定してからトラブルシューティングする）の場合は、主な意図から始め、必要に応じて関連するスキルを参照します。

スキルの概要

レプリケーションエージェントの設定

次のレプリケーションエージェントをセットアップして設定します。

  • デフォルトエージェント：Author から Publish へのコンテンツ配信
  • Dispatcher フラッシュエージェント：キャッシュの無効化
  • 逆レプリケーション：Publish から Author へのユーザー生成コンテンツのフロー
  • 複数の Publish インスタンス：ロードバランシングと高可用性

使用する場面： 初回セットアップ、新しい Publish インスタンスの追加、エージェントの再設定

コンテンツのレプリケーション

次の方法でコンテンツを有効化および無効化します。

  • クイック公開：ワンクリックで簡単に有効化
  • 公開の管理：高度なスケジュール設定と承認ワークフロー
  • ツリーの有効化：階層的な一括公開
  • パッケージマネージャー：特定のコンテンツセットの配信
  • ワークフロー：承認ベースの公開
  • スケジュールされた有効化：時間に基づくコンテンツ公開

使用する場面： ページ、アセット、または DAM コンテンツの公開、コンテンツの非公開

Replication API

AEM 6.5 LTS の公式パブリック API を使用したプログラムによるレプリケーション：

  • Replicator インターフェイス：レプリケーションの基本メソッド
  • ReplicationOptions：同期／非同期、エージェントのフィルタリングを設定
  • ReplicationStatus：レプリケーション状態を照会
  • AgentManager、ReplicationQueue、ReplicationListener：高度なキュー管理と監視

使用する場面： カスタムコードとの統合、一括操作、ワークフローのプロセスステップ、サーブレット

レプリケーションのトラブルシューティング

一般的な問題を診断して解決します。

  • 停止したキュー：FIFO キューの障害
  • 接続エラー：ネットワーク、認証、SSL の問題
  • コンテンツが表示されない：Dispatcher キャッシュ、権限
  • エージェントの設定：URI、認証情報、トリガー
  • イベントキューの問題：停止したレプリケーションジョブ

使用する場面： レプリケーションの失敗、パフォーマンスの問題、コンテンツが配信されない場合

レプリケーションオーケストレーター

複数のサブスキルにまたがるエンドツーエンドのレプリケーションワークフローを調整します。

  • 新しい環境のセットアップ：エージェントを設定 → レプリケーションをテスト → トラブルシューティング
  • 本番インシデント対応：診断 → 修正 → 検証
  • パフォーマンスの最適化：監視 → 調整 → 検証
  • 移行の準備：監査 → 計画 → 実行

使用する場面： 設定、レプリケーション、API、トラブルシューティングの各スキルをまたいで調整が必要な複数ステップのシナリオ

一般的なワークフロー

初回セットアップ
  1. レプリケーションエージェントの設定を使用して、デフォルトエージェントをセットアップします
  2. コンテンツのレプリケーションを使用して、サンプルページでテストします
  3. 問題が発生した場合は、レプリケーションのトラブルシューティングを使用します
本番運用
  1. 日常的な公開には コンテンツのレプリケート を使用します
  2. 自動化／一括操作には レプリケーション API を使用します
  3. 問題が発生した場合は レプリケーションのトラブルシューティング を使用します
高度な統合
  1. 利用可能なメソッドを把握するには レプリケーション API を使用します
  2. エージェントの設定を把握するには レプリケーションエージェントの設定 を使用します
  3. カスタムのレプリケーションコードをデバッグするには レプリケーションのトラブルシューティング を使用します

基礎資料

すべてのレプリケーションスキルで共通して使用する参考資料です。

公式ドキュメント

すべてのスキルは、Adobe AEM 6.5 LTS の公式ドキュメントを参照しています。

関連スキル

  • AEM ワークフロー：承認ワークフローにレプリケーションを統合します
  • Dispatcher：キャッシュを無効化する Dispatcher Flush エージェントを設定します

AEM as a Cloud Service への移行

AEM as a Cloud Service では、レプリケーションエージェントの代わりに Sling Distribution API を使用します。移行を計画している場合：

  • Cloud Service Distribution のドキュメントを確認します
  • コードの移行パターンについては、skills/aem/cloud-service/skills/best-practices/references/replication.mdを参照してください
  • 移行の複雑さを軽減するため、エージェント固有の結合（エージェント ID によるフィルタリング）は避けてください

コメント

Markdown 対応