목차

시작하기 전에

SourceBuild에서 생성한 빌드 프로젝트는 네이버 클라우드 플랫폼 콘솔에서 확인할 수 있습니다.

  • 빌드 프로젝트를 생성 및 삭제할 수 있습니다.
  • 빌드 프로젝트를 사용할 서브 계정을 추가하고 권한을 변경할 수 있습니다.
  • 빌드 프로젝트의 상세 설정 정보를 확인할 수 있습니다.
  • 빌드를 시작할 수 있습니다.
  • 빌드 프로젝트의 빌드 작업 결과 및 빌드 로그를 확인할 수 있습니다.

SourceBuild는 빌드 프로젝트별로 사용자 접근 권한을 부여할 수 있으며, 다음과 같은 권한을 부여할 수 있습니다.

모든 권한

해당 권한은 고객 계정이 Management > Sub Account 메뉴에서 서브 계정에게 부여할 수 있습니다. Sub Account 이용안내 바로가기

1. 고객 계정

  • 고객 계정은 SourceBuild의 모든 기능을 제약 없이 사용할 수 있습니다.
  • 콘솔에서 '빌드 프로젝트 생성' 및 모든 프로젝트의 '설정 변경', 모든 프로젝트를 삭제할 수 있으며, 모든 프로젝트의 빌드를 수행할 수 있습니다.

2. NCP_INFRA_MANAGER

  • 고객 계정과 동일한 권한을 갖는 Sub Account로 고객 계정과 동일하게 SourceBuild의 모든 기능을 제약없이 사용할 수 있습니다.

빌드 프로젝트 생성 권한

해당 권한은 고객 계정이 Management > Sub Account 메뉴에서 서브 계정에게 부여할 수 있습니다. Sub Account 이용안내 바로가기

1. NCP_SOURCE_BUILD_MANAGER

  • 콘솔에서 '빌드 프로젝트 생성' 기능을 통해 빌드 프로젝트를 생성할 수 있고, 자신이 생성한 빌드 프로젝트를 관리하고 다른 서브 계정에 공유할 수 있습니다.

  • NCP_SOURCE_BUILD_MANGER 권한 부여하기

    devtools-3-1-2

    ① 서브 계정에 NCP_SOURCE_BUILD_MANAGER 권한을 부여하기 위해서는 Sub Account 메뉴의 Sub Accounts를 선택합니다.

    ② 부여할 서브 계정을 선택합니다.

    devtools-3-1-3

    ① 정책 탭에서 추가 버튼을 클릭합니다.

    devtools-3-1-4

    ① 정책 추가 팝업창에서 NCP_SOURCE_BUILD_MANAGER 정책을 추가합니다.

    추가 버튼을 클릭하여 적용합니다.

빌드 프로젝트 사용 권한

다음 권한은 Sub Account에게 부여하는 빌드 프로젝트별 사용 권한입니다.

해당 권한은 모든 권한(고객계정, NCP_INFRA_MANAGER)을 소유한 사용자 또는 해당 프로젝트의 ADMIN 권한을 소유한 사용자가 SourceBuild에서 빌드 프로젝트를 공유할 서브 계정에게 부여하는 권한입니다.

  1. ADMIN

    • 해당 빌드 프로젝트의 설정 변경, 삭제 권한을 포함합니다.
    • 해당 빌드 프로젝트의 빌드 실행 권한을 포함합니다.
    • 해당 빌드 프로젝트에 Sub Account를 할당하고 권한을 부여할 수 있습니다.
    • 해당 빌드 프로젝트를 생성한 계정은 자동으로 ADMIN 권한이 부여됩니다.
  2. USER

    • 해당 빌드 프로젝트의 실행 권한을 포함합니다.

가입 절차

SourceBuild 상품을 사용하려면 네이버 클라우드 플랫폼[Financial]에서 제공하는 콘솔 및 리소스등을 이용하기 위해 네이버 클라우드 플랫폼의 계정이 필요합니다.

