설명서Experience Cloud KCS

Cloud Manager 코드 스캔 실패 및 동작 문제 재정의

마지막 업데이트: 2026년 7월 6일

중요 또는 중요 코드 품질 지표가 배포 요구 사항을 충족하지 않는 경우 AEMaaCS(Adobe Experience Manager as a Cloud Service) Cloud Manager 코드 스캔이 실패합니다. 이 문제는 Cloud Manager에서 중요한 문제에 대한 배포를 차단하고 파이프라인 구성에 따라 중요한 문제에 대한 재정의를 조건부로 허용하는 코드 품질 게이트를 시행하기 때문에 발생합니다. 이 문제는 배포 진행, 파이프라인 실행 및 타겟 환경으로의 코드 프로모션에 영향을 줍니다. 이 문제를 해결하려면 위반을 수정하고, 재정의를 확인한 다음 파이프라인을 다시 실행합니다.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 코드 품질 단계 동안 파이프라인이 FAIL_CRITICAL_METRICS(으)로 실패합니다.
  • 파이프라인이 중요한 문제에 대해 일시 중지되며 이전 재정의가 존재할 때 재정의됨 경고를 표시합니다.
  • Cloud Manager UI에는 심각한 문제가 0으로 표시되지만 CSV 보고서에는 심각한 또는 주요 결과가 포함됩니다.
  • 파이프라인 UI에서는 무시 옵션을 사용할 수 없습니다.

근본 원인

이 문제는 Cloud Manager에서 중요, 중요 및 정보 지표로 구성된 3계층 코드 품질 모델을 시행하기 때문에 발생합니다. 심각한 문제는 항상 배포를 차단하며 무시를 지원하지 않습니다. 파이프라인 유형 및 구성에서 허용하는 경우에만 배포 및 지원 무시를 일시 중지하는 중요한 문제가 발생합니다. UI에 지표 파생 결과가 표시되는 동안 CSV에는 원시 스캔 결과가 포함되어 있으므로 UI와 CSV 결과 간의 차이가 발생합니다. 실패가 위험 또는 파이프라인 유형이 재정의를 지원하지 않는 경우에는 재정의 옵션을 사용할 수 없습니다.

해결 방법 resolution

다음 단계에 따라 실패 범주를 식별하고 코드 스캔 문제를 성공적으로 해결하십시오.

  1. 실패한 파이프라인 실행에서 코드 품질 단계를 검토하여 파이프라인 실패에 위험 또는 중요 문제가 포함되어 있는지 여부를 식별합니다.
  2. CSV 결과를 다운로드하고 규칙 ID, 심각도 및 파일 참조를 검토하여 Cloud Manager UI와 CSV 보고서 간의 불일치를 확인합니다.
  3. 중요 문제는 재정의를 지원하지 않으므로 CSV 보고서에서 식별된 코드 위반을 수정하여 중요 문제를 해결합니다.
  4. 중요한 문제 섹션을 검토하고 현재 파이프라인 유형에서 재정의 기능을 허용하는지 확인하여 파이프라인이 재정의를 지원하는지 여부를 결정합니다.
  5. 재정의 승인이 필요한 경우 할당된 역할에 배포 관리자, 프로젝트 관리자 또는 비즈니스 소유자 권한이 포함되어 있는지 확인합니다.
  6. 영향을 받는 규칙에 적절한 @SuppressWarnings 주석을 적용하고 파이프라인을 다시 실행하여 유효한 긍정 오류(false positive)를 표시하지 않습니다.
  7. 구성된 파이프라인 비헤이비어를 검토하고 비즈니스 요구 사항과 일치하는지 확인하여 중요 지표 비헤이비어 설정을 확인합니다.
  8. 빌드 오류로 인해 코드 품질 재정의 가용성이 차단되므로 재정의 동작 문제를 해결하기 전에 빌드 단계가 성공적으로 완료되었는지 확인하십시오.
  9. 파이프라인이 코드 품질 단계를 통과하거나 승인된 재정의 경로를 통해 진행하는지, 중요 문제가 0으로 반환되는지, CSV 및 UI 결과가 예상 값과 일치하는지 확인하여 해결 방법을 확인합니다.

에스컬레이션 시기

  • 식별된 모든 코드 수정 사항이 적용된 후에도 심각한 문제가 지속됩니다.
  • 파이프라인 유형 및 할당된 역할의 유효성을 검사한 후에도 무시 옵션을 사용할 수 없습니다.
  • CSV 보고서에 예상 동작과 일치하지 않는 규칙 ID 또는 심각도 분류가 포함되어 있습니다.
  • UI 및 CSV 결과는 유효성 검사 후 일관되지 않은 심각도 정보를 계속 표시합니다.

관련 읽기

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