Dev Tools > Pipeline > 스테이지 가이드

스테이지 가이드에서는 Pipeline의 스테이지에 대해 기본적인 내용을 설명합니다. 파이프라인 관리 > +파이프라인 생성을 클릭해 파이프라인을 생성합니다. 생성한 파이프라인을 선택한 뒤 하단의 스테이지 탭에서 +스테이지 추가를 클릭해 스테이지를 추가할 수 있습니다.

stage-guide-01

스테이지는 아래의 그룹으로 구분됩니다. - 소스 - 빌드 - 배포 - 기능

소스

빌드할 소스 코드를 가져오는 스테이지입니다.

소스 - GitHub

소스 저장소는 환경 설정의 소스 저장소 설정에서 추가한 소스 저장소를 선택할 수 있습니다. 브랜치에는 빌드할 대상의 소스 브랜치를 입력합니다.

stage-guide-02

소스 - GitLab

소스 저장소는 환경 설정의 소스 저장소 설정에서 추가한 소스 저장소를 선택할 수 있습니다. 브랜치에는 빌드할 대상의 소스 브랜치를 입력합니다.

stage-guide-03

빌드

빌드를 하는 스테이지입니다.

빌드 - Jenkins

사용자가 직접 구성한 Jenkins를 이용하여 빌드할 수 있습니다. 빌드 도구는 환경 설정의 빌드 도구 설정에서 추가한 빌드 도구를 선택할 수 있습니다. 빌드 잡을 선택하고 빌드 잡 파라미터를 입력할 수 있습니다. 아티팩트의 시작 조건과 종료 조건을 설정할 수 있습니다. 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다. 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.

stage-guide-04 stage-guide-12

빌드 - NHN Cloud 빌드 도구

NHN Cloud에서 제공하는 빌드 도구를 사용할 수 있습니다. - 빌드 환경 설정 - 환경 설정의 이미지 저장소 설정에서 추가한 이미지 저장소를 선택할 수 있습니다. - 빌드할 환경의 이미지 이름을 선택하고, 빌드 도구 성능과 빌드 시간 제한(분), 빌드 명령어를 설정합니다.

  • 빌드 결과 설정
  • 빌드 결과물의 Dockerfile 경로를 설정하고, Dockerfile 실행 경로를 설정합니다.
  • 이미지 저장소를 선택하고, 이미지 이름을 결정하면 해당 저장소로 결과물을 push합니다.

  • 태그 포맷 사용을 선택하면 태그 포맷으로 태그가 고정되며, _{BUILD_NUMBER} 형식의 동적으로 생성되는 태그로 이미지가 생성됩니다.

  • 아티팩트 설정

  • 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다.
  • 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.

stage-guide-05 stage-guide-13

빌드 - Bake (Manifest)

사용자가 직접 구성한 Helm package file 또는 차트 저장소를 이용하여 빌드할 수 있습니다. - 차트 이름은 Helm 엔진으로 구성한 결과물의 이름을 설정합니다. - Namespace는 Helm 엔진으로 구성한 결과물의 Namespace를 설정합니다. - 템플릿 - 저장소 타입은 환경 설정의 소스 저장소 설정 또는 차트 저장소 설정에서 추가한 저장소를 선택할 수 있습니다. - 저장소 타입을 GitHub 파일 또는 GitLab 파일으로 지정한 경우 - 경로는 Helm package file의 경로를 입력해야 합니다. - 브랜치 이름은 Github 또는 Gitlab의 브랜치를 입력합니다. - 저장소 타입을 Helm 차트로 지정한 경우 - 차트 저장소 이름은 차트 저장소 설정에서 설정한 저장소 중 하나를 선택할 수 있습니다. - 차트 이름은 차트 저장소의 구성에서 사용할 수 있는 차트 이름을 선택할 수 있습니다. - 차트 버전은 차트 저장소의 구성에서 사용할 수 있는 차트 버전을 선택할 수 있습니다. - 오버라이드 - 저장소 정보 - 템플릿과 동일한 방식으로 선택할 수 있습니다. - 템플릿을 기본으로 하여 오버라이드에서 지정한 내용으로 치환하여 빌드 결과물을 생성합니다. - 키(Key) / 값(Value) - key, value로 이루어진 값을 입력하고 특정 값을 치환하여 빌드 결과물을 생성합니다. - 기본 유형 치환 - 해당 옵션을 체크하면 오버라이드 값을 주입할 때, --set-string 대신 --set을 사용합니다. --set을 사용하여 주입된 값은 Helm에 의해 기본 자료형으로 변환됩니다. - 아티팩트 - 아티팩트의 시작 조건과 종료 조건을 설정할 수 있습니다. 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다. 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.

stage-guide-12 stage-guide-13

배포

Kubernetes 환경에 배포를 하는 스테이지입니다.

배포 - Deploy

  • 환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. 스테이지 이름, 배포 대상, 배포에 사용할 Manifest를 입력합니다. 빌드 스테이지에서 태그 포맷을 사용한 경우 Manifest의 도커 이미지 태그 부분을 _{BUILD_NUMBER}로 입력하면 태그 포맷으로 빌드된 이미지 중 가장 최근 번호의 이미지로 배포할 수 있습니다. Manifest를 작성하는 방법은 Kubernetes 문서를 참고하십시오.
  • Manifest 소스를 아티팩트로 선택할 수 있습니다. 선택한 아티팩트는 Manifest 형태로 생성되어야 합니다.
  • 파이프라인에서 생성한 아티팩트를 선택할 수 있습니다.
  • 저장소에서 특정 파일을 아티팩트로 선택할 수 있습니다.
  • 아티팩트의 시작 조건 및 종료 조건을 설정할 수 있습니다. 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다. 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.

stage-guide-06 stage-guide-15 stage-guide-16 stage-guide-14

배포 - Patch

환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, 배포에 사용할 Manifest를 입력합니다. Patch로 기존 리소스의 정보를 수정할 수 있습니다. Manifest를 작성하는 방법은 Kubernetes 문서를 참고하십시오.

stage-guide-07

배포 - Scale

환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, Replicas를 입력합니다. Scale로 Replicas를 수정할 수 있습니다.

stage-guide-08

배포 - Rollout undo

환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, Revision Back을 입력합니다. 지정한 Revision으로 롤백할 수 있습니다.

stage-guide-09

배포 - Delete

환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름을 입력합니다. 해당 리소스를 삭제할 수 있습니다.

stage-guide-10

기능

추가 기능을 제공하는 스테이지입니다.

기능 - Webhook

URL에 HTTP 메소드와 URL을 입력합니다. 필요에 따라 요청 헤더와 요청 데이터를 추가할 수 있습니다. Webhook의 응답값이 Fail Fast HTTP 상태 코드에 입력한 값 중 하나라면 그 즉시 해당 스테이지를 종료합니다.

stage-guide-11

목차
TOP