네이버 클라우드 플랫폼[Financial]에 가입하면 모든 서비스들을 이용하실 수 있으며, 사용한 서비스에 대해서만 요금이 청구됩니다. 이미 계정이 있는 경우에는 해당 단계를 건너뛸 수 있습니다.

  • 포털로 이동합니다.
  • 오른쪽 상단에 회원가입 버튼을 클릭하여 회원가입 페이지로 이동합니다.
  • 서비스 이용 약관 및 개인정보수집이용에 대한 안내 문구를 확인하고 동의합니다.
  • 법인 및 담당자 정보를 입력합니다.
  • 결제수단은 직접입금과 자동이체를 선택하실 수 있습니다.
  • 가입한 ID/PW를 통해 로그인하고 결제수단 선택 및 등록을 완료합니다.
  • 담당자의 가입정보 및 금융회원여부 검증 후 승인이 완료되면 SSL VPN 계정이 발급되어 메일로 전송됩니다.
  • SSL VPN Client 접속 툴을 설치하고 실행하여, 발급된 SSL VPN 계정으로 로그인합니다.
  • Financial 콘솔은 Financial 포털에 로그인하여 Console 버튼을 클릭하거나, 도메인(www.gov-ncloud.com)을 직접 입력하여 접속 후 사용가능합니다.

포털에서 가입한 계정으로 콘솔에서도 동일하게 사용이 가능합니다.

네이버 클라우드 플랫폼[Financial] 상품을 사용하기 위해서는 반드시 SSL VPN 접속을 통해 이용가능합니다.

빌드 프로젝트 생성하기

Step 1. 콘솔 접속

콘솔에서 Dev Tools > SourceBuild 메뉴로 접속합니다.

devtools-3-1-1

devtools-3-1-5

① 콘솔 화면 좌측 메뉴바의 All Products를 클릭합니다.

② 화면 중앙에 나타나는 상품들 중 Dev Tools > SourceBuild를 클릭합니다.

빌드 프로젝트 생성 버튼을 클릭하여 새로운 빌드 프로젝트를 생성합니다.

  • 빌드 프로젝트를 생성하기 위해서는 로그인한 계정이 고객 계정이거나, NCP_INFRA_MANAGER, NCP_SOURCE_BUILD_MANAGER 권한을 가지고 있는 서브 계정이어야 합니다.
  • NCP_INFRA_MANAGER, NCP_SOURCE_BUILD_MANAGER 권한은 콘솔의 Management > Sub Account 메뉴에서 할당할 수 있습니다.

Step 2. 필수 준비 사항

빌드 프로젝트 생성에 필요한 필수 준비 사항을 확인합니다. 빌드 결과물을 저장하기 위해서 Object Storage 상품을 필수적으로 사용하셔야 합니다.

devtools-3-1-6

① 빌드 프로젝트 생성 전 Object Storage 상품 사용 여부를 확인하고, 미사용 중일 경우 토글 버튼을 클릭하여 Object Storage 상품 신청을 완료합니다.

다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 3. 기본 설정

빌드 프로젝트 이름, 설명, 빌드 대상 리파지토리를 선택하여 기본 설정을 합니다.

devtools-3-1-7

① 빌드 프로젝트 이름을 입력합니다.

  • 이전에 생성된 프로젝트와 동일한 이름의 프로젝트는 생성할 수 없습니다.
  • 프로젝트 이름은 알파벳, 숫자, 특수문자(-, _)만 포함할 수 있습니다.

② 빌드 프로젝트 설명을 입력합니다.

  • 최대 500자까지 가능합니다.

③ 빌드 대상을 선택합니다.

  • 빌드 대상은 SourceCommit 혹은 GitHub 을 선택할 수 있습니다.

빌드 대상 항목을 GitHub 선택시, GitHub과 연동하여 GitHub에 있는 코드를 빌드할 수 있습니다.

연동 방법은 부가 기능 항목을 참조하세요.

④ 빌드 대상 리파지토리를 선택합니다.

  • SourceCommit 선택시 소유하신 리파지토리 리스트가 노출됩니다.

⑤ 빌드 대상 리파지토리의 브랜치를 선택합니다.

  • 선택한 SourceCommit 리파지토리의 브랜치 리스트가 노출됩니다.

다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 4. 빌드 환경 및 명령어 설정

프로비저닝 될 빌드 환경 및 빌드 명령어를 설정합니다.

devtools-3-1-8

