最適化された GraphQL フィルタリング用コンテンツフラグメントの更新 updating-content-fragments-for-optimized-graphql-filtering

2023.1.0 リリース以降の AEM as a Cloud Service があることを確認します。

タスクを実行するユーザーに次の必要な権限があることを確認します。

• 少なくとも Cloud Manager で Deployment Manager の役割が必要です。

Cloud Manager UI を使用し、インスタンスに次の変数を設定して更新を有効にします。

使用できる変数は以下のとおりです。

更新の進行状況および完了を監視します。

これを行うには、以下でオーサーと golden-publish のログを監視します。

• com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob

  • オーサーログの例：

    code language-shell

    23.01.2023 13:13:45.926 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<dd9ffdc1-0c28-4d04-9a96-5d4d223e457e> is the leader, will schedule the upgrade schedule job. ... 23.01.2023 13:13:45.941 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, enforce: true, limit: 1000, batch: 50, interval: 60s 23.01.2023 13:20:40.960 *INFO* [sling-threadpool-09cbdb47-4d99-4c4c-b6d5-781b635ee21b-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 6m, slingJobId: 2023/1/23/13/13/50e1a575-4cd7-497b-adf0-62cb5768eedb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}

  • Golden-publish ログの例：

    code language-shell

    23.01.2023 12:35:05.150 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob This instance<ad1b399e-77be-408e-bc3f-57097498fddb> is the leader, will schedule the upgrade schedule job. 23.01.2023 12:35:05.161 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Scheduling content fragments upgrade from version 0 to 1, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, enforce: true, limit: 1000, batch: 50, interval: 60s ... 23.01.2023 12:40:45.180 *INFO* [sling-threadpool-8abcc1bb-cdcb-46d4-8565-942ad8a73209-(apache-sling-job-thread-pool)-1-Content Fragment Upgrade Job Queue Config(cfm/upgrader)] com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished content fragments upgrade in 5m, slingJobId: 2023/1/23/12/34/ad1b399e-77be-408e-bc3f-57097498fddb_0, status: MaintenanceJobStatus{jobState=SUCCEEDED, statusMessage='Upgrade to version '1' succeeded.', errors=[], successCount=3781, failedCount=0, skippedCount=0}

Splunk を使用して環境ログへのアクセスを有効にしたお客様は、以下のサンプルクエリを使用してアップグレードプロセスを監視できます。Splunk ログの有効化について詳しくは、実稼動環境とステージ環境のデバッグを参照してください。

index=<indexName> sourcetype=aemerror aem_envId=<environmentId> msg="*com.adobe.cq.dam.cfm.impl.upgrade.UpgradeJob Finished*"
(aem_tier=golden-publish OR aem_tier=author) | table _time aem_tier pod_name msg | sort -_time desc

ここで、

• environmentId - 顧客環境識別子（例：e1234）
• indexName - 顧客インデックス名、収集 aemerror イベント

出力例：

更新手順を無効にします。

更新手順を実行した後、クラウド環境変数をリセットします。CF_MIGRATION_ENABLED を「0」に変更して、すべてのポッドのリサイクルをトリガーします。

更新手順の完了を確認します。

Cloud Manager デベロッパーコンソールのリポジトリブラウザーで、更新が正常に完了したことを確認できます。この確認は、コンテンツフラグメントデータをチェックするためのものです。

• 最初の移行が完了するまでは、cfGlobalVersion プロパティは存在しません。
  したがって、JCR ノード /content/dam 上ににこのプロパティがあり、値が 1 になっている場合、移行が完了したことになります。

• 個々のコンテンツフラグメントで、次のプロパティも確認できます。

  • _strucVersion には 1 の値があるはずです。
  • indexedData 構造が存在する必要があります

  note note
  NOTE
  この手順では、オーサーインスタンスとパブリッシュインスタンスのコンテンツフラグメントを更新します。
  したがって、アドビでは、少なくとも 1 つのオーサーインスタンス​ と 1 つのパブリッシュインスタンスについては、リポジトリブラウザーを介して検証を実行することをお勧めします。