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

> ## 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. 빌드 실행 화면이 나타나면 입력된 정보를 확인하고 필요 시 수정해 주십시오.

              참고

              

빌드 실행 화면에서 수정한 내용은 빌드를 실행할 때 한 번만 적용되며 저장되지 않습니다.

1. **[빌드 시작하기]** 버튼을 클릭해 주십시오.  

![sourcebuild-use-manage_buildstart_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-manage_buildstart_ko.png)
2. 빌드가 실행되면서 나타나는 실행 로그 및 빌드 실행 상태를 확인해 주십시오.
  - 빌드 결과 확인에 대한 자세한 내용은 [빌드 결과 확인](/docs/sourcebuild-use-manage#%EB%B9%8C%EB%93%9C%EA%B2%B0%EA%B3%BC%ED%99%95%EC%9D%B8) 참고
  - **Prepare**: 빌드 실행 중인 상태
  - **Upload**: 빌드 결과물을 저장하고 있는 상태
  - **Success**: 빌드 실행이 완료되어 최종 결과물이 저장된 상태
  - **Fail**: 빌드 실행을 실패한 상태로 **빌드 로그**에서 상세 내용 확인 가능
  - **Canceled**: 빌드 실행이 취소된 상태

### 빌드 취소

실행 중인 빌드를 취소하는 방법은 다음과 같습니다.

1. 빌드 실행 중에 화면에 나타나는 **[취소]** 버튼을 클릭해 주십시오.  

![sourcebuild-use-manage_cancel_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-manage_cancel_ko.png)
2. 빌드 상태가 **Canceled**로 표시되는지 확인해 주십시오.

              주의

              

결과물 업로드 단계에서는 빌드 실행을 취소할 수 없습니다.

## 빌드 결과 확인

빌드를 실행한 결과 및 상세 로그를 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
2. 결과를 확인하려는 빌드 프로젝트의 이름을 클릭해 주십시오.
  - 또는 빌드 프로젝트를 선택한 상태에서 **[빌드로 이동]** 버튼 클릭
3. 빌드 실행 화면이 나타나면 **[작업결과]** 탭을 클릭해 주십시오.
4. 빌드 실행 결과를 확인해 주십시오.  

![sourcebuild-use-manage_result_ko](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/sourcebuild-use-manage_result_ko.png)
  - **빌드 번호**: 빌드 실행 시 부여된 고유 번호
  - **요청자**: 빌드 실행 요청자의 계정 정보
  - **요청 시간**: 요청자가 빌드 실행을 요청한 시간
  - **완료 시간**: 빌드 실행이 완료된 시간
  - **상태**: 빌드 실행 상태
    - **Prepare**: 빌드 실행 중인 상태
    - **Upload**: 빌드 결과물을 저장하고 있는 상태
    - **Success**: 빌드 실행이 완료되어 최종 결과물이 저장된 상태
    - **Fail**: 빌드 실행을 실패한 상태로, **빌드 로그**에서 상세 내용 확인 가능
    - **Canceled**: 빌드 실행이 취소된 상태
  - **FileSafer**: 빌드 결과물의 악성 코드 검사 결과로, File Safer 연동 시 표시
  - **빌드 결과물**: **[다운로드]** 버튼을 클릭해 생성된 빌드 결과물을 `zip` 형태로 다운로드
  - **빌드 로그**: 빌드 실행 단계별 로그 확인
    - 단계별 상태가 아이콘 색상으로 표시되며, 단계마다 최대 4000줄 표시
      - 노란색: 진행 중
      - 초록색: 성공
      - 빨간색: 실패
    - 빌드 실행 중에는 자동 스크롤되어 실시간 출력되는 로그를 확인할 수 있으나, 도중에 다른 단계를 클릭하거나 수동 스크롤 시 자동 스크롤이 중지됨

### File Safer 결과 확인

SourceBuild를 File Safer와 연동한 경우 빌드 결과물의 악성 코드 검사 결과를 확인할 수 있습니다. 확인하는 방법은 다음과 같습니다.

              참고

              

File Safer 결과는 빌드 실행 상태가 **Success**이고 결과물이 정상적으로 Object Storage에 저장된 경우에만 확인할 수 있습니다.

1. 작업 결과 목록에서 **FileSafer** 열의 ![i-sourcebuild_filesafer](https://cdn.document360.io/0406ed95-101f-4cde-8dd8-308d03444a94/Images/Documentation/i-sourcebuild_filesafer.png)을 클릭해 주십시오.
2. File Safer 결과 확인 팝업 창에서 File Safer 검사 결과를 확인해 주십시오.

## 빌드 설정 변경

생성한 빌드 프로젝트에 대한 설정을 변경할 수 있습니다. 설정을 변경하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
2. 설정을 변경할 프로젝트를 선택한 후 **[설정 변경]** 버튼을 클릭해 주십시오.
3. 빌드 프로젝트 설정 화면이 나타나면 다음과 같이 구분되는 설정들을 원하는 대로 변경하고 **[적용]** 버튼을 클릭해 주십시오.
  - [기본 정보](/docs/sourcebuild-use-manage#%EA%B8%B0%EB%B3%B8%EC%A0%95%EB%B3%B4)
  - [빌드 환경](/docs/sourcebuild-use-manage#%EB%B9%8C%EB%93%9C%ED%99%98%EA%B2%BD)
  - [빌드 명령어](/docs/sourcebuild-use-manage#%EB%B9%8C%EB%93%9C%EB%AA%85%EB%A0%B9%EC%96%B4)
  - [빌드 결과물 업로드](/docs/sourcebuild-use-manage#%EB%B9%8C%EB%93%9C%EA%B2%B0%EA%B3%BC%EB%AC%BC%EC%97%85%EB%A1%9C%EB%93%9C)
  - [빌드 완료 후 이미지 업로드](/docs/sourcebuild-use-manage#%EB%B9%8C%EB%93%9C%EC%99%84%EB%A3%8C%ED%9B%84%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%97%85%EB%A1%9C%EB%93%9C)
  - [부가 서비스 연동](/docs/sourcebuild-use-manage#%EB%B6%80%EA%B0%80%EC%84%9C%EB%B9%84%EC%8A%A4%EC%97%B0%EB%8F%99)

### 기본 정보

생성한 빌드 프로젝트에 대한 기본 정보를 변경할 수 있습니다.

- **빌드 프로젝트 이름**: 빌드 프로젝트의 이름이며 수정 불가
- **빌드 프로젝트 설명**: 빌드 프로젝트에 대한 설명으로 500자 이내 입력
- **빌드 대상**: 빌드 대상 유형을 선택한 후 세부 항목 설정
  - **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, Passphrase** 입력 (Passphrase는 SSH Key 에 Passphrase 설정한 경우에 입력해주십시오.)
    - **소유자**: 빌드 대상 코드가 위치한 소유자 선택
    - **리포지토리**: 빌드 대상의 코드가 저장된 리포지토리 선택
    - **브랜치**: 빌드 대상 리포지토리의 브랜치 선택

              참고

              

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

### 빌드 환경

선택한 빌드 환경 이미지에 따라 변경할 수 있는 빌드 환경 정보가 다릅니다. 선택 유형에 맞는 가이드를 참고해 주십시오.

- [SourceBuild 이미지 선택 시 설정 변경](/docs/sourcebuild-use-manage#SourceBuild%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%84%A0%ED%83%9D%EC%8B%9C%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD)
- [Container Registry 이미지 선택 시 설정 변경](/docs/sourcebuild-use-manage#ContainerRegistry%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%84%A0%ED%83%9D%EC%8B%9C%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD)
- [Public Registry 이미지 선택 시 설정 변경](/docs/sourcebuild-use-manage#PublicRegistry%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%84%A0%ED%83%9D%EC%8B%9C%EC%84%A4%EC%A0%95%EB%B3%80%EA%B2%BD)

#### SourceBuild 이미지 선택 시 설정 변경

**SourceBuild에서 관리되는 이미지**를 선택한 경우 다음의 설정을 변경할 수 있습니다.

- **운영 체제**: 빌드 환경 운영 체제로 Ubuntu 16.04 (x64) 단일 선택
- **컴퓨팅 유형**: 빌드 환경의 컴퓨팅 유형, 빌드 환경에 따라 이용 요금 상이
- **빌드 런타임**: 빌드 런타임 선택
- **빌드 런타임 버전**: 선택된 빌드 런타임의 버전 선택
  - 사용할 수 있는 빌드 런타임 및 버전

| 빌드 런타임 | 빌드 런타임 버전 |
| --- | --- |
| 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 |

              참고

              

빌드 런타임 및 버전은 지속적으로 업데이트됩니다.

- **타임 아웃**: 타임 아웃 시간 입력
- **환경 변수**: **[환경변수 보기]** 버튼을 클릭해 추가할 환경 변수의 이름과 값 추가
- **설치 패키지 목록**: **[목록보기]** 버튼을 클릭해 선택한 빌드 런타임 및 버전에서 설치되는 주요 패키지 목록 확인
- **도커 이미지 빌드**: 도커 이미지 빌드 시 선택
- **도커 엔진 버전**: **도커 이미지 빌드** 선택 시 표시되며 SourceBuild에서 제공되는 20.10.18 버전의 도커 엔진 선택

#### Container Registry 이미지 선택 시 설정 변경

**Container Registry의 이미지**를 선택한 경우 다음의 설정을 변경할 수 있습니다.

- **레지스트리**: 이미지가 저장된 레지스트리 선택
- **이미지**: 레지스트리 내 사용할 이미지 선택
- **태그**: 사용할 이미지의 태그 선택
- **컴퓨팅 유형**: 빌드 환경의 컴퓨팅 유형, 빌드 환경에 따라 이용 요금 상이
- **타임 아웃**: 타임 아웃 시간 입력
- **환경 변수**: **[환경변수 보기]** 버튼을 클릭해 추가할 환경 변수의 이름과 값 추가
- **도커 이미지 빌드**: 도커 이미지 빌드 시 항목 선택
- **도커 엔진 버전**: **도커 이미지 빌드** 항목 선택 시 표시되며 SourceBuild에서 제공되는 20.10.18 버전의 도커 엔진 선택

#### Public Registry 이미지 선택 시 설정 변경

**Public Registry의 이미지**를 선택한 경우 다음의 설정을 변경할 수 있습니다.

- **이미지**: 사용할 이미지의 이름을 입력, DockerHub 이미지는 이름만 입력하며 그 외 이미지는 레지스트리 주소를 포함해 입력
- **태그**: 사용할 이미지의 태그 입력
  - 알파벳, 숫자, 특수문자(마침표, -, _) 사용해 80자 이내 입력
  - 첫 문자는 알파벳 또는 숫자 사용
- **컴퓨팅 유형**: 빌드 환경의 컴퓨팅 유형, 빌드 환경에 따라 이용 요금 상이
- **타임 아웃**: 타임 아웃 시간 입력
- **환경 변수**: **[환경변수 보기]** 버튼을 클릭해 추가할 환경 변수의 이름과 값 추가
- **도커 이미지 빌드**: 도커 이미지 빌드 시 선택
- **도커 엔진 버전**: **도커 이미지 빌드** 선택 시 표시되며 SourceBuild에서 제공되는 20.10.18 버전의 도커 엔진 선택

### 빌드 명령어

**[명령어 보기]** 버튼을 클릭해 빌드 실행 명령어를 변경할 수 있습니다.

              참고

              

- 명령어 스크립트는 `/bin/sh` 셸(shell)을 사용할 수 있습니다.
- 여러 개의 명령어는 줄 바꿈으로 구분할 수 있습니다.
- 입력되는 명령어는 소스 코드의 최상위 디렉터리에서 수행됩니다.

- **빌드 전 명령어**: 빌드 실행 전 수행할 명령어 입력
- **빌드 명령어**: 빌드 실행 중 수행할 명령어 입력
- **빌드 후 명령어**: 빌드 실행 후 수행할 명령어 입력
- **도커 이미지 빌드 설정**: 도커 이미지 빌드 시 **사용** 선택
  - 빌드 환경 설정에서 도커 이미지 빌드를 선택한 경우에만 **사용** 선택 가능
  - **Dockerfile 경로**: 소스 코드의 최상위 디렉터리부터 파일명까지의 경로 입력
    - Dockerfile 내부에서 사용되는 로컬 파일의 경로(ADD, COPY 등)는 Dockerfile 위치로부터의 상대 경로로 사용
  - **Container Registry**: 빌드한 도커 이미지를 저장할 레지스트리 선택
  - **이미지 이름**: 저장할 이미지의 이름 입력
    - 알파벳 소문자, 숫자, 특수문자(마침표, -, _) 사용해 200자 이내 입력
    - 시작과 끝 문자는 알파벳 소문자 또는 숫자 사용
    - 마침표(.) 연속 사용 불가, 특수문자(_) 연속 두 번 사용 가능
  - **이미지 태그**: 이미지 태그 입력
    - 알파벳, 숫자, 특수문자(마침표, -, _, #) 사용해 80자 이내 입력
    - 첫 문자는 알파벳, 숫자, # 사용
    - 입력된 #은 빌드 시 1부터 증가하는 숫자로 대체되며, # 연속 입력은 단일 입력으로 취급
  - **latest로 설정**: 선택 시 latest 태그를 추가로 푸시

### 빌드 결과물 업로드

**결과물 저장**을 선택한 경우 다음의 설정을 변경할 수 있습니다.

- **빌드 결과물 경로**: **[경로 보기]** 버튼을 클릭해 결과물이 저장될 디렉터리 경로 또는 파일 경로 입력
  - 결과물이 여러 개라면 줄 바꿈으로 구분
- **업로드 할 Object Storage**: 결과물이 저장될 버킷 선택
- **Object Storage 폴더 경로**: 결과물이 저장될 Object Storage의 디렉터리 경로 입력
- **저장될 파일 이름**: `zip` 형태로 저장 시 사용될 파일 이름 입력
  - 버킷이 잠금 설정되어 있으면 버킷에 이미 저장된 파일명과 동일한 이름은 사용 불가
- **결과물 백업**: 결과물의 백업본 저장 여부 선택
  - 백업본 저장 경로: `/sourcebuild_backup/{build-id}`

### 빌드 완료 후 이미지 업로드

**이미지 저장**을 선택한 경우 다음의 설정을 변경할 수 있습니다.

- **Container Registry**: 완료 이미지를 저장할 레지스트리 선택
- **이미지 이름**: 저장할 이미지의 이름 입력
  - 알파벳 소문자, 숫자, 특수문자(마침표, -, _) 사용해 200자 이내 입력
  - 시작과 끝 문자는 알파벳 소문자 또는 숫자 사용
  - 마침표(.) 연속 사용 불가, 특수문자(_) 연속 두 번 사용 가능
- **이미지 태그**: 이미지 태그 입력
  - 알파벳, 숫자, 특수문자(마침표, -, _, #) 사용해 80자 이내 입력
  - 첫 문자는 알파벳, 숫자, # 사용
  - 입력된 #은 빌드 시 1부터 증가하는 숫자로 대체되며, # 연속 입력은 단일 입력으로 취급
- **latest로 설정**: 선택 시 latest 태그를 추가로 푸시

### 부가 서비스 연동

생성한 빌드 프로젝트에 부가 서비스를 연동할 수 있습니다.

- **File Safer (File Filter) 연동**: 빌드 결과물의 악성 코드 여부를 진단하는 File Safer와의 연동 여부 선택
- **Cloud Log Analytics 연동**: 빌드 로그를 30일 동안 확인할 수 있는 Cloud Log Analytics와의 연동 여부 선택

              참고

              

서비스 사용량에 따라 요금이 발생할 수 있습니다. 자세한 내용은 포털의 각 서비스 소개를 참고해 주십시오.

- [File Safer 소개](https://www.fin-ncloud.com/product/security/fileSafer)
- [Cloud Log Analytics 소개](https://www.fin-ncloud.com/product/analytics/cloudLogAnalytics)

## 빌드 삭제

생성한 빌드 프로젝트를 삭제할 수 있습니다. 삭제하는 방법은 다음과 같습니다.

              참고

              

삭제된 빌드 프로젝트는 복구할 수 없습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Developer Tools** > **SourceBuild** 메뉴를 차례대로 클릭해 주십시오.
2. 삭제할 프로젝트를 선택한 후 **[삭제]** 버튼을 클릭해 주십시오.
3. 빌드 프로젝트 삭제 팝업 창이 나타나면 **[삭제]** 버튼을 클릭해 주십시오.