コンテンツコピーツール content-copy
コンテンツコピーツールを使用すると、テスト目的で、可変コンテンツをオンデマンドでAEM as a Cloud Serviceの本番環境から下位環境にコピーできます。
はじめに introduction
現在の実際のデータは、テスト、検証、ユーザー受け入れの目的で役立ちます。 コンテンツコピーツールを使用すると、AEM as a Cloud Service の実稼動環境からステージング環境、開発環境、または高速開発環境（RDE）にコンテンツをコピーして、テストを行うことができます。
コンテンツセットは、コピーするコンテンツを定義します。 コンテンツセットは、JCR パスのリストで構成されます。 これらのパスには、ソースオーサリングサービス環境からターゲットオーサリングサービス環境に、同じCloud Manager プログラム内でコピーされる可変コンテンツが含まれます。 コンテンツセットでは、次のパスを使用できます。
/content
/conf/**/settings/wcm
/conf/**/settings/dam/cfm/models
/conf/**/settings/graphql/persistentQueries
/etc/clientlibs/fd/themes
コンテンツをコピーする場合、ソース環境がプライマリデータソースになります。
- ソースと宛先のパスが一致する場合、ソースのコンテンツは、宛先環境で変更されたコンテンツを上書きします。
- パスが異なる場合、ソースのコンテンツは宛先のコンテンツと結合されます。
権限 permissions
コンテンツのコピーツールを使用するには、ソース環境とターゲット環境の両方で特定の権限が必要です。
権限と設定方法について詳しくは、AEMas a Cloud Service のチームおよび製品プロファイルを参照してください。
コンテンツセットの作成 create-content-set
コンテンツをコピーする前に、コンテンツセットを定義する必要があります。 定義すると、コンテンツセットを再使用してコンテンツをコピーできます。 コンテンツセットを作成するには、次の手順に従います。
-
my.cloudmanager.adobe.comでCloud Managerにログインし、適切な組織とプログラムを選択します。
-
サイドナビゲーションパネルを使用して、概要ページから「コンテンツセット」タブに移動します。
-
画面の右上で、「コンテンツセットを追加」をクリックします。
-
ウィザードの「詳細」タブで、コンテンツセットの名前と説明を入力し、「続行」を選択します。
-
ウィザードの「コンテンツのパス」タブで、コンテンツセットに含める可変コンテンツのパスを指定します。
- パスを「インクルードパスを追加」フィールドに入力します。
- 「パスを追加」をクリックして、コンテンツセットにパスを追加します。
- 必要に応じて、「パスを追加」を再度クリックします。
- 最大 50 個のパスを使用できます。
-
コンテンツセットを調整または制限する必要がある場合、サブパスを除外できます。
-
含まれるパスのリストで、制限するパスの横にある「除外サブパスを追加」オプションをクリックします。
-
選択したパスから除外するサブパスを入力します。
-
「除外パス」を選択します。
-
必要に応じて、「除外サブパスを追加」を選択して、除外するパスを追加します。
- 非管理対象パスは、管理対象パスに対する相対パスである必要があります。
- 非管理対象パスの数に制限はありません。
-
-
必要に応じて、指定したパスを変更できます。
- 除外されたサブパスの横にある「X」をクリックして削除します。
- パスの横にある省略記号ボタンをクリックして、編集および削除 オプションを表示します。
-
コンテンツセットを作成するには、「作成」を選択します。
コンテンツセットを使用して環境間でコンテンツをコピーできるようになりました。
コンテンツセットの編集 edit-content-set
- コンテンツセットを作成する場合と同様の手順に従います。 「コンテンツセットを追加」をクリックする代わりに、コンソールから既存のセットを選択し、省略記号メニューから「編集」を選択します。
- 除外されたサブパスを表示するには、コンテンツセットを編集するときに、設定したパスを展開します。
コンテンツのコピー copy-content
コンテンツセットを作成した後、それを使用してコンテンツをコピーできます。
コンテンツをコピーするには：
-
my.cloudmanager.adobe.comでCloud Managerにログインし、適切な組織とプログラムを選択します。
-
概要 ページで、環境 > コンテンツセットに移動します。
-
コンソールで、コンテンツセットを選択します。
-
省略記号メニューから、コンテンツをコピーをクリックします。
note NOTE 次のいずれかに該当する場合、環境を選択できない可能性があります。 - ユーザーに適切な権限がない。
- 環境でパイプラインが実行されているか、コンテンツのコピー操作が処理中。
- 環境が休止状態または起動中です。
-
「コンテンツをコピー」ダイアログボックスで、コンテンツコピーアクションのソースと宛先を指定します。
-
コンテンツは、より高い環境から低い環境、開発環境とRDE環境の間、または低い非実稼働環境から高い非実稼働環境（フォワードフロー）にコピーできます。 環境階層は、最高から最低まで次のとおりです。
- 実稼動
- ステージング
- 開発／RDE
-
クロスプログラムコンテンツのコピーは、デフォルトで使用できます。 宛先 セクションで、プログラムを選択してから、宛先環境を選択します。
-
-
（オプション）必要に応じて、次の値を設定します。
-
アクセス制御リストを含める - コンテンツのアクセス制御権限をコンテンツと共にコピーするかどうかを選択します。
-
ワイプ – 読み込みを開始する前に、宛先の既存のコンテンツを削除することを選択します。これにより、空の状態から開始し、既存のコンテンツとの競合を回避できます。 ワイプを選択解除したままにすると、Cloud Managerは既存の宛先コンテンツの上に新しいコンテンツを読み込みます。 ワイプを開始する前に確認プロンプトが表示され、Cloud Managerはワイプアクションと読み込みの詳細を記録してトレーサビリティを確保します。
-
読み込み前に宛先をワイプ オプションを選択し、コピーをクリックすると、ポップアップが表示され、次のオプションが表示されます。
- キャンセル （この場合、コンテンツのコピー フローは開始されません）
- 確認 （コンテンツのコピー フローが開始され、宛先のコンテンツが消去されます）
-
読み込み前に宛先を ワイプ を選択しない場合、コンテンツをコピーのフローは以前と同じように機能します。
-
-
パッケージ読み込み失敗ポリシー パッケージの読み込み時に使用するポリシーを選択します。
- 最初のエラーで停止：既定のモード。最初のエラーが発生した後に停止します。
- 残りのパッケージで続行：エラーが発生した後でも、インポートプロセスを続行します。 成功しなかったパッケージ（およびそのコンテンツ）は、インポートログに記録されます
-
-
「コピー」をクリックします。
コピープロセスが開始します。 コピープロセスのステータスは、選択したコンテンツセットのコンソールに反映されます。
コンテンツコピーのアクティビティ copy-activity
コピープロセスのステータスは、コンテンツをコピーアクティビティページで監視できます。
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
-
概要ページの 環境 画面に移動します。
-
環境画面から コンテンツをコピーアクティビティ ページに移動します。
コンテンツコピーのステータス statuses
コンテンツのコピーを開始すると、プロセスに次のいずれかのステータスが設定されます。
コピープロセスのキャンセル canceling
コンテンツのコピー操作を開始後に中止する必要がある場合は、オプションでキャンセルできます。
これを行うには、コンテンツをコピーアクティビティページで、以前に開始したコピープロセスの省略記号メニューから キャンセル アクションを選択します。
アクセスログ accessing-logs
完了したコンテンツコピープロセスについては、ソース環境と宛先環境の両方でログを確認できます。
ログにアクセスするには：
- コンテンツアクティビティをコピー ページで、省略記号メニューから、確認するコピープロセスの ログ をクリックします。 次に、環境を選択します。
ログがローカルマシンにダウンロードされます。
- ダウンロードが開始されない場合は、ポップアップブロッカーの設定を確認してください。
制限事項 limitations
コンテンツのコピーツールには次の制限があります。
-
コンテンツのコピーツールでは、次の 2 つのフローモードをサポートしています。
- トップダウンフロー：コンテンツは、高位環境から下位環境（実稼動→ステージ、ステージング→開発/RDEなど）にコピーできます。
- 転送フロー：コンテンツは、下位の非実稼動環境から上位の非実稼動環境（開発からステージ、RDEからステージなど）にコピーすることもできます。 実稼動環境は転送フローの有効な宛先にはなりません。
-
コンテンツは、オーサーサービスとの間でのみコピーできます。
-
同じ環境でコンテンツのコピー操作を同時に実行することはできません。
-
コンテンツセットごとに最大 50 個のパスを指定できます。 除外されるパスに制限はありません。
-
コンテンツのコピーツールは、ソース上の移動されたコンテンツや削除されたコンテンツを追跡できないので、クローンまたはミラーリングツールとして使用しないでください。
-
コンテンツのコピーツールにはバージョン管理機能がなく、前回のコンテンツのコピー操作以降にコンテンツセット内のソース環境で変更されたコンテンツや作成されたコンテンツを自動的に検出できません。
- 最後のコンテンツコピー操作以降にコンテンツを変更して宛先環境を更新する場合は、既存のコンテンツセットを使用する必要があります。 それから、前回のコンテンツコピー操作以降に変更が加えられたソースインスタンス上のパスを指定します。
-
バージョン情報は、コンテンツコピーに含まれていません。
-
コンテンツフラグメントモデルでは、汎用一意識別子（UUID）に基づいて参照フィールドを指定できます。 このようなUUIDはリポジトリ固有であるため、コンテンツコピーツールは、コンテンツフラグメントをコピーする際に、ターゲット環境でこれらのUUIDを再計算します。