SourcePipeline 사용하기 전에

Q. SourcePipeline은 무엇인가요?

  • SourcePipeline은 빠르고 안정적인 소프트웨어 출시를 위한 프로세스 자동화 상품입니다.
  • SourcePipeline은 손쉽게 새로운 기능을 출시할 수 있도록 리파지토리, 빌드, 배포를 통합하여 제공합니다.

Q. SourcePipeline은 어떻게 구성되나요?

  • SourcePipeline은 Source Phase, Build Phase, Deploy Phase로 구성이 되며 각각의 Phase는 SourceCommit, SourceBuild, SourceDeploy 상품과 연동됩니다.
  • SourcePipeline을 사용하기 위해서는 SourceCommit, SourceBuild, SourceDeploy 상품을 이용하셔야 합니다.

Q. SourcePipeline의 사용 절차는 어떻게 되나요?

devtools-5-1-22

  1. 네이버 클라우드 플랫폼 콘솔에 접속합니다.
  2. SourcePipeline 콘솔에서 파이프라인을 생성합니다. (SourceCommit/GitHub - SourceBuild 연동 리파지토리, SourceBuild, SourceDeploy 연동)
  3. 생성한 파이프라인을 실행합니다.
  4. 실행한 파이프라인의 작업결과를 확인합니다.

SourcePipeline 사용 권한

SourcePipeline은 파이프라인별로 사용자 접근 권한을 부여할 수 있으며, 다음과 같은 권한이 있습니다.

모든 권한

1. 고객 계정

  • 고객 계정은 SourcePipeline의 모든 기능을 제약 없이 사용할 수 있습니다.
  • 콘솔에서 파이프라인 생성 및 모든 파이프라인의 설정 변경, 삭제 버튼을 할 수 있으며, 모든 파이프라인을 실행할 수 있습니다.

2. NCP_INFRA_MANAGER

  • 고객 계정과 동일한 권한을 갖는 서브 계정으로 고객 계정과 동일하게 SourcePipeline의 모든 기능을 제약없이 사용할 수 있습니다.
  • 해당 권한은 고객 계정이 Management > Sub Account 메뉴에서 서브 계정에게 부여할 수 있습니다. (Sub Account 이용안내 바로가기)

파이프라인 생성 권한

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

1. NCP_SOURCE_PIPELINE_MANAGER

  • 콘솔에서 '파이프라인 생성' 기능을 통해 파이프라인을 생성할 수 있고, 자신이 생성한 파이프라인을 관리 및 다른 서브 계정에 공유 할 수 있습니다.

  • 고객 계정은 해당 권한이 기본으로 부여되어 있으며, 서브 계정은 고객 계정 사용자로부터 Management > Sub Account 메뉴에서 해당 권한을 할당받을 수 있습니다.

    참고: NCP_SOURCE_PIPELINE_MANGER 권한 부여하기

    devtools-5-1-01

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

    ② 부여할 서브 계정을 선택합니다. devtools-5-1-02

    ​ ① 선택한 서브 계정의 정책에 NCP_SOURCE_PIPELINE_MANAGER 정책을 추가합니다.

파이프라인 사용 권한

해당 권한은 고객 계정이나 SourcePipeline 관리자(서브 계정)가 SourcePipeline에서 파이프라인을 공유할 서브 계정에게 부여하는 권한입니다.

1. ADMIN

  • 파이프라인의 조회, 설정 변경, 삭제 권한을 포함하고 있습니다.
  • 파이프라인을 생성한 계정은 자동으로 ADMIN 권한이 부여됩니다.
  • 파이프라인 사용자 계정(서브 계정)을 할당하고 권한을 부여할 수 있습니다.
  • 파이프라인 실행 페이지에 접근하여 파이프라인을 실행할 수 있습니다.

2. USER

  • 파이프라인의 조회 권한을 포함하고 있습니다.
  • 파이프라인 실행 페이지에 접근하여 파이프라인을 실행할 수 있습니다.

파이프라인 생성

Step 1. 콘솔 접속

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

devtools-5-1-03

파이프라인 생성 버튼을 클릭하여 새로운 파이프라인을 생성합니다.

  • 파이프라인을 생성하기 위해서는 로그인한 계정이 고객 계정이거나, NCP_INFRA_MANAGER, NCP_SOURCE_PIPELINE_MANAGER 권한을 가지고 있는 서브 계정이어야 합니다.

    • NCP_SOURCE_PIPELINE_MANAGER 권한은 콘솔의 Management > Sub Account 메뉴에서 할당할 수 있습니다.

