コンテンツコピーツール 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 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 を再計算します。