Oak インデックスバージョンの競合により、AEM Cloud Managerのデプロイメントが失敗する

最終更新日： 2026年10月30日

新しいカスタム Oak インデックスのメジャーバージョンが既存のインデックスよりも低い場合、Adobe Experience Manager（AEM）Cloud Managerのデプロイメントがインデックス再作成中に失敗することがあります。この問題を解決するには、変更を最新の上位バージョンのインデックスにマージし、増分バージョンを含むインデックス定義を作成して再デプロイします。

説明 description

環境

Adobe Experience Manager（AEM）Cloud Manager（すべてのバージョン）

問題/症状

カスタム Oak インデックスに新しい属性を変更または追加した後、インデックス再作成手順でCloud Managerのデプロイメントが失敗します。
デプロイメントログには、カスタムインデックス間のバージョンの競合が表示されます。
次のエラーが表示されます：インデックスの比較に失敗しました。メジャーバージョンの高いインデックスが既に存在するため、新しいカスタマイズされたインデックスを追加できません。より高いメジャーバージョンが優先されるため、新しくカスタマイズされたインデックスは使用されません。この問題を解決するには、新しくカスタマイズしたインデックスを最新のインデックスと結合し、最新のインデックスよりも高いバージョン番号になるように名前を変更する必要があります。
インデックスのバージョンの競合以外のログで特定のエラーが発生せずにデプロイメントが失敗します。

根本原因

新しいカスタム Oak インデックスのメジャーバージョンが既存のインデックスよりも低いため、デプロイメントは失敗します。 Oak インデックスのバージョン管理では、最も高いバージョンのみがアクティブである必要があります。下位のバージョンは無視され、インデックスがマージされてバージョンが正しく設定されていない場合、デプロイメントがブロックされる可能性があります。

解決策 resolution

問題を解決するには、次の手順に従います。

デプロイメントログを確認して、エラーメッセージに記載されているカスタム Oak インデックス名とバージョン番号を特定します。
下位バージョンのカスタムインデックスの変更を、最新の上位バージョンのインデックスに結合します。
変更を結合した後、増分バージョン番号を含む新しいインデックス定義を作成します。
新しいバージョンで更新されたインデックス定義がデプロイメントパッケージに含まれていることを確認します。古い下位バージョンのインデックスが不要になった場合は、削除またはアーカイブします。
Cloud Managerで新しいデプロイメントをトリガーし、インデックス再作成手順が正常に完了したことを確認します。

recommendation-more-help

experience-cloud-kcs-help-kbarticles