빌드 환경 설정하기

① 빌드 환경 이미지가 위치한 레지스트리 종류를 선택합니다.

  • SourceBuild에서 관리되는 이미지 / Container Registry의 이미지 / Public Registry의 이미지를 선택할 수 있습니다.

Container Registry 또는 Public Registry에 있는 커스텀 이미지를 사용하여 빌드 환경을 구축할 수 있습니다.

커스텀 이미지 환경에서 빌드 환경을 생성하는 방법은 부가 기능 항목을 참조하세요.

② 빌드 환경의 운영체제를 선택합니다.

  • Ubuntu 16.04 (x64) 버전을 제공합니다.

③ 미리 구성된 빌드 런타임을 선택합니다.

④ 선택한 빌드 런타임의 버전을 선택합니다. 다음 빌드 런타임 및 런타임 버전을 제공합니다.

  • 빌드 런타임 및 버전은 지속적으로 업데이트될 예정입니다.
빌드 런타임 빌드 런타임 버전
base 16.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
dotnet 1.0-1.0.0
2.0-1.0.0
2.1-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

⑤ 선택한 빌드 런타임 및 버전의 빌드 환경에 설치되는 주요 패키지 목록을 확인할 수 있습니다.

⑥ 도커 이미지 빌드

  • 도커 이미지 빌드가 필요한 경우 체크 합니다.

도커 이미지 빌드가 필요한 경우, SourceBuild 에서 도커 엔진을 제공합니다.

도커 빌드를 위한 컴퓨팅 리소스가 따로 할당되며, 선택하신 컴퓨팅 유형의 50%가 도커 빌드를 위한 컴퓨팅 리소스로 할당됩니다.

⑦ 도커 엔진 버전

  • 18.09.01 버전의 도커 엔진을 제공합니다.

⑧ 빌드 환경의 컴퓨팅 유형을 선택합니다.

  • 2vCPU 4GB 메모리, 4vCPU 8GB 메모리, 8vCPU 16GB 메모리를 제공합니다.
  • 빌드 환경에 따라 이용 요금이 상이합니다.

⑨ 빌드 타임아웃을 설정합니다.

  • 최소 5분, 최대 540분까지 설정할 수 있습니다.

⑩ 빌드 환경의 환경변수를 등록합니다.

빌드 명령어 설정하기

devtools-3-1-9

① 빌드 전 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.

② 빌드 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.

③ 빌드 후 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.

  • 빌드 순서는 다음과 같습니다.

    • 프로비저닝 (서버 생성)
    • 소스코드 다운로드
    • 빌드 전 명령어
    • 빌드 명령어
    • 빌드 후 명령어
    • 결과물 업로드

다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 5. 업로드 설정

빌드 결과물 및 빌드 완료 후 이미지 업로드를 위한 설정을 진행합니다.

결과물 업로드 설정하기

devtools-3-1-10

① 빌드 결과물 저장 여부를 선택합니다.

② 빌드 후 결과물이 생성되는 위치를 작성합니다.

  • 결과물이 여러 개일 경우에는 줄바꿈(엔터)로 구분합니다. 디렉토리명 파일명 모두 가능합니다.

③ 결과물이 저장될 Object Storage의 리전 및 버킷을 선택합니다.

④ 결과물이 저장될 Object Storage의 디렉토리 경로를 입력합니다.

⑤ 결과물이 저장될 파일명을 입력합니다.

결과물은 zip으로 압축하여 저장되며, 파일명에 .zip 확장자가 없을 경우 자동으로 .zip 확장자를 추가하여 저장합니다.

⑥ 결과물 백업 사용 여부를 선택합니다.

  • 결과물을 누적하여 저장하고 싶을 경우 해당 옵션으로 결과물을 누적하여 저장할 수 있습니다.
  • 백업 결과물의 위치는 /sourcebuild_backup/{build-id} 경로에 저장됩니다.

빌드 완료 후 이미지 업로드 설정하기

devtools-3-1-11

① 빌드가 완료된 상태의 환경을 이미지로 저장합니다.

  • 빌드가 완료된 상태의 이미지를 Container Registry에 저장할 수 있습니다.
  • 이후 빌드시 해당 이미지를 사용하면 빌드 환경에 따라 빌드 시간을 단축시킬 수 있습니다.

