빌드 프로젝트 관리
    • PDF

    빌드 프로젝트 관리

    • PDF

    기사 요약

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

    빌드 실행

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

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

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

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

    빌드 취소

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

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

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

    빌드 결과 확인

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

    1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
    2. 결과를 확인하려는 빌드 프로젝트의 이름을 클릭해 주십시오.
      • 또는 빌드 프로젝트를 선택한 상태에서 [빌드로 이동] 버튼 클릭
    3. 빌드 실행 화면이 나타나면 [작업결과] 탭을 클릭해 주십시오.
    4. 빌드 실행 결과를 확인해 주십시오.
      sourcebuild-use-manage_result_ko
      • 빌드 번호: 빌드 실행 시 부여된 고유 번호
      • 요청자: 빌드 실행 요청자의 계정 정보
      • 요청 시간: 요청자가 빌드 실행을 요청한 시간
      • 완료 시간: 빌드 실행이 완료된 시간
      • 상태: 빌드 실행 상태
        • 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을 클릭해 주십시오.
    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, Passphrase 입력 (Passphrase는 SSH Key 에 Passphrase 설정한 경우에 입력해주십시오.)
        참고
        • 방화벽 설정 등으로 인해 Github Enterprise Server에 통신이 불가한 경우 해당 저장소 유형을 사용할 수 없습니다.
        • Github Enterprise Server URL 은 IP, Hostname으로 입력 가능하며, public 한 환경이어야 합니다.
        • SSH Key 로그인은 다른 로그인과 달리 입력한 Git 리포지토리 URL의 리포지토리만 접근할 수 있습니다.
        • GitHub Enterprise Server 공식 가이드
        • 소유자: 빌드 대상 코드가 위치한 소유자 선택
        • 리포지토리: 빌드 대상의 코드가 저장된 리포지토리 선택
        • 브랜치: 빌드 대상 리포지토리의 브랜치 선택
    참고
    • GitHub/Bitbucket/Github Enterprise Server을 선택하고 로그인할 때 로그인 페이지가 나타나지 않고 바로 로그인되었다면 브라우저에서 이미 로그인된 것입니다. 다른 계정으로 다시 로그인해야 한다면 해당 웹사이트에 직접 접속해 로그아웃한 후 다시 시도해 주십시오.

    빌드 환경

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

    SourceBuild 이미지 선택 시 설정 변경

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

    • 운영 체제: 빌드 환경 운영 체제로 Ubuntu 16.04 (x64) 단일 선택
    • 컴퓨팅 유형: 빌드 환경의 컴퓨팅 유형, 빌드 환경에 따라 이용 요금 상이
    • 빌드 런타임: 빌드 런타임 선택
    • 빌드 런타임 버전: 선택된 빌드 런타임의 버전 선택
      • 사용할 수 있는 빌드 런타임 및 버전
    빌드 런타임빌드 런타임 버전
    base16.04-1.0.0
    java7-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
    dotnet1.0-1.0.0
    2.0-1.0.0
    2.1-1.0.0
    6.0-1.0.0
    android-java26.1.1-8-1.0.0
    26.1.1-9-1.0.0
    26.1.1-10-1.0.0
    python2.7-1.0.0
    3.5-1.0.0
    3.8-1.0.0
    3.9-1.0.0
    3.10-1.0.0
    nodejs8.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
    참고

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

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

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

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

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

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

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

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

    빌드 명령어

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

    참고
    • 명령어 스크립트는 /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와의 연동 여부 선택
    참고

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

    빌드 삭제

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

    참고

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

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

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.