설명서Experience Cloud KCS

배포가 Bitbucket Adobe Commerce Cloud에서 코드를 가져오지 못함

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

Adobe Commerce Cloud에서 통합 중에 플랫폼이 Bitbucket 저장소에서 코드를 가져오지 못하면 배포가 시작되지 않습니다. 이 문제는 서비스 간 인증 또는 액세스 문제와 관련이 있습니다. 이 문제를 해결하려면 통합 자격 증명을 업데이트하고 저장소 액세스 구성을 확인하십시오.

설명 description

환경

  • 제품: Adobe Commerce Cloud
  • 버전: 2.4.7
  • 인스턴스: 배포 자동화를 위한 Bitbucket 통합

문제/증상

  • 가져오기 요청을 모니터링되는 분기로 병합한 후에는 배포가 진행되지 않습니다.
  • 통합 활동 로그에 integration.bitbucket.fetch 단계의 오류가 표시됩니다.
  • 오류 메시지에는 오류: 내부 오류 및 Bitbucket의 원격 리포지토리에 액세스하는 데 문제가 있습니다. 알 수 없는 예외
  • 빌드 또는 배포 파이프라인이 시작되기 전에 오류가 발생합니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. 다음을 포함하여 Bitbucket 통합에 대한 최근 변경 사항을 검토합니다.

    • OAuth 소비자 자격 증명(키 및 암호)이 회전되었는지 또는 해지되었는지 여부입니다.
    • 저장소 또는 작업 영역 소유권에 대한 모든 변경 사항.
    • 통합에서 사용하는 Bitbucket 계정 또는 앱에 대한 권한 변경 사항입니다.
    • Bitbucket 작업 공간에 새 보안 정책, IP 허용 목록 또는 SSO 강제 적용 구현.

  2. 변경 사항이 발생하면 그에 따라 Adobe Commerce Cloud에서 통합 구성을 업데이트합니다.

  3. 필요한 경우 Bitbucket 및 Adobe Commerce Cloud에서 OAuth 소비자 자격 증명을 다시 만들거나 회전합니다.

  4. 자격 증명 및 권한을 업데이트한 후 magento-cloud integration:validate을(를) 사용하여 통합의 유효성을 다시 검사하십시오.

  5. 새 배포를 시도하여 저장소에서 코드를 성공적으로 가져올 수 있는지 확인합니다.

  6. 배포가 가져오기 단계를 오류 없이 진행하는지 확인합니다.

메모

Bitbucket 측에 최근 변경 사항이 없고 자격 증명을 업데이트한 후 문제가 지속되는 경우 지원에서 추가 조사가 필요할 수 있습니다.

관련 읽기

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