---
title: "SourceBuild 시작"
slug: "sourcebuild-start"
tags: ["SourceBuild"]
updated: 2026-09-17T09:09:26Z
published: 2026-09-17T09:09:26Z
canonical: "guide-fin.ncloud-docs.com/sourcebuild-start"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SourceBuild 시작

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.fin-ncloud.com/product/devTools/sourceCommit)를 참고해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오.
3. **All Services** > **Developer Tools** > **SourceCommit** 메뉴를 차례대로 클릭해 주십시오.
4. **[리포지토리 생성]** 버튼을 클릭해 주십시오.
5. 리포지토리 이름과 설명을 입력하고 초기화 설정을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
6. 보안 서비스인 File Safer와의 연동 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오.
7. 최종 내용을 확인하고 **[생성]** 버튼을 클릭해 주십시오.

## Object Storage 버킷 생성

빌드 결과물을 저장할 Object Storage 버킷을 생성하는 방법은 다음과 같습니다.

주의

- 여기에서는 버킷 생성 방법을 간단하게 소개합니다. 전체 생성 방법에 대한 자세한 내용은 [Object Storage 사용 가이드](/docs/storage-objectstorage-objectstorageoverview)를 참고해 주십시오.
- 사용량에 따라 요금이 부과될 수 있습니다. 서비스 이용 요금에 대한 자세한 내용은 포털의 [Object Storage 소개](https://www.fin-ncloud.com/product/storage/objectStorage)를 참고해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오.
3. **All Services** > **Storage** > **Object Storage** 메뉴를 차례대로 클릭해 주십시오.
4. **[이용 신청]** 버튼을 클릭해 주십시오.
5. 이용 신청 팝업 창이 나타나면 **[적용]** 버튼을 클릭해 주십시오.
6. **Bucket Management** 메뉴를 클릭해 주십시오.
7. **[버킷 생성]** 버튼을 클릭해 주십시오.
8. 생성할 버킷 이름을 입력하고 **[다음]** 버튼을 클릭해 주십시오.
9. 버킷 이용에 대한 권한을 설정하고 **[다음]** 버튼을 클릭해 주십시오.
10. 잠금 여부 및 저장 객체의 암호화 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오.
11. 최종 내용을 확인하고 **[버킷 생성]** 버튼을 클릭해 주십시오.

## Container Registry 연동

빌드 완료 후 해당 빌드 환경을 이미지화해 저장하려면 네이버 클라우드 플랫폼의 Container Registry에서 레지스트리를 생성해 Object Storage와 연동해야 합니다. Container Registry를 연동하는 방법은 다음과 같습니다.

주의

- 여기에서는 Container Registry 연동 방법을 간단하게 소개합니다. 전체 연동 방법에 대한 자세한 내용은 [Container Registry 사용 가이드](/docs/container-ncr-1-1)를 참고해 주십시오.
- 사용량에 따라 요금이 부과될 수 있습니다. 서비스 이용 요금에 대한 자세한 내용은 포털의 [Container Registry 소개](https://www.fin-ncloud.com/product/compute/containerRegistry)를 참고해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오.
3. **All Services** > **Containers** > **Container Registry** 메뉴를 차례대로 클릭해 주십시오.
4. **[레지스트리 생성]** 버튼을 클릭해 주십시오.
5. 생성할 레지스트리의 이름을 입력한 후 연동할 Object Storage 버킷을 선택하고 **[생성]** 버튼을 클릭해 주십시오.
  - 하나의 버킷에는 한 개의 레지스트리만 연동할 수 있습니다.

## 사용자 권한 설정

로그인 계정에 따른 SourceBuild 이용 권한을 확인하고, 필요에 따라 콘솔의 **Management & Governance** > **Sub Account** 메뉴에서 서브 계정 권한을 설정해 주십시오.

- 고객 계정: SourceBuild의 모든 기능을 제약 없이 이용 가능
- 고객이 생성한 서브 계정: SourceBuild를 사용하려면 다음 권한 중 하나가 필요
  - **NCP_FIN_INFRA_MANAGER**: 고객 계정과 동일하게 SourceBuild를 포함한 네이버 클라우드 플랫폼 내 모든 서비스 이용 가능. 단, **My Account**의 일부 관리 기능 제외.
  - **NCP_FIN_SOURCEBUILD_MANAGER**: SourceBuild 내 모든 기능 이용 가능

참고

서브 계정에 액션(action)별 상세 권한을 설정하려면 다음 문서를 참고해 주십시오.

- [Sub Account 사용 가이드](/docs/subaccount-overview)
- [SourceBuild 권한 관리](/docs/devtools-sourcebuild-buildsubaccount)

## 빌드 프로젝트 생성

소스 코드, 버킷, 레지스트리 준비 및 권한 설정을 마쳤다면 콘솔에서 빌드 프로젝트를 생성합니다. 생성하는 방법은 다음과 같습니다.

주의

여기에서는 빌드 프로젝트 생성 방법을 간단하게 소개합니다. 전체 생성 방법에 대한 자세한 내용은 [빌드 프로젝트 생성](/docs/sourcebuild-use-create)을 참고해 주십시오.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. 콘솔 화면 좌측 상단의 **Menu**를 클릭해 주십시오.
3. **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
4. **[빌드 프로젝트 생성]** 버튼을 클릭해 주십시오.
5. **필수 준비 사항**에서 Object Storage가 **사용중**으로 선택되어 있는지 확인하고 **[다음]** 버튼을 클릭해 주십시오.
6. 생성할 빌드 프로젝트의 이름을 입력하고 빌드 대상을 선택한 후 **[다음]** 버튼을 클릭해 주십시오.
  - 빌드 대상인 소스 코드가 저장된 리포지토리를 SourceCommit, GitHub, Bitbucket, Github Enterprise Server 중에서 선택
  - GitHub, Bitbucket, Github Enterprise Server 선택 시 로그인을 통해 서비스 연동 후 세부 경로 선택
7. 빌드 환경 이미지를 선택하고 빌드 환경을 설정한 후 **[다음]** 버튼을 클릭해 주십시오.
  - 빌드 환경 이미지 출처를 SourceBuild, Container Registry, Public Registry 중에서 선택
  - 선택한 이미지 출처에 따른 세부 항목 설정 및 입력
8. 빌드를 진행할 명령어를 설정하고 **[다음]** 버튼을 클릭해 주십시오.
9. 빌드 결과물과 완료 이미지의 저장 여부를 설정하고 **[다음]** 버튼을 클릭해 주십시오.
10. 빌드 로그 보관을 위한 Cloud Log Analystics 및 결과물 악성 코드 검사를 위한 File Safer와의 연동 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오.
11. 입력된 정보를 확인하고 **[생성]** 버튼을 클릭해 주십시오.