コンテンツコピーツール content-copy
Cloud Manager のコンテンツコピーツールを使用すると、可変コンテンツをオンデマンドで AMS でホストされている AEM 6.x 実稼動環境から下位の環境にテスト目的でコピーできます。
はじめに introduction
現在の実際のデータは、テスト、検証、ユーザー受け入れの目的で役立ちます。コンテンツコピーツールを使用すると、AMS でホストされている AEM 6.x 実稼動環境からステージング環境または開発環境にコンテンツをコピーできます。このワークフローは、様々なテストシナリオをサポートします。
コンテンツセットは、コピーするコンテンツを定義します。コンテンツセットには、コピーする可変コンテンツを含む JCR パスのリストが含まれます。コンテンツがソース環境からターゲット環境に移動します。すべてが、同じ Cloud Manager プログラム内で行われます。
コンテンツセットでは、次のパスを使用できます。
/content/**
/conf/**
/etc/**
/var/workflow/models/**
/var/commerce/**
コンテンツをコピーする場合、ソース環境が真のソースです。
- 宛先環境でコンテンツを編集する場合、パスが一致すると、ソースのコンテンツによって上書きされます。
- パスが異なる場合、ソースのコンテンツは宛先のコンテンツと結合されます。
権限 permissions
コンテンツコピーツールを使用するには、ソース環境とターゲット環境で、ユーザーを デプロイメントマネージャー の役割に割り当てる必要があります。
コンテンツセットの作成 create-content-set
コンテンツをコピーする前に、コンテンツセットを定義する必要があります。定義すると、コンテンツセットを再使用してコンテンツをコピーできます。コンテンツセットを作成するには、次の手順に従います。
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
-
概要 ページから、環境 画面に移動します。
-
環境 画面から、コンテンツセット ページに移動します。
-
画面の右上付近にある「コンテンツセットを追加」をクリックします。
-
ウィザードの「詳細」タブで、コンテンツセットの名前と説明を入力し、「続行」をクリックします。
-
ウィザードの「コンテンツのパス」タブで、コンテンツセットに含める可変コンテンツのパスを指定します。
- パスを「インクルードパスを追加」フィールドに入力します。
- 「パスを追加」をクリックして、コンテンツセットにパスを追加します。
- 必要に応じて、「パスを追加」を再度クリックします。
-
コンテンツセットを調整または制限する必要がある場合、サブパスを除外できます。
- 含まれるパスのリストで、制限する必要があるパスの横にある「除外サブパスを追加」アイコンをクリックします。
- 選択したパスから除外するサブパスを入力します。
- 「除外パス」をクリックします。
- 必要に応じて、「除外サブパスを追加」をクリックして、除外するパスを追加します。
-
必要に応じて、指定したパスを変更できます。
- 除外されたサブパスの横にある
X
をクリックすると、サブパスを削除できます。 - 「編集」および「削除」オプションを表示するには、パスの横にある省略記号ボタンをクリックします。
- 除外されたサブパスの横にある
-
コンテンツセットを作成するには、「作成」をクリックします。
コンテンツセットを使用して環境間でコンテンツをコピーできるようになりました。
除外されるパスに制限はありません。
コンテンツセットの編集 edit-content-set
コンテンツの手順を作成する場合と同様の手順に従います。「コンテンツセットを追加」をクリックする代わりに、コンソールから既存のセットを選択し、省略記号メニューから「編集」を選択します。
コンテンツセットを編集する際、除外されたサブパスを表示するには、設定されたパスを展開する必要が出ることがあります。
コンテンツをコピー copy-content
コンテンツセットを作成したら、それを使用してコンテンツをコピーできます。次の手順に従って、コンテンツをコピーします。
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
-
概要 ページから、環境 画面に移動します。
-
環境 画面から、コンテンツセット ページに移動します。
-
コンソールからコンテンツセットを選択し、省略記号メニューから「コンテンツをコピー」を選択します。
note note NOTE 次の場合、環境を選択できない可能性があります。 - ユーザーに適切な権限がない。
- 環境でパイプラインが実行されているか、コンテンツのコピー操作が処理中。
-
コンテンツをコピー ダイアログボックスで、コンテンツコピーアクションのソースおよび宛先環境を指定します。
- ターゲット環境の地域は、ソース環境の地域と同じにするか、そのサブセットにする必要があります。
-
宛先環境で除外パスを削除または保持するよう選択できます。コンテンツセットで指定した
exclude paths
を保持するには、Do not delete exclude paths from destination
チェックボックスをオンにします。チェックボックスをオフにすると、ターゲット環境で除外パスが削除されます。 -
ソース環境から宛先環境にコピーするパスのバージョン履歴をコピーするよう選択できます。すべてのバージョン履歴をコピーする場合は、
Copy Versions
チェックボックスをオンにします。 -
「コピー」をクリックします。
コピープロセスが開始します。コピープロセスのステータスは、選択したコンテンツセットのコンソールに反映されます。
コンテンツのコピーアクティビティ copy-activity
コピープロセスのステータスは、コンテンツをコピーアクティビティ ページで監視できます。
-
my.cloudmanager.adobe.com で Cloud Manager にログインし、適切な組織とプログラムを選択します。
-
概要 ページから、環境 画面に移動します。
-
環境 画面から、コンテンツをコピーアクティビティ ページに移動します。
コンテンツのコピーステータス statuses
コンテンツのコピーを開始すると、プロセスに次のいずれかのステータスが設定されます。
制限事項 limitations
コンテンツのコピーツールには次の制限があります。
- 下位環境から上位環境へのコンテンツのコピーは実行できません。
- コンテンツのコピーは、同じ層内でのみ実行できます。つまり、オーサーとオーサー間またはパブリッシュとパブリッシュ間である場合は実行できます。
- プログラム間および地域間でのコンテンツのコピーはできません。
- クラウドデータストアベースのトポロジのコンテンツのコピーは、ソース環境と宛先環境が同じクラウドプロバイダーおよび同じ地域上にある場合にのみ実行できます。
- 同じ環境でコンテンツのコピー操作を同時に実行することはできません。
- CI/CD パイプラインなどの宛先またはソース環境でアクティブな操作が実行されている場合、コンテンツのコピーは実行できません。
- コンテンツセットごとに最大 50 個のパスを指定できます。除外されるパスに制限はありません。
- コンテンツのコピーツールは、ソース上の移動されたコンテンツや削除されたコンテンツをトラックできないので、クローンまたはミラーリングツールとして使用しないでください。
- コンテンツコピーは、開始後に一時停止したりキャンセルしたりすることはできません。
- コンテンツコピーツールは、アセットと Dynamic Media メタデータを上位環境から選択した下位環境にコピーします。コピーしたアセットは、それぞれの Dynamic Media 設定を使用するために、下位環境で DAM プロセスアセットワークフローを使用して再処理する必要があります。
- バージョン履歴をコピーしない場合、コンテンツのコピープロセスは大幅に高速になります。
- 2 GB を超えるアセットサイズが有効になっている Dynamic Media 設定はサポートされていません。
- バージョン履歴をコピーしない場合、コンテンツのコピープロセスは大幅に高速になります。
- ターゲット環境の地域は、ソース環境の地域と同じにするか、そのサブセットにする必要があります。
既知の問題 known-issues
コンテンツのコピー機能を使用する際に、ソース環境のリソースの名前を変更すると、ターゲット環境で UUID が競合するので、コンテンツのコピー操作が失敗する可能性があります。
このエラーを回避するには、リソースの名前を変更する代わりに、まずリソースを削除してから、目的の新しいリソース名で再作成します。