빌드 프로젝트 생성

Classic/VPC 환경에서 이용 가능합니다.

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

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
2. [빌드 프로젝트 생성] 버튼을 클릭해 주십시오.
3. 필수 준비 사항에서 Object Storage가 사용중으로 선택되어 있는지 확인하고 [다음] 버튼을 클릭해 주십시오.
   • 미사용 중일 경우 을 클릭하면 Object Storage 화면으로 이동하며 서비스 이용 신청 및 버킷 생성 후 다시 시도
4. 화면을 따라 다음 단계를 차례대로 진행해 주십시오.
   • 1. 기본 설정
   • 2. 빌드 환경 설정
   • 3. 빌드 명령어 설정
   • 4. 업로드 설정
   • 5. 추가 상품 연동
   • 6. 최종 확인

1. 기본 설정

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

1. 생성할 빌드 프로젝트의 이름과 설명을 입력해 주십시오.

   • 이름은 알파벳, 숫자, 특수문자(-, _) 사용 가능하며 이미 생성된 빌드 프로젝트와 동일한 이름 입력 불가
   • 설명은 500자 이내 입력 가능

2. 빌드 대상 유형을 선택한 후 필요한 세부 항목을 설정해 주십시오.

   • SourceCommit 선택 시 다음의 항목을 설정
     • 리파지토리: 빌드 대상 코드가 저장된 리포지토리 선택
     • 브랜치: 빌드 대상 리포지토리의 브랜치 선택
   • Github 선택 시 연동할 GitHub 계정 로그인 및 다음의 항목을 설정
     • [로그인] 버튼을 클릭한 후 OAuth 인증 또는 Personal access token을 사용해 로그인
       • OAuth: [GitHub 로그인 하기] 버튼을 클릭한 후 GitHub 계정 정보를 입력
       • Personal access token: GitHub에서 발행한 Personal access token 값을 입력한 후 [GitHub 로그인 하기] 버튼 클릭
     • 리파지토리: 빌드 대상 코드가 저장된 리포지토리 선택
     • 브랜치: 빌드 대상 리포지토리의 브랜치 선택
     참고

     GitHub에서 Personal access token 생성 방법에 대한 자세한 내용은 GitHub의 Personal access token 생성 가이드를 참고해 주십시오.

   • Bitbucket 선택 시 연동할 Bitbucket 계정 로그인 및 다음의 항목을 설정
     • [로그인] > [Bitbucket 로그인] 버튼을 차례대로 클릭한 후 Bitbucket 계정 정보를 입력하거나 OAuth 계정 사용
     • 워크스페이스: 빌드 대상 코드가 위치한 워크스페이스 선택
     • 리파지토리: 빌드 대상 코드가 저장된 리포지토리 선택
     • 브랜치: 빌드 대상 리포지토리의 브랜치 선택
   • Github Enterprise Server 선택 시 [로그인] 버튼을 클릭한 후 다음의 항목을 설정
     • 다음 중 하나의 인증 정보를 입력한 후 [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 입력
     참고

     • 방화벽 설정 등으로 인해 Github Enterprise Server에 통신이 불가한 경우 해당 저장소 유형을 사용할 수 없습니다.
     • Github Enterprise Server URL 은 IP, Hostname으로 입력 가능하며, public 한 환경이어야 합니다.
     • SSH Key 로그인은 다른 로그인과 달리 입력한 Git 리포지토리 URL의 리포지토리만 접근 할 수 있습니다.
     • GitHub Enterprise Server 공식 가이드
       • OAuth APP 생성 가이드
         • OAuth App 설정 시 Callback URL을 알맞게 설정해야 합니다.
           • KR : https://devtools.gov-ncloud.com/ghes/sourcebuild
       • Personal Access Token 생성 가이드
       • SSH key 설정 가이드
     • 소유자: 빌드 대상 코드가 위치한 소유자 선택
     • 리포지토리: 빌드 대상의 코드가 저장된 리포지토리 선택
     • 브랜치: 빌드 대상 리포지토리의 브랜치 선택

3. 알림 설정을 빌드 시작될 때와 빌드 종료되었을 때로 설정 할 수 있습니다.

   • 이벤트 발생시 통보 받을 담당자는 [통보대상관리] 를 클릭하여 먼저 등록해주십시오.
   • 이벤트 발생 시 통보 받을 담당자, 통보방법(SMS, Email)을 선택한 후 [추가] 버튼을 클릭해주십시오.
   • 설정한 담당자를 삭제하려면 [삭제] 버튼을 클릭하여 담당자 목록에서 삭제해 주십시오.

4. [다음] 버튼을 클릭해 주십시오.

2. 빌드 환경 설정

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

• SourceBuild에서 관리되는 이미지 사용
• Container Registry의 이미지 사용
• Public Registry의 이미지 사용

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

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

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

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

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

Container Registry의 이미지 사용

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

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

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

Public Registry의 이미지 사용

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

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

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

3. 빌드 명령어 설정

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

1. 빌드 실행 전, 빌드 실행 중, 빌드 실행 후에 수행할 명령어를 각각 입력해 주십시오.

   • 사용 가능한 셸(shell): /bin/sh
   • 여러 개의 명령어 입력 시 줄 바꿈으로 구분
   • 소스 코드의 최상위 디렉터리에서 명령어 수행
   • 빌드 순서: 프로비저닝(서버 생성) > 소스 코드 다운로드 > 빌드 전 명령어 > 빌드 명령어 > 빌드 후 명령어 > 결과물 업로드

2. 도커 이미지 빌드 설정에서 사용 여부를 선택해 주십시오.

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

3. [다음] 버튼을 클릭해 주십시오.

4. 업로드 설정

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

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에서 자동으로 검사해 결과물의 악성 코드 여부를 진단받을 수 있습니다.

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

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. [생성] 버튼을 클릭해 주십시오.