외부 Git 저장소 설정이 올바르지 않으면 Cloud Manager 구성 파이프라인이 실패합니다

Cloud Manager에서 외부 Git 저장소에서 파일을 다운로드할 수 없는 경우 Build & Unit Testing 동안 Cloud Manager 구성 파이프라인이 실패할 수 있습니다. 이 문제는 일반적으로 저장소 URL 변경, 분기 변경, BYOG 유효성 검사 문제, 공급자측 액세스 변경 또는 부실 파이프라인 메타데이터 후에 발생합니다. 이 오류는 리포지토리가 이전에 작동했을 때에도 종종 리포지토리 끝점으로 나타나거나 찾을 수 없음 오류로 나타납니다. 저장소 구성을 확인하고 소유권 유효성 검사 및 분기 설정을 확인한 다음 연결이 올바른 경우 파이프라인을 다시 시도하거나 다시 만듭니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Cloud Manager 구성 파이프라인
  • BYOG를 통해 연결된 외부 Git 저장소

문제/증상

  • 외부 저장소에서 구성 파일을 다운로드하는 동안 Build & Unit Testing 단계가 실패합니다.
  • shareName에 대한 다운로드 및 업로드를 처리하는 동안 빌드 로그에 오류가 표시됩니다. 원인: 입력한 저장소 URL이 올바른 끝점을 가리키지 않습니다. 외부 서비스가 ‘찾을 수 없음’ 오류로 응답했습니다.
  • 파이프라인은 이전에 작동했지만 저장소 URL 변경 또는 분기 변경 후 실패를 시작합니다.
  • 동일한 저장소를 사용하는 다른 파이프라인은 성공하지만 하나의 특정 구성 파이프라인은 실패합니다.
  • 동일한 저장소 및 분기 조합에 대해 간헐적으로 오류가 발생합니다.

원인

구성 파이프라인 빌드 단계는 Cloud Manager 저장소 서비스를 사용하여 구성된 외부 Git 저장소에서 파일을 검색합니다. Cloud Manager에서 필요한 분기 또는 경로를 검색할 수 없는 경우 저장소 끝점 또는 찾을 수 없음 오류가 반환됩니다. 이는 잘못된 저장소 URL, 잘못된 분기, 누락된 BYOG 유효성 검사 파일, 오래되거나 누락된 저장소 인증, 공급자측 액세스 제한, 코드의 오래된 저장소 참조, 일시적인 Git 공급자 오류 또는 오래된 파이프라인 메타데이터 때문에 발생할 수 있습니다.

해결 방법 resolution

외부 Git 저장소를 사용할 때 Cloud Manager 구성 파이프라인 오류를 해결하려면 다음 단계를 수행합니다.

  1. Cloud Manager에서 실패한 파이프라인을 열고 빌드 로그에 저장소 다운로드 실패가 표시되는지 확인합니다.
  2. 파이프라인 설정에서 구성된 저장소 URL 및 분기를 검토하고 외부 Git 공급자와 정확히 일치하지 않는 경우 두 값 중 하나를 수정합니다.
  3. 리포지토리가 GitHub와 함께 BYOG를 사용하는 경우 .well-known/adobe/cloud-manager-challenge이(가) 파이프라인에 구성된 동일한 분기에 있는지 확인하십시오.
  4. Cloud Manager 열기 > 저장소에서 연결된 저장소를 선택하고 해당 옵션을 사용할 수 있는 경우 저장소 연결을 새로 고치거나 업데이트합니다.
  5. Git 공급자에게 저장소가 접근 가능하며 공급자측 권한 또는 네트워크 제한이 Cloud Manager 액세스를 차단하지 않는지 확인합니다.
  6. 파이프라인을 한 번 또는 두 번 다시 실행하여 일시적인 외부 Git 공급자 오류를 방지합니다.
  7. 오류가 계속되고 저장소 구성이 올바른 경우 오류가 발생한 구성 파이프라인을 삭제하고 동일한 저장소 및 분기로 다시 만듭니다.
  8. 다시 만든 후에도 파이프라인이 계속 실패하는 경우 pom.xml과(와) 같은 프로젝트 파일이나 다른 모듈 구성 파일에서 오래된 저장소 참조를 검토하고 필요한 경우 업데이트합니다.
  9. 저장소 URL, 분기, 유효성 검사 파일 및 공급자 액세스가 모두 올바르고 파이프라인이 동일한 저장소 오류를 반환하는 경우 Adobe 지원에 문의하십시오.

관련 읽기

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