コンテンツコピーツール content-copy
コンテンツコピーツールを使用すると、可変コンテンツをオンデマンドで AEM as a Cloud Service の実稼動環境から下位環境にテスト目的でコピーできます。
はじめに introduction
現在の実際のデータは、テスト、検証、ユーザー受け入れの目的で役立ちます。コンテンツコピーツールを使用すると、AEM as a Cloud Service の実稼動環境からステージング環境、開発環境、または迅速な開発環境（RDE）にコンテンツをコピーして、テストを行うことができます。
コピーするコンテンツは、コンテンツセットによって定義されます。コンテンツセットは、同じ Cloud Manager プログラム内のソースオーサーサービス環境からターゲットオーサーサービス環境にコピーされる可変コンテンツを含む、JCR パスのリストで構成されます。コンテンツセットでは、次のパスを使用できます。
/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 NOTE 次の場合、環境を選択できない可能性があります。 - ユーザーに適切な権限がない。
- 環境でパイプラインが実行されているか、コンテンツのコピー操作が処理中。
- 環境が休止状態または起動中です。
-
コンテンツをコピー ダイアログで、コンテンツのコピーアクションのソースと宛先を指定します。
-
コンテンツは、上位の環境から下位の環境にコピーするか、次のような階層を持つ開発／RDE 環境間でのみ（最上位から最下位へ）コピーできます。
- 実稼動
- ステージング
- 開発／RDE
-
-
必要に応じて、コピープロセスに アクセス制御リストを含める ことも選択できます。
-
「コピー」を選択します。
コピープロセスが開始します。コピープロセスのステータスは、選択したコンテンツセットのコンソールに反映されます。
コンテンツのコピーアクティビティ copy-activity
コピープロセスのステータスは、コンテンツをコピーアクティビティ ページで監視できます。
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
-
概要 ページの 環境 画面に移動します。
-
環境 画面から コンテンツをコピーアクティビティ ページに移動します。
コンテンツのコピーステータス statuses
コンテンツのコピーを開始すると、プロセスに次のいずれかのステータスが設定されます。
コピープロセスのキャンセル canceling
コンテンツのコピー操作を開始後に中止する必要がある場合は、オプションでキャンセルできます。
これを行うには、コンテンツのアクティビティをコピー ページで、以前に開始したコピープロセスの省略記号メニューから キャンセル アクションを選択します。
ログへのアクセス accessing-logs
完了したコンテンツコピープロセスについては、ソース環境と宛先環境の両方でログを確認できます。
これを行うには、コンテンツアクティビティをコピー ページで、ログをレビューしたいコピープロセスの省略記号メニューから ログ アクションを選択し、環境を選択します。
ログがローカルマシンにダウンロードされます。ダウンロードが開始されない場合は、ポップアップブロッカーの設定を確認してください。
制限事項 limitations
コンテンツのコピーツールには次の制限があります。
- コンテンツを下位環境から上位環境にコピーすることはできません。
- コンテンツは、オーサーサービスとの間でのみコピーできます。
- プログラム間でのコンテンツのコピーはできません。
- 同じ環境でコンテンツのコピー操作を同時に実行することはできません。
- コンテンツセットごとに最大 50 個のパスを指定できます。除外されるパスに制限はありません。
- コンテンツのコピーツールは、ソース上の移動されたコンテンツや削除されたコンテンツを追跡できないので、クローンまたはミラーリングツールとして使用しないでください。
- コンテンツのコピーツールにはバージョン管理機能がなく、前回のコンテンツのコピー操作以降にコンテンツセット内のソース環境で変更されたコンテンツや作成されたコンテンツを自動的に検出できません。
- 前回のコンテンツのコピー操作以降のコンテンツの変更のみで宛先環境を更新する場合は、コンテンツセットを作成する必要があります。それから、前回のコンテンツコピー操作以降に変更が加えられたソースインスタンス上のパスを指定します。
- バージョン情報は、コンテンツコピーに含まれていません。
既知の問題 known-issues
コンテンツのコピー機能を使用する場合は、次の既知の問題に注意してください。
- ソース環境のリソースの名前を変更すると、ターゲット環境の UUID が競合するので、コンテンツのコピー操作が失敗する可能性があります。
- このエラーを回避するには、リソースの名前を変更する代わりに、まずリソースを削除してから、目的の新しいリソース名で再作成します。