② SourcePipeline에 처음 접속하면 다음과 같은 문구가 표시됩니다.

  • 현재 생성된 파이프라인이 없습니다. 파이프라인 생성 버튼을 클릭하여 파이프라인을 생성하세요.

Step 2. 기본 설정

파이프라인의 이름과 설명을 입력합니다.

devtools-5-1-04

① 생성할 파이프라인의 이름을 입력합니다. 파이프라인의 이름은 알파벳, 숫자, 특수문자(-_)만 포함할 수 있습니다.

② 생성할 파이프라인의 설명을 작성합니다. 최소 3글자, 최대 500글자의 제한이 있습니다.

Step 3. 파이프라인 구성

파이프라인에 연동할 작업을 추가합니다.

devtools-5-1-05

① 작업추가 버튼을 클릭하여 연동할 작업을 설정합니다.

devtools-5-1-05

① 설정할 작업 이름을 작성합니다. (작업의 이름은 현재 파이프라인 내에서 유일한 이름이어야 합니다.)

② 작업의 타입을 설정합니다.(SourceBuild, SourceDeploy 선택)

devtools-5-1-05

① SourceBuild를 선택한 경우 아래에 프로젝트 선택 창이 나타납니다.

② 보유한 SourceBuild 프로젝트 리스트가 표시되며 선택 시 연결 정보가 출력됩니다.

③ 선택한 SourceBuild 프로젝트의 연결 리파지토리 정보가 출력됩니다.

④ 연결된 리파지토리의 브랜치 리스트가 표시되며 선택 가능합니다.

devtools-5-1-05

① SourceDeploy를 선택한 경우 아래에 프로젝트/스태이지/시나리오 선택 창이 나타납니다.

② 보유한 SourceDeploy 프로젝트 리스트가 표시되며 선택 시 스태이지 리스트가 표시됩니다.

③ 보유한 스태이지 리스트가 표시되며 선택 시 시나리오 리스트가 표시됩니다.

④ 보유한 시나리오 리스트가 표시되며 선택 시 연결 정보가 표시됩니다.

⑤ 선택한 시나리오에 연결된 SourceBuld 또는 ObjectStorage 정보가 표시됩니다.

devtools-5-1-05

① 작업 추가로 설정한 작업은 왼쪽의 미설정 영역에 존재하며 선행 작업 연결을 통해 오른편의 설정 영역으로 이동합니다.

② 선행 작업 연결을 마친 작업이 존재하는 설정영역입니다.

③ 선행 작업을 설정할 수 있는 팝업이 표시됩니다.

devtools-5-1-05

devtools-5-1-05

① 선행 작업 없음 선택시 첫번째 작업으로 설정됩니다.

devtools-5-1-05

devtools-5-1-05

① 선행 작업을 선택한 경우 해당 작업의 다음에 위치합니다.

devtools-5-1-05

① Trigger 설정을 On/Off할 수 있습니다. 설정한 Trigger 리파지토리/브랜치(SourceCommit)에 push 이벤트가 발생 시 해당 파이프라인이 자동으로 실행됩니다. (Trigger 리스트에 있는 리파지토리/브랜치 중 하나 이상의 push 이벤트 발생 시 실행합니다. 단, SourceCommit 상품의 콘솔 상에서의 commit 이벤트(Web 편집) 발생 시에는 실행되지 않습니다.)

② 보유한 SourceCommit 리파지토리 리스트가 표시되며 선택 시 브랜치 리스트가 표시됩니다.

③ 보유한 브랜치 리스트가 표시됩니다.

④ 추가 버튼을 클릭하여 Trigger 리스트에 추가합니다.

⑤ 삭제 버튼을 클릭하여 Trigger 리스트에서 삭제합니다.

Step 4. 파이프라인 사용자 설정

devtools-5-1-09

① 파이프라인을 공유할 사용자를 리스트에서 선택합니다.

  • 파이프라인을 공유할 사용자는 서브 계정 중에서 선택할 수 있습니다. 서브 계정 사용자를 추가하기 위해서는 우선 Sub Account 메뉴에서 계정을 추가 등록하기 바랍니다. (Sub Account 이용안내 바로가기)
  • 서브 계정으로 파이프라인 생성 시 본인 계정은 자동으로 ADMIN 권한이 부여됩니다.

② 공유할 사용자에게 할당할 접근 권한을 선택합니다. 접근 권한은 2가지입니다.

  • ADMIN: 파이프라인 조회/실행 및 수정/삭제 권한을 포함합니다.
  • USER: 파이프라인 조회/실행 권한을 포함합니다.

③ 추가된 사용자는 아래 리스트에서 확인할 수 있습니다.

④ 설정한 서브 계정을 삭제합니다.

