빌드 프로젝트 관리

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

네이버 클라우드 플랫폼 콘솔에서 생성한 프로젝트의 빌드를 실행할 수 있습니다. 또한 설정한 내용을 변경하거나 프로젝트를 삭제할 수도 있습니다.

빌드 실행

생성한 빌드 프로젝트를 실행하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
2. 실행하려는 빌드 프로젝트의 이름을 클릭해 주십시오.
   • 또는 빌드 프로젝트를 선택한 상태에서 [빌드로 이동] 버튼 클릭
3. 빌드 실행 화면이 나타나면 입력된 정보를 확인하고 필요시 수정해 주십시오.

4. [빌드 시작하기] 버튼을 클릭해 주십시오.
   
5. 빌드가 실행되면서 나타나는 실행 로그 및 빌드 실행 상태를 확인해 주십시오.
   • 빌드 결과 확인에 대한 자세한 내용은 빌드 결과 확인 참고
   • Prepare: 빌드 실행 중인 상태
   • Upload: 빌드 결과물을 저장하고 있는 상태
   • Success: 빌드 실행이 완료되어 최종 결과물이 저장된 상태
   • Fail: 빌드 실행을 실패한 상태로, 빌드 로그에서 상세 내용 확인 가능
   • Canceled: 빌드 실행이 취소된 상태

빌드 취소

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

1. 빌드 실행 중에 화면에 나타나는 [취소] 버튼을 클릭해 주십시오.
   
2. 빌드 상태가 Canceled로 표시되는지 확인해 주십시오.

빌드 결과 확인

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

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
2. 결과를 확인하려는 빌드 프로젝트의 이름을 클릭해 주십시오.
   • 또는 빌드 프로젝트를 선택한 상태에서 [빌드로 이동] 버튼 클릭
3. 빌드 실행 화면이 나타나면 [작업결과] 탭을 클릭해 주십시오.
4. 빌드 실행 결과를 확인해 주십시오.
   
   • 빌드 번호: 빌드 실행 시 부여된 고유 번호
   • 요청자: 빌드 실행 요청자의 계정 정보
   • 요청 시간: 요청자가 빌드 실행을 요청한 시간
   • 완료 시간: 빌드 실행이 완료된 시간
   • 상태: 빌드 실행 상태
     • Prepare: 빌드 실행 중인 상태
     • Upload: 빌드 결과물을 저장하고 있는 상태
     • Success: 빌드 실행이 완료되어 최종 결과물이 저장된 상태
     • Fail: 빌드 실행을 실패한 상태로, 빌드 로그에서 상세 내용 확인 가능
     • Canceled: 빌드 실행이 취소된 상태
   • FileSafer: 빌드 결과물의 악성 코드 검사 결과로, File Safer 연동 시 표시
   • 빌드 결과물: [다운로드] 버튼을 클릭해 생성된 빌드 결과물을 zip 형태로 다운로드
   • 빌드 로그: 빌드 실행 단계별 로그 확인
     • 단계별 상태가 아이콘 색상으로 표시되며 단계마다 최대 4000줄 표시
       • 노란색: 진행 중
       • 초록색: 성공
       • 빨간색: 실패
     • 빌드 실행 중에는 자동 스크롤되어 실시간 출력되는 로그를 확인할 수 있으나 도중에 다른 단계를 클릭하거나 수동 스크롤 시 자동 스크롤이 중지됨

File Safer 결과 확인

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

1. 작업 결과 목록에서 FileSafer 열의 을 클릭해 주십시오.
2. File Safer 결과 확인 팝업 창에서 File Safer 검사 결과를 확인해 주십시오.

빌드 설정 변경

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

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
2. 설정을 변경할 프로젝트를 선택한 후 [설정 변경] 버튼을 클릭해 주십시오.
3. 빌드 프로젝트 설정 화면이 나타나면 다음과 같이 구분되는 설정들을 원하는 대로 변경하고 [적용] 버튼을 클릭해 주십시오.
   • 기본 정보
   • 빌드 환경
   • 빌드 명령어
   • 빌드 결과물 업로드
   • 빌드 완료 후 이미지 업로드
   • 부가 서비스 연동

기본 정보

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

• 빌드 프로젝트 이름: 빌드 프로젝트의 이름이며 수정 불가
• 빌드 프로젝트 설명: 빌드 프로젝트에 대한 설명으로 500자 이내 입력
• 빌드 대상: 빌드 대상 유형을 선택한 후 세부 항목 설정
  • 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 설정 가이드
    • 소유자: 빌드 대상 코드가 위치한 소유자 선택
    • 리포지토리: 빌드 대상의 코드가 저장된 리포지토리 선택
    • 브랜치: 빌드 대상 리포지토리의 브랜치 선택

빌드 환경

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

• SourceBuild 이미지 선택 시 설정 변경
• Container Registry 이미지 선택 시 설정 변경
• Public Registry 이미지 선택 시 설정 변경

SourceBuild 이미지 선택 시 설정 변경

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

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

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

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

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

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

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

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

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

빌드 명령어

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

• 빌드 전 명령어: 빌드 실행 전 수행할 명령어 입력
• 빌드 명령어: 빌드 실행 중 수행할 명령어 입력
• 빌드 후 명령어: 빌드 실행 후 수행할 명령어 입력
• 도커 이미지 빌드 설정: 도커 이미지 빌드 시 사용 선택
  • 빌드 환경 설정에서 도커 이미지 빌드를 선택한 경우에만 사용 선택 가능
  • 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와의 연동 여부 선택

빌드 삭제

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

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