AEM as a Cloud ServiceでのSIM移行中にカスタムインデックスのデプロイメントが失敗する

この記事では、Simplified Index Management (SIM)への移行中にカスタムインデックスが一時的に非同期状態で停止した場合に発生するAdobe Experience Manager as a Cloud Serviceのデプロイメントエラーを解決する方法について説明します。 推奨される解決策は、環境をリセットし、カスタムインデックスを段階的に再導入することです。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • 簡易インデックス管理(SIM)

症状

  • SIMへの移行中にデプロイメントパイプラインが失敗する。
  • カスタムインデックスが「移行中」状態で停止している。
  • 索引プロパティには、async = temp-async,nrtとasync-previous = async,nrtが含まれます。
  • ログ メッセージには、インデックス データを適用する際の​ 失敗 ​や​ 現在のチェックポイントがレーン [の非同期、nrt] ​に見つからないなどのエラーが含まれています。

原因

この問題は、複数のカスタムインデックスが同時に移行され、インデックスジョブが自動的に解決できない一貫性のない状態でインデックスを残す場合に発生します。

解決策 resolution

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

  1. 影響を受けるカスタムインデックスをSIM設定から一時的に削除するか、インデックス差分ファイルにエントリをコメントアウトします。

  2. 開発環境やローカル環境など、CRXDE アクセス権を持つAEM オーサー環境では、問題のあるカスタムインデックスごとに/oak:indexの下の影響を受けるインデックスノードを削除します。

  3. AEM as a Cloud Serviceのパブリッシュ環境とプレビュー環境では、直接CRXDE アクセスを使用できません。Cloud Managerを使用して環境をリセットします。 メモ:このアクションは、オーサー、公開、プレビューをクリーンなリポジトリで開始します。

  4. カスタムインデックスを含まないCloud Manager パイプラインを実行します。 インデックス作成ステップがエラーなしで正常に完了することを確認します。

  5. SIMを使用してカスタムインデックスを段階的に再導入します。

    • 一度に1つのカスタムインデックスを追加します。
    • 各追加後にCloud Manager パイプラインを実行します。
  6. 各デプロイメントの後、オーサーでインデックス設定を確認します。

    • インデックスにasync = [ "async","nrt" ]があることを確認してください。
    • インデックスにasync-previous プロパティが含まれていないことを確認してください。
    • 各カスタムインデックスのアクティブなバージョンが1つだけコードベースに存在することを確認します。
    • インデックスがtemp-async状態になっていないことを確認します。
  7. Cloud Manager パイプラインが正常に完了し、影響を受ける機能が期待どおりに動作することを確認します。

注意:

  • AEM as a Cloud Serviceのインデックス設定の変更は、プロジェクトコードベースで管理し、Cloud Managerを通じてデプロイする必要があります。
  • 複数のカスタムインデックスのトラブルシューティングを行う場合は、デプロイメントエラーに関連するインデックスを特定するために、1つずつ再利用します。
  • インデックスを分離して段階的に再導入した後もデプロイメントが失敗し続ける場合は、標準サポートプロセスを通じてAdobe サポート ​にお問い合わせください。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles