---
title: "빌드 프로젝트 생성"
slug: "sourcebuild-use-create"
tags: ["SourceBuild", "SourceBuild 사용"]
updated: 2026-07-23T09:02:41Z
published: 2026-07-23T09:02:41Z
canonical: "guide-fin.ncloud-docs.com/sourcebuild-use-create"
---

> ## 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.

# 빌드 프로젝트 생성

네이버 클라우드 플랫폼 콘솔에서 빌드 프로젝트를 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
2. **[빌드 프로젝트 생성]** 버튼을 클릭해 주십시오.
3. **필수 준비 사항**에서 Object Storage가 **사용중**으로 선택되어 있는지 확인하고 **[다음]** 버튼을 클릭해 주십시오.
  - 미사용 중일 경우 ![i-sourcebuild_toggle](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/i-sourcebuild_toggle.png)을 클릭하면 Object Storage 화면으로 이동하며 서비스 이용 신청 및 버킷 생성 후 다시 시도
4. 화면을 따라 다음 단계를 차례대로 진행해 주십시오.
  - [1. 기본 설정](/docs/sourcebuild-use-create#1%EA%B8%B0%EB%B3%B8%EC%84%A4%EC%A0%95)
  - [2. 빌드 환경 설정](/docs/sourcebuild-use-create#2%EB%B9%8C%EB%93%9C%ED%99%98%EA%B2%BD%EC%84%A4%EC%A0%95)
  - [3. 빌드 명령어 설정](/docs/sourcebuild-use-create#3%EB%B9%8C%EB%93%9C%EB%AA%85%EB%A0%B9%EC%96%B4%EC%84%A4%EC%A0%95)
  - [4. 업로드 설정](/docs/sourcebuild-use-create#4%EC%97%85%EB%A1%9C%EB%93%9C%EC%84%A4%EC%A0%95)
  - [5. 추가 상품 연동](/docs/sourcebuild-use-create#5%EC%B6%94%EA%B0%80%EC%83%81%ED%92%88%EC%97%B0%EB%8F%99)
  - [6. 최종 확인](/docs/sourcebuild-use-create#6%EC%B5%9C%EC%A2%85%ED%99%95%EC%9D%B8)

## 1. 기본 설정

생성할 빌드 프로젝트에 대한 기본 정보를 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_1-basic_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_1-basic_ko.png)

1. 생성할 빌드 프로젝트의 이름과 설명을 입력해 주십시오.
  - 이름은 알파벳, 숫자, 특수문자(-, _) 사용 가능하며 이미 생성된 빌드 프로젝트와 동일한 이름 입력 불가
  - 설명은 500자 이내 입력 가능
2. 빌드 대상 유형을 선택한 후 필요한 세부 항목을 설정해 주십시오.
  - **SourceCommit** 선택 시 다음의 항목을 설정
    - **리포지토리**: 빌드 대상 코드가 저장된 리포지토리 선택
    - **브랜치**: 빌드 대상 리포지토리의 브랜치 선택
  - **Github** 선택 시 연동할 GitHub 계정 로그인 및 다음의 항목을 설정

              참고

              

GitHub에서 Personal access token 생성 방법에 대한 자세한 내용은 GitHub의 [Personal access token 생성 가이드](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)를 참고해 주십시오.
    - **[로그인]** 버튼을 클릭한 후 OAuth 인증 또는 Personal access token을 사용해 로그인
      - **OAuth**: **[GitHub 로그인 하기]** 버튼을 클릭한 후 GitHub 계정 정보를 입력
      - **Personal access token**: GitHub에서 발행한 Personal access token 값을 입력한 후 **[GitHub 로그인 하기]** 버튼 클릭
    - **리포지토리**: 빌드 대상 코드가 저장된 리포지토리 선택
    - **브랜치**: 빌드 대상 리포지토리의 브랜치 선택
  - **Bitbucket** 선택 시 연동할 Bitbucket 계정 로그인 및 다음의 항목을 설정
    - **[로그인] > [Bitbucket 로그인]** 버튼을 차례대로 클릭한 후 Bitbucket 계정 정보를 입력하거나 OAuth 계정 사용
    - **워크스페이스**: 빌드 대상 코드가 위치한 워크스페이스 선택
    - **리포지토리**: 빌드 대상 코드가 저장된 리포지토리 선택
    - **브랜치**: 빌드 대상 리포지토리의 브랜치 선택
  - **Github Enterprise Server** 선택 시 **[로그인]** 버튼을 클릭한 후 다음의 항목을 설정

              참고

              

    - 방화벽 설정 등으로 인해 Github Enterprise Server에 통신이 불가한 경우 해당 저장소 유형을 사용할 수 없습니다.
    - Github Enterprise Server URL 은 IP, Hostname으로 입력 가능하며, public 한 환경이어야 합니다.
    - SSH Key 로그인은 다른 로그인과 달리 입력한 Git 리포지토리 URL의 리포지토리만 접근 할 수 있습니다.
    - GitHub Enterprise Server 공식 가이드
      - [OAuth APP 생성 가이드](https://docs.github.com/ko/enterprise-server@3.10/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)
        - OAuth App 설정 시 Callback URL을 알맞게 설정해야 합니다.
          - FKR : https://github-devtools.fin-ncloud.com:9443/ghes/sourcebuild
      - [Personal Access Token 생성 가이드](https://docs.github.com/en/enterprise-server@3.10/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
      - [SSH key 설정 가이드](https://docs.github.com/ko/enterprise-server@3.10/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
    - 다음 중 하나의 인증 정보를 입력한 후 **[Github Enterprise Server 로그인]** 버튼 클릭
      - **OAuth**: 리포지토리를 가져올 **Github Enterprise Server URL**과 해당 서버에서 생성한 OAuth App의 **Client Id, Client Secret** 입력
      - **Personal Access Token**: 리포지토리를 가져올 **Github Enterprise Server URL**과 해당 서버에서 생성한 **Personal Access Token** 입력
      - **Username / Password**: 리포지토리를 가져올 **Github Enterprise Server URL**과 해당 서버의 **사용자 계정 정보** 입력
      - **SSH Key**: SSH 프로토콜 형식의 **Git 리포지토리 URL**과 인증을 위한 **SSH Private Key** 입력
    - **소유자**: 빌드 대상 코드가 위치한 소유자 선택
    - **리포지토리**: 빌드 대상의 코드가 저장된 리포지토리 선택
    - **브랜치**: 빌드 대상 리포지토리의 브랜치 선택
3. 알림 설정을 빌드 시작될 때와 빌드 종료되었을 때로 설정 할 수 있습니다.
  - 이벤트 발생시 통보 받을 담당자는 **[통보대상관리]** 를 클릭하여 먼저 등록해주십시오.
  - 이벤트 발생 시 통보 받을 담당자, 통보방법(SMS, Email)을 선택한 후 **[추가]** 버튼을 클릭해주십시오.
  - 설정한 담당자를 삭제하려면 **[삭제]** 버튼을 클릭하여 담당자 목록에서 삭제해 주십시오.
4. **[다음]** 버튼을 클릭해 주십시오.

              참고

              

- **GitHub/Bitbucket/Github Enterprise server** 을 선택하고 로그인할 때 로그인 페이지가 나타나지 않고 바로 로그인되었다면 브라우저에서 이미 로그인된 것입니다. 다른 계정으로 다시 로그인해야 한다면 해당 웹사이트에 직접 접속해 로그아웃한 후 다시 시도해 주십시오.
  - [GitHub 웹사이트](https://github.com)
  - [Bitbucket 웹사이트](https://bitbucket.org)

## 2. 빌드 환경 설정

선택하는 빌드 환경 이미지 유형에 따라 빌드 환경을 설정하는 방법이 다릅니다. 선택 유형에 맞는 가이드를 참고해 주십시오.

- [1. 기본 설정](/docs/sourcebuild-use-create#1-%EA%B8%B0%EB%B3%B8-%EC%84%A4%EC%A0%95)
- [2. 빌드 환경 설정](/docs/sourcebuild-use-create#2-%EB%B9%8C%EB%93%9C-%ED%99%98%EA%B2%BD-%EC%84%A4%EC%A0%95)
  - [SourceBuild에서 관리되는 이미지 사용](/docs/sourcebuild-use-create#sourcebuild%EC%97%90%EC%84%9C-%EA%B4%80%EB%A6%AC%EB%90%98%EB%8A%94-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%82%AC%EC%9A%A9)
  - [Container Registry의 이미지 사용](/docs/sourcebuild-use-create#container-registry%EC%9D%98-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%82%AC%EC%9A%A9)
  - [Public Registry의 이미지 사용](/docs/sourcebuild-use-create#public-registry%EC%9D%98-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%82%AC%EC%9A%A9)
- [3. 빌드 명령어 설정](/docs/sourcebuild-use-create#3-%EB%B9%8C%EB%93%9C-%EB%AA%85%EB%A0%B9%EC%96%B4-%EC%84%A4%EC%A0%95)
- [4. 업로드 설정](/docs/sourcebuild-use-create#4-%EC%97%85%EB%A1%9C%EB%93%9C-%EC%84%A4%EC%A0%95)
- [5. 추가 상품 연동](/docs/sourcebuild-use-create#5-%EC%B6%94%EA%B0%80-%EC%83%81%ED%92%88-%EC%97%B0%EB%8F%99)
- [6. 최종 확인](/docs/sourcebuild-use-create#6-%EC%B5%9C%EC%A2%85-%ED%99%95%EC%9D%B8)

### SourceBuild에서 관리되는 이미지 사용

SourceBuild에서 관리되는 이미지를 사용해 빌드 환경을 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_2-env-sourcebuild_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_2-env-sourcebuild_ko.png)

1. 빌드 환경 이미지로 **SourceBuild에서 관리되는 이미지**를 선택해 주십시오.
2. 빌드 환경 운영 체제를 선택해 주십시오.
  - Ubuntu 16.04 (x64) 단일 사용 가능
3. 빌드 런타임과 런타임 버전을 선택해 주십시오.
  - 사용할 수 있는 빌드 런타임 및 버전

| 빌드 런타임 | 빌드 런타임 버전 |
| --- | --- |
| Ubuntu 16.04 | Ubuntu 20.04 |
| base | 16.04-1.0.0 | 20.04-1.0.0 |
| java | 7-1.0.0 8-1.0.0 9-1.0.0 10-1.0.0 11-1.0.0 17-1.0.0 21-1.0.0 | 8-1.0.0 11-1.0.0 17-1.0.0 21-1.0.0 |
| dotnet | 1.0-1.0.0 2.0-1.0.0 2.1-1.0.0 6.0-1.0.0 | – |
| android-java | 26.1.1-8-1.0.0 26.1.1-9-1.0.0 26.1.1-10-1.0.0 | – |
| python | 2.7-1.0.0 3.5-1.0.0 3.8-1.0.0 3.9-1.0.0 3.10-1.0.0 | 3.10-1.0.0 3.11-1.0.0 3.12-1.0.0 3.13-1.0.0 |
| nodejs | 8.16-1.0.0 10.17-1.0.0 11.15-1.0.0 12.22-1.0.0 14.21-1.0.0 16.20-1.0.0 | 18.20-1.0.0 20.19-1.0.0 22.14-1.0.0 |

              참고

              

- 빌드 런타임 및 버전은 지속적으로 업데이트됩니다.
- **[설치 패키지 목록]** 버튼 클릭 시 선택한 빌드 런타임 및 버전에서 설치되는 주요 패키지 목록을 확인할 수 있습니다.

1. 도커 이미지 빌드 시 **docker build 명령어를 사용하는 경우 체크 합니다.**를 선택하고 도커 엔진 버전을 선택해 주십시오.

              참고

              

SourceBuild에서는 20.10.18 버전의 도커 엔진을 제공합니다. 선택한 컴퓨팅 유형의 50%가 도커 빌드를 위한 컴퓨팅 리소스로 별도 할당됩니다.

1. 빌드 환경의 컴퓨팅 유형을 선택해 주십시오.
  - 빌드 환경에 따라 이용 요금 상이
2. 타임 아웃 시간을 입력해 주십시오.
  - 5~540분 이내 입력
3. 추가할 환경 변수가 있다면 변수의 이름과 값을 입력하고 **[추가]** 버튼을 클릭하여 추가해 주십시오.
4. **[다음]** 버튼을 클릭해 주십시오.

### Container Registry의 이미지 사용

Container Registry에 생성된 이미지를 사용해 빌드 환경을 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_2-env-container_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_2-env-container_ko.png)

1. 빌드 환경 이미지로 **Container Registry의 이미지**를 선택해 주십시오.
2. 이미지가 저장된 레지스트리를 선택해 주십시오.
3. 사용할 도커 이미지를 선택해 주십시오.
4. 이미지의 태그를 선택해 주십시오.
5. 도커 이미지 빌드 시 **docker build 명령어를 사용하는 경우 체크 합니다.**를 선택하고 도커 엔진 버전을 선택해 주십시오.

              참고

              

SourceBuild에서는 20.10.18 버전의 도커 엔진을 제공합니다. 선택한 컴퓨팅 유형의 50%가 도커 빌드를 위한 컴퓨팅 리소스로 별도 할당됩니다.

1. 빌드 환경의 컴퓨팅 유형을 선택해 주십시오.
  - 빌드 환경에 따라 이용 요금 상이
2. 타임 아웃 시간을 입력해 주십시오.
  - 5~540분 이내 입력
3. 추가할 환경 변수가 있다면 변수의 이름과 값을 입력하고 **[추가]** 버튼을 클릭하여 추가해 주십시오.
4. **[다음]** 버튼을 클릭해 주십시오.

### Public Registry의 이미지 사용

DockerHub와 같은 퍼블릭 레지스트리에 생성된 이미지를 사용해 빌드 환경을 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_2-env-public_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_2-env-public_ko.png)

1. 빌드 환경 이미지로 **Public Registry의 이미지**를 선택해 주십시오.
2. 사용할 도커 이미지의 이름을 입력해 주십시오.
  - DokerHub에 있는 이미지는 이름만 입력
  - 그 외 이미지는 레지스트리 주소를 포함해 입력(<예시> sourcebuild.myregistry.com/sourcebuild_image)
3. 이미지의 태그를 입력해 주십시오.
  - 알파벳, 숫자, 특수문자(마침표, -, _) 사용해 80자 이내 입력
  - 첫 문자는 알파벳 또는 숫자 사용
4. 도커 이미지 빌드 시 **docker 이미지 빌드시 체크하세요.**를 선택하고 도커 엔진 버전을 선택해 주십시오.

              참고

              

SourceBuild에서는 20.10.18 버전의 도커 엔진을 제공합니다. 선택한 컴퓨팅 유형의 50%가 도커 빌드를 위한 컴퓨팅 리소스로 별도 할당됩니다.

1. 빌드 환경의 컴퓨팅 유형을 선택해 주십시오.
  - 빌드 환경에 따라 이용 요금 상이
2. 타임 아웃 시간을 입력해 주십시오.
  - 5~540분 이내 입력
3. 추가할 환경 변수가 있다면 변수의 이름과 값을 입력하고 **[추가]** 버튼을 클릭하여 추가해 주십시오.
4. **[다음]** 버튼을 클릭해 주십시오.

## 3. 빌드 명령어 설정

빌드 실행 명령어를 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_3-command_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_3-command_ko.png)

1. 빌드 실행 전, 빌드 실행 중, 빌드 실행 후에 수행할 명령어를 각각 입력해 주십시오.
  - 사용 가능한 셸(shell): `/bin/sh`
  - 여러 개의 명령어 입력 시 줄 바꿈으로 구분
  - 소스 코드의 최상위 디렉터리에서 명령어 수행
  - 빌드 순서: 프로비저닝(서버 생성) > 소스 코드 다운로드 > 빌드 전 명령어 > 빌드 명령어 > 빌드 후 명령어 > 결과물 업로드
2. 도커 이미지 빌드 설정에서 사용 여부를 선택해 주십시오.
  - 빌드 환경 설정에서 도커 이미지 빌드를 선택한 경우에만 **사용** 선택 가능
  - **Dockerfile 경로**: 소스 코드의 최상위 디렉터리부터 파일명까지의 경로 입력
    - Dockerfile 내부에서 사용되는 로컬 파일의 경로(ADD, COPY 등)는 Dockerfile 위치로부터의 상대 경로로 사용
  - **Container Registry**: 빌드한 도커 이미지를 저장할 레지스트리 선택
  - **이미지 이름**: 저장할 이미지의 이름 입력
    - 알파벳 소문자, 숫자, 특수문자(마침표, -, _) 사용해 200자 이내 입력
    - 시작과 끝 문자는 알파벳 소문자 또는 숫자 사용
    - 마침표(.) 연속 사용 불가, 특수문자(_) 연속 두 번 사용 가능
  - **이미지 태그**: 이미지 태그 입력
    - 알파벳, 숫자, 특수문자(마침표, -, _, #) 사용해 80자 이내 입력
    - 첫 문자는 알파벳, 숫자, # 사용
    - 입력된 #은 빌드 시 1부터 증가하는 숫자로 대체되며, # 연속 입력은 단일 입력으로 취급
  - **latest로 설정**: 선택 시 latest 태그를 추가로 푸시
3. **[다음]** 버튼을 클릭해 주십시오.

## 4. 업로드 설정

빌드 결과물과 완료 이미지의 저장 여부를 설정하는 방법은 다음과 같습니다.

![sourcebuild-use-create_4-upload_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-create_4-upload_ko.png)

              참고

              

빌드 프로젝트 생성 시 도커 이미지 빌드 설정과 빌드 완료 후 이미지 업로드 설정은 다음과 같은 용도로 사용합니다.

- 도커 이미지 빌드: 사용자의 Dockerfile을 기반으로 이미지를 생성한 다음 Container Registry에 업로드하는 기능입니다. 일반적인 도커 빌드에 사용됩니다.
- 빌드 완료 후 이미지 업로드: 빌드 환경을 컨테이너 이미지로 저장하여 Container Registry에 업로드하는 기능입니다. 빌드에 필요한 패키지 설치와 같은 빌드를 위한 셋업 과정이 이미지에 포함되어 있으므로 빌드 시간을 단축하고 빌드 환경을 버전별로 관리하는 데 유용합니다. 빌드 완료 후 환경을 저장하기 때문에 이전 빌드 정보가 남을 수 있으므로 사용 시 주의가 필요합니다.

Dockerfile을 사용하여 이미지를 생성할 경우, 도커 이미지 빌드 설정만 진행하면 됩니다.

1. 빌드 결과물의 Object Storage 저장 여부를 선택해 주십시오.
2. **결과물 저장**을 선택한 경우, 다음의 항목을 설정해 주십시오.
  - **빌드 결과물 경로**: 빌드 결과물이 저장될 디렉터리 경로 또는 파일 경로 입력
    - 결과물이 여러 개라면 줄 바꿈으로 구분
  - **업로드 할 Object Storage**: 결과물이 저장될 버킷 선택
  - **Object Storage 폴더 경로**: 결과물이 저장될 Object Storage의 디렉터리 경로 입력
  - **저장될 파일 이름**: `zip` 형태로 저장 시 사용될 파일 이름 입력
    - 버킷이 잠금 설정되어 있으면 버킷에 이미 저장된 파일명과 동일한 이름은 사용 불가
  - **결과물 백업**: 결과물의 백업본 저장 여부 선택
    - 백업본 저장 경로: `/sourcebuild_backup/{build-id}`
3. 빌드 완료 상태의 이미지 저장 여부를 선택해 주십시오.
4. **이미지 저장**을 선택한 경우, 다음의 항목을 설정해 주십시오.
  - **Container Registry**: 완료 이미지를 저장할 레지스트리 선택
  - **이미지 이름**: 저장할 이미지의 이름 입력
    - 알파벳 소문자, 숫자, 특수문자(마침표, -, _) 사용해 200자 이내 입력
    - 시작과 끝 문자는 알파벳 소문자 또는 숫자 사용
    - 마침표(.) 연속 사용 불가, 특수문자(_) 연속 두 번 사용 가능
  - **이미지 태그**: 이미지 태그 입력
    - 알파벳, 숫자, 특수문자(마침표, -, _, #) 사용해 80자 이내 입력
    - 첫 문자는 알파벳, 숫자, # 사용
    - 입력된 #은 빌드 시 1부터 증가하는 숫자로 대체되며, # 연속 입력은 단일 입력으로 취급
  - **latest로 설정**: 선택 시 latest 태그를 추가로 푸시
5. **[다음]** 버튼을 클릭해 주십시오.

## 5. 추가 상품 연동

새로 생성하는 빌드를 네이버 클라우드 플랫폼의 로그 서비스 및 보안 서비스와 연동할 수 있습니다. 부가 서비스 연동 시 다음과 같은 이점이 있습니다.

- SourceBuild에서는 2일 동안의 빌드 로그만 확인할 수 있으나, 로그 서비스인 Cloud Log Analystics와 연동하면 30일 동안의 빌드 로그를 Cloud Log Analytics에서 확인할 수 있습니다.
- 보안 서비스인 File Safer와 연동하면 빌드 성공 시 결과물을 File Safer에서 자동으로 검사해 결과물의 악성 코드 여부를 진단받을 수 있습니다.

              참고

              

- 서비스 연동 여부는 빌드 생성 후에도 변경 가능합니다.
- 서비스 사용량에 따라 요금이 발생할 수 있습니다. 자세한 내용은 포털의 각 서비스 소개를 참고해 주십시오.
  - [Cloud Log Analytics 소개](https://www.fin-ncloud.com/product/analytics/cloudLogAnalytics)
  - [File Safer 소개](https://www.fin-ncloud.com/product/security/fileSafer)

서비스 연동을 설정하는 방법은 다음과 같습니다.

1. Cloud Log Analytics 연동 여부를 선택해 주십시오.
2. File Safer 연동 여부를 선택해 주십시오.
  - File Safer 검사 요청이 가능한 파일 기준
    - 용량: 10MB 이하
    - 확장자: `bat`, `cmd`, `vbs`, `vbe`, `js`, `jse`, `wsf`, `wsh`, `html`, `htm`, `hta`, `jsp`, `php`, `cgi`, `ahk`, `au3`, `py`, `lsp`, `fas`, `ps`, `eps`, `gsf`, `ps1`, `sh`, `exe`, `dll`, `com`, `so`, `zip`, `tar`, `gz`, `tgz`, `rar`, `xz`, `7z`
  - 동일 해시에 대한 검사 이력이 있다면 이전 검사 결과 표시
3. **[다음]** 버튼을 클릭해 주십시오.

## 6. 최종 확인

1. 설정한 빌드 프로젝트 정보를 확인해 주십시오.
  - 설정을 수정하려면 **[이전]** 버튼 클릭
2. **[생성]** 버튼을 클릭해 주십시오.