Step 5. 파이프라인 생성 완료

devtools-5-1-10

파이프라인 생성 버튼을 클릭하여 생성을 완료합니다.

파이프라인 설정 변경

생성한 파이프라인 네이버 클라우드 플랫폼 콘솔에서 설정을 변경할 수 있습니다.

Step 1. 파이프라인 선택

devtools-5-1-11

① 설정을 변경할 파이프라인을 선택합니다.

설정 변경 버튼을 클릭합니다.

  • 파이프라인 설정을 변경하려면 로그인한 계정이 고객 계정 또는 NCP_INFRA_MANAGER 권한을 가지고 있는 서브계정이거나 파이프라인 사용자 계정(서브 계정)이 선택한 파이프라인에 대해 ADMIN 권한을 가지고 있어야 합니다.

Step 2. 파이프라인 설정 변경

devtools-5-1-12

① 파이프라인 설명을 변경합니다.

  • Source Phase를 수정한 경우, Build / Deploy Phase가 초기화됩니다.

② 파이프라인에 연결된 작업을 변경합니다.

  • 생성과 동일하게 작업을 추가/삭제 가능합니다.

③ Trigger 설정을 변경합니다.

  • 생성과 동일하게 리파지토리/브랜치를 추가/삭제 가능합니다.

④ 파이프라인을 사용할 사용자를 변경할 수 있습니다.

  • 파이프라인을 공유할 사용자는 서브 계정 중에서 선택할 수 있습니다. 서브 계정 사용자를 추가하기 위해서는 우선 Sub Account 메뉴에서 계정을 추가 등록하기 바랍니다. (Sub Account 이용안내 바로가기)

⑤ 변경 사항을 적용합니다.

파이프라인 삭제

네이버 클라우드 플랫폼 콘솔에서 파이프라인을 삭제할 수 있습니다.

Step 1. 파이프라인 선택

devtools-5-1-14

① 삭제할 파이프라인을 선택합니다.

[삭제] 버튼을 클릭합니다.

  • 파이프라인을 삭제하려면 로그인한 계정이 고객 계정 또는 NCP_INFRA_MANAGER 권한을 가지고 있는 서브계정이거나 파이프라인 사용자 계정(서브 계정)이 선택한 파이프라인에 대해 ADMIN 권한을 가지고 있어야 합니다.

Step 2. 파이프라인 삭제

devtools-5-1-15

[삭제] 버튼을 클릭하면 파이프라인이 삭제됩니다.

  • 삭제된 파이프라인은 다시 복구할 수 없습니다.

파이프라인 실행

Step 1. 파이프라인 실행페이지로 이동

devtools-5-1-16

① 파이프라인을 선택합니다.

파이프라인으로 이동 버튼 또는 파이프라인 이름(링크)을 클릭합니다.

Step 2. 파이프라인 실행

devtools-5-1-17

① SourceBuild 프로젝트의 빌드 대상 리파지토리의 브랜치를 선택합니다.

② SourceDeploy 프로젝트의 배포 시나리오를 선택합니다.

파이프라인 실행하기 버튼을 클릭하여 파이프라인을 실행합니다.

Step 3. 파이프라인 실행 중

devtools-5-1-19

① 파이프라인이 실행되면 작업 결과 탭으로 이동하며 작업이 진행 중으로 표시됩니다.

② 취소 버튼이 표시되며 클릭 시 파이프라인을 취소할 수 있습니다.

Step 4. 파이프라인 재실행

실패, 취소, 오류가 발생한 가장 최근의 파이프라인 작업 이력에 대해서 재실행이 가능합니다.

devtools-5-1-20

① 파이프라인 재실행은 다음과 같은 조건에서 가능합니다.

  • 파이프라인이 실패, 취소, 오류인 가장 최근 작업 이력
  • 파이프라인의 작업 구성이 변경되지 않은 경우

파이프라인 작업결과

파이프라인을 실행한 결과를 작업결과 탭에서 확인할 수 있습니다.

devtools-5-1-111

작업결과 탭을 클릭합니다.

② 확인할 파이프라인 작업 결과 행을 선택합니다.

로그 보기를 클릭하면 SourceBuild / SourceDeploy 작업 결과 화면으로 이동합니다.

  • Build / Deploy 작업에서 로그 클릭 시 각 상품의 로그를 확인할 수 있도록 SourceBuild, SourceDeploy의 작업 결과로 이동합니다. 이 때 SourceBuild, SourceDeploy 상품의 권한이 없을 경우 로그 확인이 제한될 수 있습니다.

연관 정보 바로가기

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

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

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

    처리중...