--- title: "SourcePipeline 문제 해결" slug: "sourcepipeline-troubleshoot" updated: 2026-09-17T09:07:44Z published: 2026-09-17T09:07:44Z canonical: "guide.ncloud-docs.com/sourcepipeline-troubleshoot" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # SourcePipeline 문제 해결 Classic/VPC 환경에서 이용 가능합니다. SourcePipeline 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## “빌드/배포 작업에 변경사항이 있습니다. 특정 상품에서 확인하시기 바랍니다.” 오류 메시지 “빌드/배포 작업에 변경사항이 있습니다. 특정 상품에서 확인하시기 바랍니다.” 오류 메시지가 표시됩니다. #### 원인 - 기존 정보로 파이프라인을 수행할 수 없을 때 발생하는 오류입니다. SourcePipeline에 설정된 SourceBuild 또는 SourceDeploy에 변경 사항이 있을 경우, 발생할 수 있습니다. - SourceBuild 프로젝트에 설정한 대상 리포지토리와 SourcePipeline에서 설정한 리포지토리가 일치해야 합니다. - SourceDeploy 시나리오에 설정한 배포 파일과 SourcePipeline에서 설정한 배포 파일이 일치해야 합니다. - SourcePipeline에서 설정한 SourceBuild 프로젝트 혹은 SourceDeploy 프로젝트/스테이지/시나리오가 삭제된 경우에도 파이프라인을 수행할 수 없습니다. #### 해결 방법 - SourceBuild 또는 SourceDeploy에 변경 사항 있는지 확인해 주십시오. - SourceBuild 프로젝트에 설정한 대상 리포지토리와 SourcePipeline에서 설정한 리포지토리가 일치하는지 확인해 주십시오. - SourceDeploy 시나리오에 설정한 배포 파일과 SourcePipeline에서 설정한 배포 파일이 일치하는지 확인해 주십시오. - SourcePipeline에서 설정한 SourceBuild 프로젝트 혹은 SourceDeploy 프로젝트/스테이지/시나리오가 삭제되었는지 확인해 주십시오. - SourcePipeline을 다시 설정해 주십시오. ## SourcePipeline 실행 시 FAIL 발생 SourcePipeline의 실행 시 'FAIL'이 발생합니다. SourcePipeline의 실행 API 호출 시 실패합니다. #### 원인 - 프로젝트에 연결된 SourceBuild 또는 SourceDeploy의 프로젝트 실행 실패로 인해 전체 파이프라인이 실패할 수 있습니다. - SourceBuild: 빌드 설정이 잘못된 경우, 오류가 발생할 수 있습니다. - SourceDeploy: 배포 서버에 설치된 에이전트가 최신 버전이 아닐 경우, 오류가 발생할 수 있습니다. - 파이프라인 실행 API 호출 시 'POST' 메서드를 사용해야 합니다. #### 해결 방법 - SourceBuild 또는 SourceDeploy의 프로젝트 실행 실패 원인을 점검해 주십시오. - SourceBuild: [SourceBuild 프로젝트 생성 가이드](/docs/sourcebuild-use-create)를 참조하여 프로젝트 생성 시 설정에 문제가 없는지 확인해 주십시오. - SourceDeploy: [에이전트 설치 및 관리](/docs/devtools-devtools-4-4)를 참조하여 SourceDeploy 에이전트를 재설치해 주십시오. - API 호출 시 'POST' 메서드를 사용하도록 수정한 후, 다시 시도해 주십시오. 자세한 설명은 [SourcePipeline API 가이드](https://api.ncloud-docs.com/docs/devtools-sourcepipeline-do)를 참조해 주십시오. ## 둘러볼 콘텐츠 네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. SourcePipeline 서비스 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다. - 자주 하는 질문: [SourcePipeline 자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=DEVTL&categoryCode3=SV_0105&page=1) - 네이버 클라우드 플랫폼 블로그: [DevSecOps를 위한 모든 것! SourceBuild, SourceDeploy, SourcePipeline 개발자 도구 출시](https://blog.naver.com/n_cloudplatform?Redirect=Log&logNo=221491436381&from=postView&trackingCode=blog_bloghome_searchlist) - 네이브 클라우드 플랫폼 블로그: [네이버 클라우드 플랫폼에서 Dev Tools를 활용하여 컨테이너 이미지 빌드 자동화 구현하기](https://blog.naver.com/n_cloudplatform/222609419585?trackingCode=blog_bloghome_searchlist) - API 가이드: [SourcePipeline API 가이드](https://api.ncloud-docs.com/docs/devtools-sourcepipeline) 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.