--- title: "SourceBuild 시작" slug: "sourcebuild-start" tags: ["sourcebuild"] updated: 2026-08-20T09:03:30Z published: 2026-08-20T09:03:30Z canonical: "guide-gov.ncloud-docs.com/sourcebuild-start" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # SourceBuild 시작 Classic/VPC 환경에서 이용 가능합니다. SourceBuild 시작에서는 SourceBuild 사용 환경을 확인하고 전체 [사용 시나리오](/docs/sourcebuild-procedure)와 [용어](/docs/sourcebuild-glossary)를 숙지한 후 SourceBuild를 정상적으로 사용하기 위해 사용자가 해야 할 일을 설명합니다. SourceBuild 시작에서 설명하는 내용은 다음과 같습니다. - 소스 코드를 준비하는 방법 - Object Storage 버킷을 생성하는 방법 - Container Registry를 연동하는 방법 - SourceBuild 이용에 필요한 사용자 권한을 설정하는 방법 - 빌드 프로젝트를 생성하는 방법 ## 소스 코드 준비 빌드할 소스 코드는 세 종류의 리포지토리에서 준비할 수 있습니다. - 네이버 클라우드 플랫폼의 SourceCommit - [GitHub](https://github.com/) - [Bitbucket](https://bitbucket.org) - [GitHub Enterprise](https://github.com/enterprise) ### SourceCommit에서 코드 커밋 네이버 클라우드 플랫폼의 SourceCommit을 사용해 코드를 커밋하는 방법은 다음과 같습니다. 주의 - 여기에서는 코드 커밋 방법을 간단하게 소개합니다. 전체 커밋 방법에 대한 자세한 내용은 [SourceCommit 사용 가이드](/docs/devtools-sourcecommit-commitoverview)를 참고해 주십시오. - 사용량에 따라 요금이 부과될 수 있습니다. 서비스 이용 요금에 대한 자세한 내용은 포털의 [SourceCommit 소개](https://www.gov-ncloud.com/product/devTools/sourceCommit)를 참고해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오. 2. 콘솔 화면 우측 상단의 **리전 & 플랫폼** 버튼을 클릭해 주십시오. 3. 이용 중인 리전과 플랫폼을 선택한 후 **[적용]** 버튼을 클릭해 주십시오. 4. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오. 5. **All Services** > **Developer Tools** > **SourceCommit** 메뉴를 차례대로 클릭해 주십시오. 6. **[리포지토리 생성]** 버튼을 클릭해 주십시오. 7. 리포지토리 이름과 설명을 입력하고 초기화 설정을 선택한 후 **[다음]** 버튼을 클릭해 주십시오. 8. 보안 서비스인 File Safer와의 연동 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오. 9. 최종 내용을 확인하고 **[생성]** 버튼을 클릭해 주십시오. ## Object Storage 버킷 생성 빌드 결과물을 저장할 Object Storage 버킷을 생성하는 방법은 다음과 같습니다. 주의 - 여기에서는 버킷 생성 방법을 간단하게 소개합니다. 전체 생성 방법에 대한 자세한 내용은 [Object Storage 사용 가이드](/docs/storage-storage-6-1)를 참고해 주십시오. - 사용량에 따라 요금이 부과될 수 있습니다. 서비스 이용 요금에 대한 자세한 내용은 포털의 [Object Storage 소개](https://www.gov-ncloud.com/product/storage/objectStorage)를 참고해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오. 2. 콘솔 화면 우측 상단의 **리전 & 플랫폼** 버튼을 클릭해 주십시오. 3. 이용 중인 리전과 플랫폼을 선택한 후 **[적용]** 버튼을 클릭해 주십시오. 4. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오. 5. **All Services** > **Storage** > **Object Storage** 메뉴를 차례대로 클릭해 주십시오. 6. **[이용 신청]** 버튼을 클릭해 주십시오. 7. 이용 신청 팝업 창이 나타나면 **[적용]** 버튼을 클릭해 주십시오. 8. **Bucket Management** 메뉴를 클릭해 주십시오. 9. **[버킷 생성]** 버튼을 클릭해 주십시오. 10. 생성할 버킷 이름을 입력하고 **[다음]** 버튼을 클릭해 주십시오. 11. 버킷 이용에 대한 권한을 설정하고 **[다음]** 버튼을 클릭해 주십시오. 12. 잠금 여부 및 저장 객체의 암호화 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오. 13. 최종 내용을 확인하고 **[버킷 생성]** 버튼을 클릭해 주십시오. ## Container Registry 연동 빌드 완료 후 해당 빌드 환경을 이미지화해 저장하려면 네이버 클라우드 플랫폼의 Container Registry에서 레지스트리를 생성해 Object Storage와 연동해야 합니다. Container Registry를 연동하는 방법은 다음과 같습니다. 주의 - 여기에서는 Container Registry 연동 방법을 간단하게 소개합니다. 전체 연동 방법에 대한 자세한 내용은 [Container Registry 사용 가이드](/docs/container-ncr-1-1)를 참고해 주십시오. - 사용량에 따라 요금이 부과될 수 있습니다. 서비스 이용 요금에 대한 자세한 내용은 포털의 [Container Registry 소개](https://www.gov-ncloud.com/product/compute/containerRegistry)를 참고해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오. 2. 콘솔 화면 우측 상단의 **리전 & 플랫폼** 버튼을 클릭해 주십시오. 3. 이용 중인 리전과 플랫폼을 선택한 후 **[적용]** 버튼을 클릭해 주십시오. 4. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오. 5. **All Services** > **Containers** > **Container Registry** 메뉴를 차례대로 클릭해 주십시오. 6. **[레지스트리 생성]** 버튼을 클릭해 주십시오. 7. 생성할 레지스트리의 이름을 입력한 후 연동할 Object Storage 버킷을 선택하고 **[생성]** 버튼을 클릭해 주십시오. - 하나의 버킷에는 한 개의 레지스트리만 연동할 수 있습니다. ## 사용자 권한 설정 로그인 계정에 따른 SourceBuild 이용 권한을 확인하고 필요에 따라 콘솔의 **Menu** > **All Services** > **Management & Governance** > **Sub Account** 메뉴에서 서브 계정 권한을 설정해 주십시오. - 고객 계정: SourceBuild의 모든 기능을 제약 없이 이용 가능 - 고객이 생성한 서브 계정: SourceBuild를 사용하려면 다음 권한 중 하나가 필요 - NCP_INFRA_MANAGER: 모든 서비스에 접근할 수 있으나 콘솔의 **My Account** > **과금 정보 및 비용 관리** > **청구 및 결제 관리** 메뉴만 접근이 차단된 권한 - NCP_SOURCEBUILD_MANAGER: SourceBuild 내 모든 기능 이용 가능 참고 서브 계정에 액션(action)별 상세 권한을 설정하려면 다음 문서를 참고해 주십시오. - [Sub Account 사용 가이드](/docs/subaccount-overview) - [SourceBuild 권한 관리](/docs/devtools-devtools-3-4) ## 빌드 프로젝트 생성 소스 코드, 버킷, 레지스트리 준비 및 권한 설정을 마쳤다면 콘솔에서 빌드 프로젝트를 생성합니다. 생성하는 방법은 다음과 같습니다. 주의 여기에서는 빌드 프로젝트 생성 방법을 간단하게 소개합니다. 전체 생성 방법에 대한 자세한 내용은 [빌드 프로젝트 생성](/docs/sourcebuild-use-create)을 참고해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오. 2. **[빌드 프로젝트 생성]** 버튼을 클릭해 주십시오. 3. **필수 준비 사항**에서 Object Storage가 **사용중**으로 선택되어 있는지 확인하고 **[다음]** 버튼을 클릭해 주십시오. 4. 생성할 빌드 프로젝트의 이름을 입력하고 빌드 대상을 선택한 후 **[다음]** 버튼을 클릭해 주십시오. - 빌드 대상인 소스 코드가 저장된 리포지토리를 SourceCommit, GitHub, Bitbucket, Github Enterprise Server 중에서 선택 - GitHub, Bitbucket, Github Enterprise Server 선택 시 로그인을 통해 서비스 연동 후 세부 경로 선택 5. 빌드 환경 이미지를 선택하고 빌드 환경을 설정한 후 **[다음]** 버튼을 클릭해 주십시오. - 빌드 환경 이미지 출처를 SourceBuild, Container Registry, Public Registry 중에서 선택 - 선택한 이미지 출처에 따른 세부 항목 설정 및 입력 6. 빌드를 진행할 명령어를 설정하고 **[다음]** 버튼을 클릭해 주십시오. 7. 빌드 결과물과 완료 이미지의 저장 여부를 설정하고 **[다음]** 버튼을 클릭해 주십시오. 8. 빌드 로그 보관을 위한 Cloud Log Analystics 및 결과물 악성 코드 검사를 위한 File Safer와의 연동 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오. 9. 입력된 정보를 확인하고 **[생성]** 버튼을 클릭해 주십시오.