② 빌드 완료 후 이미지를 저장할 Container Registry의 리전 및 레지스트리를 선택합니다.

③ 저장할 이미지 이름을 작성합니다.

  • 이미지 이름의 규칙은 아래와 같습니다.
    • 소문자 알파벳, 숫자, 특수문자(._-) 만 허용됩니다.
    • .은 연속으로 사용할 수 없으며, _ 는 연속해서 두번까지만 허용됩니다.
    • 시작 문자와 끝 문자는 소문자 알파벳, 숫자만 허용됩니다.
    • 최대 200자 까지 허용됩니다.

④ 태그명을 작성합니다.

  • 태그명 규칙은 아래와 같습니다.
    • 대소문자 알파벳, 숫자, 특수문자(#._-)만 허용됩니다.
    • 최대 80자 까지 허용됩니다.

태그명에서 #은 1부터 자동으로 증가하는 숫자로 채워지는 특수 문자입니다.

빌드 성공시마다 1씩 증가하여 숫자로 채워집니다.

연속된 #은 하나의 #과 동일하게 취급됩니다. (## -> #)

예) 1.0.#

⑤ 다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 6. 상품 연동

SourceBuild 상품과 부가적으로 연동하여 사용할 상품을 선택합니다.

devtools-3-1-12

① Cloud Log Analytics 상품 연동

  • SourceBuild 상품에서 빌드 시 발생하는 로그는 24시간 이후 삭제되어 24시간이 지난 빌드 로그는 확인하실 수 없습니다.
  • Cloud Log Analytics 상품과 연동을 하면 빌드 로그를 Cloud Log Analytics에 저장하여 30일간 저장할 수 있습니다.

② File Safer 상품 연동

  • File Safer는 파일의 악성코드를 진단해 주는 서비스입니다.

  • File Safer (File Filter) 상품과 연동을 하면 빌드 성공 시 자동으로 결과물을 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

다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 7. 사용자 공유

해당 프로젝트를 함께 사용할 사용자를 공유합니다.

devtools-3-1-13

① 해당 프로젝트를 함께 사용할 Sub Account를 추가합니다.

  • 등록한 Sub Account에는 다음의 권한을 할당할 수 있습니다.
    • ADMIN: 해당 프로젝트의 설정 변경, 공유사용자 변경 및 권한 수정, 삭제가 가능하며 빌드를 실행할 수 있습니다.
    • USER: 해당 프로젝트의 빌드를 실행할 수 있습니다.

다음 버튼을 클릭하여 다음 단계로 이동합니다.

Step 8. 최종 확인 및 빌드 프로젝트 생성

빌드 프로젝트 설정을 최종 확인하고 빌드 프로젝트를 생성합니다.

devtools-3-1-14

① 프로젝트 설정을 최종적으로 확인하고 생성 버튼을 클릭하여 빌드 프로젝트를 생성합니다.

Step 9. 빌드 프로젝트 생성 완료 및 빌드 페이지로 이동

빌드 프로젝트 생성이 완료되면 생성된 프로젝트가 리스트에 노출되며 빌드 페이지로 이동할 수 있습니다.

devtools-3-1-15

① 빌드 프로젝트 생성이 완료되면 생성된 프로젝트가 리스트에 노출되며, 간단한 프로젝트 정보를 확인할 수 있습니다.

② 해당 빌드 프로젝트의 빌드를 실행하기 위해 "빌드 페이지로 이동" 버튼을 클릭하거나 혹은 프로젝트 이름을 클릭하여 빌드 실행 페이지로 이동할 수 있습니다.

빌드 실행하기

콘솔에서 생성된 빌드 프로젝트 선택 후 "빌드 페이지로 이동" 버튼을 클릭하거나 혹은 프로젝트 이름을 클릭하여 빌드 실행 페이지로 이동할 수 있습니다.

빌드로 이동하기

콘솔에서 생성된 빌드 프로젝트 선택 후 "빌드 페이지로 이동" 버튼을 클릭하거나 혹은 프로젝트 이름을 클릭하여 빌드 실행 페이지로 이동합니다.

devtools-3-1-16

빌드 시작하기

