SourceBuild 시작

SourceBuild 시작에서는 SourceBuild 사용 환경을 확인하고 전체 사용 시나리오와 용어를 숙지한 후 SourceBuild를 정상적으로 사용하기 위해 사용자가 해야 할 일을 설명합니다. SourceBuild 시작에서 설명하는 내용은 다음과 같습니다.

• 소스 코드를 준비하는 방법
• Object Storage 버킷을 생성하는 방법
• Container Registry를 연동하는 방법
• SourceBuild 이용에 필요한 사용자 권한을 설정하는 방법
• 빌드 프로젝트를 생성하는 방법

소스 코드 준비

빌드할 소스 코드는 각 리포지토리에서 준비할 수 있습니다.

• 네이버 클라우드 플랫폼의 SourceCommit
• GitHub
• Bitbucket
• GitHub Enterprise

SourceCommit에서 코드 커밋

네이버 클라우드 플랫폼의 SourceCommit을 사용해 코드를 커밋하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Developer Tools > SourceCommit 메뉴를 차례대로 클릭해 주십시오.
3. [리포지토리 생성] 버튼을 클릭해 주십시오.
4. 리포지토리 이름과 설명을 입력하고 초기화 설정을 선택한 후 [다음] 버튼을 클릭해 주십시오.
5. 보안 서비스인 File Safer와의 연동 여부를 선택하고 [다음] 버튼을 클릭해 주십시오.
6. 최종 내용을 확인하고 [생성] 버튼을 클릭해 주십시오.

Object Storage 버킷 생성

빌드 결과물을 저장할 Object Storage 버킷을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Storage > Object Storage 메뉴를 차례대로 클릭해 주십시오.
3. [이용 신청] 버튼을 클릭해 주십시오.
4. 이용 신청 팝업 창이 나타나면 [적용] 버튼을 클릭해 주십시오.
5. Bucket Management 메뉴를 클릭해 주십시오.
6. [버킷 생성] 버튼을 클릭해 주십시오.
7. 생성할 버킷 이름을 입력하고 [다음] 버튼을 클릭해 주십시오.
8. 버킷 이용에 대한 권한을 설정하고 [다음] 버튼을 클릭해 주십시오.
9. 잠금 여부 및 저장 객체의 암호화 여부를 선택하고 [다음] 버튼을 클릭해 주십시오.
10. 최종 내용을 확인하고 [버킷 생성] 버튼을 클릭해 주십시오.

Container Registry 연동

빌드 완료 후 해당 빌드 환경을 이미지화해 저장하려면 네이버 클라우드 플랫폼의 Container Registry에서 레지스트리를 생성해 Object Storage와 연동해야 합니다. Container Registry를 연동하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Services > Containers > Container Registry 메뉴를 차례대로 클릭해 주십시오.
3. [레지스트리 생성] 버튼을 클릭해 주십시오.
4. 생성할 레지스트리의 이름을 입력한 후 연동할 Object Storage 버킷을 선택하고 [생성] 버튼을 클릭해 주십시오.
   • 하나의 버킷에는 한 개의 레지스트리만 연동할 수 있습니다.

사용자 권한 설정

로그인 계정에 따른 SourceBuild 이용 권한을 확인하고, 필요에 따라 콘솔의 Services > Management & Governance > Sub Account 메뉴에서 서브 계정 권한을 설정해 주십시오.

• 고객 계정: SourceBuild의 모든 기능을 제약 없이 이용 가능
• 고객이 생성한 서브 계정: SourceBuild를 사용하려면 다음 권한 중 하나가 필요
  • NCP_FIN_INFRA_MANAGER: 고객 계정과 동일하게 SourceBuild를 포함한 네이버 클라우드 플랫폼 내 모든 서비스 이용 가능. 단, 마이페이지의 일부 관리 기능 제외.
  • NCP_FIN_SOURCEBUILD_MANAGER: SourceBuild 내 모든 기능 이용 가능

빌드 프로젝트 생성

소스 코드, 버킷, 레지스트리 준비 및 권한 설정을 마쳤다면 콘솔에서 빌드 프로젝트를 생성합니다. 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Developer Tools > SourceBuild 메뉴를 차례대로 클릭해 주십시오.
2. [빌드 프로젝트 생성] 버튼을 클릭해 주십시오.
3. 필수 준비 사항에서 Object Storage가 사용중으로 선택되어 있는지 확인하고 [다음] 버튼을 클릭해 주십시오.
4. 생성할 빌드 프로젝트의 이름을 입력하고 빌드 대상을 선택한 후 [다음] 버튼을 클릭해 주십시오.
   • 빌드 대상인 소스 코드가 저장된 리포지토리를 SourceCommit, GitHub, Bitbucket, Github Enterprise Server 중에서 선택
   • GitHub, Bitbucket, Github Enterprise Server 선택 시 로그인을 통해 서비스 연동 후 세부 경로 선택
5. 빌드 환경 이미지를 선택하고 빌드 환경을 설정한 후 [다음] 버튼을 클릭해 주십시오.
   • 빌드 환경 이미지 출처를 SourceBuild, Container Registry, Public Registry 중에서 선택
   • 선택한 이미지 출처에 따른 세부 항목 설정 및 입력
6. 빌드를 진행할 명령어를 설정하고 [다음] 버튼을 클릭해 주십시오.
7. 빌드 결과물과 완료 이미지의 저장 여부를 설정하고 [다음] 버튼을 클릭해 주십시오.
8. 빌드 로그 보관을 위한 Cloud Log Analystics 및 결과물 악성 코드 검사를 위한 File Safer와의 연동 여부를 선택하고 [다음] 버튼을 클릭해 주십시오.
9. 입력된 정보를 확인하고 [생성] 버튼을 클릭해 주십시오.