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, 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. Name Phase

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

devtools-5-1-04

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

Step 3. Source Phase

파이프라인에 연동할 리파지토리를 선택합니다.

devtools-5-1-05

① 파이프라인에 연동할 리파지토리 소스로 SourceCommit 또는 GitHub 중 하나를 선택합니다.

devtools-5-1-05

① 보유하고 있는 SourceCommit의 리파지토리 중 하나를 선택합니다.

  • SourceCommit 상품을 사용하는 중이고 생성된 SourceCommit 리파지토리가 존재해야 합니다.
  • SourceCommit 상품의 권한이 없더라도 리파지토리 리스트는 나타납니다. 다만, SourceCommit 콘솔로 접근하기 위해서는 해당 상품의 권한이 필요합니다.

devtools-5-1-05

① 연동되어 있는 GitHub의 리파지토리 중 하나를 선택합니다.

  • SourceBuild 상품에서 설정한 GitHub 리파지토리가 출력됩니다.

Step 4. Build Phase

파이프라인에 연동할 SourceBuild 프로젝트를 선택합니다.

devtools-5-1-06

① SourceBuild 리스트 중 하나의 프로젝트를 선택합니다.

  • SourceBuild 상품을 사용하는 중이고 Source Phase에서 선택한 리파지토리와 연동된 SourceBuild 프로젝트가 존재해야 합니다.
  • SourceBuild 상품의 권한이 없더라도 리파지토리와 연동된 SourceBuild 프로젝트가 있다면 리스트가 나타납니다. 다만, SourceBuild 콘솔로 접근하기 위해서는 해당 상품의 권한이 필요합니다.

Step 5. Deploy Phase

파이프라인에 연동할 SourceDeploy 프로젝트를 선택합니다. devtools-5-1-07

① SourceDeploy 리스트 중 하나를 선택합니다.

  • SourceDeploy 상품을 사용하는 중이고 Build Phase에서 선택한 SourceBuild 프로젝트와 연동된 SourceDeploy 프로젝트 또는 SourceDeploy 프로젝트에서 선택한 배포 파일 위치가 선택한 SourceBuild 프로젝트의 빌드 결과물을 업로드할 Object Storage 경로가 같은 SourceDeploy 프로젝트가 존재해야 합니다.
  • SourceDeploy 상품의 권한이 없더라도 조건에 만족하는 프로젝트가 있다면 리스트가 나타납니다. 다만, SourceDeploy 콘솔로 접근하기 위해서는 해당 상품의 권한이 필요합니다.

② SourceDeploy 상세설정을 합니다.

devtools-5-1-13

​ ① 선택한 SourceDeploy 프로젝트의 스태이지를 선택합니다.

​ ② 선택한 스태이지의 시나리오를 선택합니다.

​ ③ 확인 버튼을 클릭하셔 상세설정을 저장합니다.

Step 6. 파이프라인 설명

devtools-5-1-08

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

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

devtools-5-1-09

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

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

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

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

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

④ 서브 계정으로 파이프라인 생성 시 본인 계정은 자동으로 ADMIN 권한이 부여됩니다.

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

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가 초기화됩니다.

② 파이프라인에 설정된 SourceBuild 프로젝트를 변경할 수 있습니다.

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

③ 파이프라인에 설정된 SourceDeploy 프로젝트를 변경할 수 있습니다.

④ 선택한 SourceDeploy 프로젝트의 상세설정을 변경합니다.

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

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

  • 파이프라인을 공유할 사용자는 서브 계정 중에서 선택할 수 있습니다. 서브 계정 사용자를 추가하기 위해서는 우선 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

① Source Phase에서 선택한 리파지토리의 브랜치 선택 또는 커밋해시를 입력합니다.

② Build Phase에서 선택한 SourceBuild 프로젝트의 명령어를 확인하고 수정할 수 있습니다.

  • 수정한 명령어는 현재의 파이프라인 실행에만 적용됩니다.devtools-5-1-18

    ​ ① 빌드 전 명령어를 수정합니다.

    ​ ② 빌드 명령어를 수정합니다.

    ​ ③ 빌드 후 명령어를 수정합니다.

    ​ ④ 수정한 빌드 명령어를 저장합니다.

③ Deploy Phase에서 선택한 SourceDeploy 프로젝트의 스태이지 중 배포할 스태이지를 선택합니다.

  • 파이프라인 생성/변경에서 배포 프로젝트 상세설정으로 적용한 스태이지와 시나리오가 기본적으로 선택되어 표시됩니다.

④ 선택한 스태이지에서 배포할 시나리오를 선택합니다.

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

Step 3. 파이프라인 실행 중

devtools-5-1-19

① 파이프라인이 실행되면 파이프라인 실행하기 버튼과 각 Phase의 변경항목이 있는 부분이 비활성화됩니다.

Step 4. 파이프라인 완료

파이프라인이 완료되면 각 Phase의 상태를 확인할 수 있습니다.

devtools-5-1-20

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

파이프라인 작업결과

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

devtools-5-1-111

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

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

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

참고 사항

본 상품은 글로벌 리전 서비스로도 제공됩니다.

연관 정보 바로가기

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

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

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

    처리중...