devtools-3-1-17

① 빌드를 시작하기 전에 기본적인 빌드 설정을 수정할 수 있습니다. 수정된 빌드 설정은 저장되지 않으며, 현재 빌드에서 한번만 적용됩니다.

② 빌드 시작하기 버튼을 클릭하여 빌드를 시작할 수 있습니다.

빌드 실행 로그 보기

빌드를 실행하면 자동으로 작업결과 탭으로 이동하며 생성된 빌드의 로그를 보여줍니다.

devtools-3-1-18

① 작업 결과 탭으로 이동을 하면 해당 빌드 프로젝트의 빌드 이력을 확인하실 수 있으며, 빌드 로그를 확인할 수 있습니다.

  • 빌드 시작하기 버튼을 클릭하여 빌드를 시작할 경우, 자동으로 작업결과 탭으로 이동하여 현재 빌드 로그를 출력해 줍니다.

② 빌드 단계별 상태를 확인하실 수 있습니다.

  • 상태별 아이콘 색상은 다음과 같습니다.
    • 녹색: 성공
    • 노란색: 진행중
    • 붉은색: 실패
  • 빌드 시작하기 버튼을 클릭하여 이동하였을 경우, 현재 빌드 단계에 따라 자동으로 빌드 단계가 변경되어 실시간으로 빌드 로그를 보여 줍니다.
  • 만약 수동으로 다른 빌드 이력을 확인하거나, 빌드 단계를 변경하였을 경우 빌드 단계가 변경되는 기능은 중지됩니다.

③ 현재 선택된 빌드 단계의 로그가 출력됩니다.

  • 로그는 최대 4000 라인까지 표시됩니다.

  • 빌드 시작하기 버튼을 클릭하여 이동하였을 경우, 빌드 로그는 자동으로 스크롤되어 최신 로그를 실시간으로 보여줍니다.

  • 만약 수동으로 다른 빌드 이력을 확인하거나, 빌드 단계를 변경하였을 경우 자동 스크롤 기능은 중지됩니다.

  • 빌드 로그를 통해 빌드 실패 원인 등을 자세히 확인하실 수 있습니다.

빌드 취소하기

실행 중인 빌드를 즉시 취소할 수 있습니다.

devtools-3-1-19

① 실행 중인 빌드를 취소 버튼을 클릭하여 즉시 빌드를 중지 할 수 있습니다.

  • 빌드 취소가 가능한 단계는 다음과 같으며, 결과물 업로드 단계에서는 빌드를 취소할 수 없습니다.

    • 빌드 준비 단계, 빌드 전 명령어 단계, 빌드 명령어 단계, 빌드 후 명령어 단계

devtools-3-1-20

① 빌드가 취소되면 상태는 canceled로 표시되며 즉시 빌드가 중지 됩니다.

File Safer 연동시 결과 보기

SourceBuild가 File Safer와 연동되어 있을 경우, 개발자 포털에서 File Safer 검사 결과를 확인할 수 있습니다.

devtools-3-1-21

① 작업 결과 리스트의 FileSafer 컬럼의 아이콘을 클릭하면 File Safer 검사 결과를 확인할 수 있습니다.

  • File Safer 검사를 위해서는 다음과 같은 조건이 만족되어야 합니다.

    • 해당 빌드 프로젝트가 File Safer와 연동 설정이 되어 있어야 합니다.
    • 빌드 결과물이 있으며, 오브젝트 스토리지에 저장되어야 합니다.
    • 빌드가 성공해야 합니다.

빌드 프로젝트 설정 변경하기

네이버 클라우드 플랫폼 콘솔에서 빌드 프로젝트의 설정을 변경할 수 있습니다.

step 1. 빌드 프로젝트 선택

devtools-3-1-22

① 빌드 프로젝트 리스트에서 설정 변경이 필요한 프로젝트를 선택하고 설정 변경 버튼을 클릭하여 설정 변경 페이지로 이동합니다.

  • 빌드 프로젝트의 설정 변경을 위해서는 다음의 권한이 있어야 합니다.

    • 고객 계정

    • 혹은, NCP_INFRA_MANAGER 권한을 소유

    • 혹은, 선택한 프로젝트의 ADMIN 권한을 소유

