ドキュメントExperience Cloud KCS

Cloud Managerのコードスキャンエラーとオーバーライド動作の問題

最終更新日： 2026年7月6日

Adobe Experience Manager as a Cloud Service（AEMaaCS） Cloud Managerのコードのスキャンは、重要または重要なコード品質の指標がデプロイメント要件を満たさない場合に失敗します。 この問題は、Cloud Managerがコード品質ゲートを適用して、重要な問題のデプロイメントをブロックし、パイプライン設定に基づいて重要な問題の上書きを条件付きで許可するためです。 この問題は、デプロイメントの進行状況、パイプラインの実行、ターゲット環境へのコードのプロモーションに影響します。 問題を解決するには、違反を修正し、オーバーライドを検証して、パイプラインを再実行します。

説明 description

環境

Adobe Experience Manager as a Cloud Service （AEMaaCS）

問題/症状

  • コード品質ステップ中にFAIL_CRITICAL_METRICSでパイプラインが失敗します。
  • パイプラインは重要な問題で一時停止し、以前の上書きが存在する場合に​ 上書き ​の警告を表示します。
  • Cloud Manager UIには重大な問題は表示されませんが、CSV レポートには重大または重大な結果が含まれています。
  • 「上書き」オプションはパイプライン UIでは使用できません。

根本原因

この問題は、Cloud Managerが、Critical、Important、Infoの各指標で構成される3層のコード品質モデルを適用するために発生します。 重大な問題は常にデプロイメントをブロックし、オーバーライドをサポートしません。 重要な問題デプロイメントを一時停止し、パイプラインのタイプと設定で許可されている場合にのみオーバーライドをサポートします。 UIとCSVの結果の違いは、CSVに生のスキャン結果が含まれているのに対し、UIには指標に基づく結果が表示されるため発生します。 オーバーライドオプションは、エラーがクリティカルな場合や、パイプラインタイプがオーバーライドをサポートしていない場合は使用できません。

解決策 resolution

次の手順に従って、障害カテゴリを特定し、コードスキャンの問題を正常に解決します。

  1. 失敗したパイプライン実行のコード品質ステップを確認して、パイプラインの失敗に重要な問題または重要な問題が含まれているかどうかを特定します。
  2. CSV結果をダウンロードし、ルール ID、重要度、ファイル参照を確認することで、Cloud Manager UIとCSV レポートの間の相違を検証します。
  3. 重大な問題は上書きをサポートしていないため、CSV レポートで特定されたコード違反を修正して、重大な問題を解決します。
  4. 「重要な問題」セクションを確認し、現在のパイプラインタイプで上書き機能が許可されていることを確認して、パイプラインが上書きをサポートしているかどうかを判断します。
  5. 上書きの承認が必要な場合は、割り当てられた役割にデプロイメントマネージャー、プロジェクトマネージャー、またはビジネスオーナーの権限が含まれていることを確認します。
  6. 影響を受けるルールに適切な@SuppressWarnings注釈を適用し、パイプラインを再実行することで、有効な偽陽性を抑制します。
  7. 設定されたパイプライン動作を確認し、ビジネス要件に一致することを確認して、重要な指標の動作の設定を検証します。
  8. ビルド失敗によりコード品質の上書きの可用性が妨げられるので、上書き動作のトラブルシューティングを行う前に、ビルド手順が正常に完了したことを確認します。
  9. パイプラインがコード品質ステップを通過するか、承認された上書きパスを進み、重大な問題がゼロに戻り、CSVおよびUIの結果が期待値に一致することを確認して、解決を検証します。

エスカレーションするタイミング

  • 特定されたすべてのコード修正が適用された後も、重大な問題が引き続き発生します。
  • パイプラインタイプと割り当てられた役割を検証した後も、「上書き」オプションは使用できません。
  • CSV レポートには、期待される動作と一致しないルール IDまたは重大度の分類が含まれています。
  • 検証後も、UIとCSVの結果に一貫性のない重大度の情報が引き続き表示されます。

関連トピックス

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