コンテンツコピーツール 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
コンテンツのコピーツールには次の制限があります。
-
コンテンツのコピーツールでは、次の 2 つのフローモードをサポートしています。
- トップダウンフロー – コンテンツを上位の環境から下位の環境（実稼働→ステージング、ステージ→開発/RDE など）にコピーできます。
- フォワードフロー（新機能） – コンテンツを下位非実稼動環境から上位非実稼動環境（開発→ードステージ、RDE→ステージなど）にコピーすることもできます。 この機能は明示的なリクエストがあった場合にのみ使用でき、明示的に無効にするようリクエストされるまで有効のままです。 実稼動環境は、フォワードフローに対して有効な宛先ではありません。
-
コンテンツは、オーサーサービスとの間でのみコピーできます。
-
同じ環境でコンテンツのコピー操作を同時に実行することはできません。
-
コンテンツセットごとに最大 50 個のパスを指定できます。除外されるパスに制限はありません。
-
コンテンツのコピーツールは、ソース上の移動されたコンテンツや削除されたコンテンツを追跡できないので、クローンまたはミラーリングツールとして使用しないでください。
-
コンテンツのコピーツールにはバージョン管理機能がなく、前回のコンテンツのコピー操作以降にコンテンツセット内のソース環境で変更されたコンテンツや作成されたコンテンツを自動的に検出できません。
- 前回のコンテンツのコピー操作以降のコンテンツの変更のみで宛先環境を更新する場合は、コンテンツセットを作成する必要があります。それから、前回のコンテンツコピー操作以降に変更が加えられたソースインスタンス上のパスを指定します。
-
バージョン情報は、コンテンツコピーに含まれていません。
-
コンテンツフラグメントモデルでは、汎用一意識別子（UUID）に基づいて参照フィールドを指定できます。このような UUID はリポジトリに固有なので、コンテンツフラグメントをコピーする際、コンテンツのコピーツールは、ターゲット環境でこれらの UUID を再計算します。