step 2. 빌드 프로젝트 설정 변경

devtools-3-1-23

빌드 프로젝트 이름은 변경할 수 없습니다.

② 빌드 프로젝트 설명을 입력합니다.

  • 최대 500자까지 가능합니다.

③ 빌드 대상을 선택합니다.

  • 빌드 대상은 SourceCommit 혹은 GitHub 을 선택할 수 있습니다.

빌드 대상 항목을 GitHub 선택시, GitHub과 연동하여 GitHub에 있는 코드를 빌드할 수 있습니다.

연동 방법은 부가 기능 항목을 참조하세요.

④ 빌드 대상 리파지토리를 선택합니다.

  • SourceCommit 선택시 소유하신 리파지토리 리스트가 노출됩니다.

⑤ 빌드 대상 리파지토리의 브랜치를 선택합니다.

  • 선택한 SourceCommit 리파지토리의 브랜치 리스트가 노출됩니다.

⑥ 빌드 환경 이미지가 위치한 레지스트리 종류를 선택합니다.

  • SourceBuild에서 관리되는 이미지 / Container Registry의 이미지 / Public Registry의 이미지를 선택할 수 있습니다.

Container Registry 또는 Public Registry에 있는 커스텀 이미지를 사용하여 빌드 환경을 구축할 수 있습니다.

커스텀 이미지 환경에서 빌드 환경을 생성하는 방법은 부가 기능 항목을 참조하세요.

⑦ 빌드 환경의 운영체제를 선택합니다.

  • Ubuntu 16.04 (x64) 버전을 제공합니다.

⑧ 빌드 환경의 컴퓨팅 유형을 선택합니다.

  • 2vCPU 4GB 메모리, 4vCPU 8GB 메모리, 8vCPU 16GB 메모리를 제공합니다.
  • 빌드 환경에 따라 이용 요금이 상이합니다.

⑨ 미리 구성된 빌드 런타임을 선택합니다.

⑩ 선택한 빌드 런타임의 버전을 선택합니다. 다음 빌드 런타임 및 런타임 버전을 제공합니다.

  • 빌드 런타임 및 버전은 지속적으로 업데이트될 예정입니다.
빌드 런타임 빌드 런타임 버전
base 16.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
dotnet 1.0-1.0.0
2.0-1.0.0
2.1-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

⑪ 빌드 타임아웃을 설정합니다.

  • 최소 5분, 최대 540분까지 설정할 수 있습니다.

⑫ 도커 이미지 빌드

  • 도커 이미지 빌드가 필요한 경우 체크 합니다.

도커 이미지 빌드가 필요한 경우, SourceBuild 에서 도커 엔진을 제공합니다.

도커 빌드를 위한 컴퓨팅 리소스가 따로 할당되며, 선택하신 컴퓨팅 유형의 50%가 도커 빌드를 위한 컴퓨팅 리소스로 할당됩니다.

⑬ 도커 엔진 버전

  • 18.09.01 버전의 도커 엔진을 제공합니다.

⑭ 빌드 전 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.

⑮ 빌드 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.

⑯ 빌드 후 명령어를 작성합니다. 여러 개의 명령어는 줄바꿈(엔터)로 구분합니다.

  • 명령어가 실행되는 위치는 소스코드의 최상위 디렉토리입니다.
  • 빌드 순서는 다음과 같습니다.
    • 프로비저닝 (서버 생성)
    • 소스코드 다운로드
    • 빌드 전 명령어
    • 빌드 명령어
    • 빌드 후 명령어
    • 결과물 업로드

⑰ 빌드 환경의 환경변수를 등록합니다.

devtools-3-1-24

① 빌드 결과물 저장 여부를 선택합니다.

② 빌드 후 결과물이 생성되는 위치를 작성합니다.

  • 결과물이 여러 개일 경우에는 줄바꿈(엔터)로 구분합니다. 디렉토리명 파일명 모두 가능합니다.

③ 결과물이 저장될 Object Storage의 리전을 선택합니다.

④ 결과물이 저장될 Object Storage의 버킷을 선택합니다.

⑤ 결과물이 저장될 Object Storage의 디렉토리 경로를 입력합니다.

⑥ 결과물이 저장될 파일명을 입력합니다.

  • 결과물은 zip으로 압축하여 저장되며, 파일명에 .zip 확장자가 없을 경우 자동으로 .zip 확장자를 추가하여 저장합니다.

⑦ 결과물 백업 사용 여부를 선택합니다.

  • 결과물을 누적하여 저장하고 싶을 경우 해당 옵션으로 결과물을 누적하여 저장할 수 있습니다.
  • 백업 결과물의 위치는 /sourcebuild_backup/{build-id} 경로에 저장됩니다.

⑧ 빌드가 완료된 상태의 환경을 이미지로 저장합니다.

  • 빌드가 완료된 상태의 이미지를 Container Registry에 저장할 수 있습니다.
  • 이후 빌드시 해당 이미지를 사용하면 빌드 환경에 따라 빌드 시간을 단축시킬 수 있습니다.

⑨ 빌드 완료 후 이미지를 저장할 Container Registry의 리전을 선택합니다.

⑩ 빌드 완료 후 이미지를 저장할 Container Registry의 레지스트리를 선택합니다.

⑪ 저장할 이미지 이름을 작성합니다.

  • 이미지 이름의 규칙은 아래와 같습니다.
    • 소문자 알파벳, 숫자, 특수문자(._-) 만 허용됩니다.
    • .은 연속으로 사용할 수 없으며, _ 는 연속해서 두번까지만 허용됩니다.
    • 시작 문자와 끝 문자는 소문자 알파벳, 숫자만 허용됩니다.
    • 최대 200자 까지 허용됩니다.

⑫ 태그명을 작성합니다.

  • 태그명 규칙은 아래와 같습니다.
    • 대소문자 알파벳, 숫자, 특수문자(#._-)만 허용됩니다.
    • 최대 80자 까지 허용됩니다.

태그명에서 #은 1부터 자동으로 증가하는 숫자로 채워지는 특수 문자입니다.

빌드 성공시마다 1씩 증가하여 숫자로 채워집니다.

연속된 #은 하나의 #과 동일하게 취급됩니다. (## -> #)

예) 1.0.#

⑬ File Safer 상품 연동

  • File Safer는 파일의 악성코드를 진단해 주는 서비스입니다.

  • File Safer (File Filter) 상품과 연동을 하면 빌드 성공 시 자동으로 결과물을 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

⑭ Cloud Log Analytics 상품 연동

  • SourceBuild 상품에서 빌드 시 발생하는 로그는 24시간 이후 삭제되어 24시간이 지난 빌드 로그는 확인하실 수 없습니다.
  • Cloud Log Analytics 상품과 연동을 하면 빌드 로그를 Cloud Log Analytics에 저장하여 30일간 저장할 수 있습니다.

⑮ 해당 프로젝트를 함께 사용할 서브어카운트를 추가합니다.

  • 등록한 서브어카운트에는 다음의 권한을 할당할 수 있습니다.
    • ADMIN: 해당 프로젝트의 설정 변경, 공유사용자 변경 및 권한 수정, 삭제가 가능하며 빌드를 실행할 수 있습니다.
    • USER: 해당 프로젝트의 빌드를 실행할 수 있습니다.

⑯ 적용 버튼을 클릭시 수정한 설정이 저장되며, 취소 버튼 클릭시 수정한 설정이 저장되지 않습니다.

빌드 프로젝트 삭제하기

네이버 클라우드 플랫폼 콘솔에서 빌드 프로젝트를 삭제할 수 있습니다.

devtools-3-1-25

① 빌드 프로젝트 리스트에서 삭제할 프로젝트를 선택합니다.

  • 빌드 프로젝트를 삭제하기 위해서는 다음의 권한이 있어야 합니다.
    • 고객 계정
    • 혹은, NCP_INFRA_MANAGER 권한을 소유
    • 혹은, 선택한 프로젝트의 ADMIN 권한을 소유

② 상단의 삭제 버튼을 클릭합니다.

③ 삭제 팝업창 하단 삭제 버튼을 클릭하면 빌드 프로젝트가 삭제됩니다.

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

연관 정보 바로가기

아래 가이드에서 연관 정보를 확인할 수 있습니다.

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...