스테이지 가이드에서는 Pipeline의 스테이지에 대해 기본적인 내용을 설명합니다. 파이프라인 관리 > +파이프라인 생성을 클릭해 파이프라인을 생성합니다. 생성한 파이프라인을 선택한 뒤 하단의 스테이지 탭에서 +스테이지 추가를 클릭해 스테이지를 추가할 수 있습니다.
스테이지는 아래의 그룹으로 구분됩니다. - 소스 - 빌드 - 배포 - 기능
빌드할 소스 코드를 가져오는 스테이지입니다.
소스 저장소는 환경 설정의 소스 저장소 설정에서 추가한 소스 저장소를 선택할 수 있습니다. 브랜치에는 빌드할 대상의 소스 브랜치를 입력합니다.
소스 저장소는 환경 설정의 소스 저장소 설정에서 추가한 소스 저장소를 선택할 수 있습니다. 브랜치에는 빌드할 대상의 소스 브랜치를 입력합니다.
빌드를 하는 스테이지입니다.
사용자가 직접 구성한 Jenkins를 이용하여 빌드할 수 있습니다. 빌드 도구는 환경 설정의 빌드 도구 설정에서 추가한 빌드 도구를 선택할 수 있습니다. 빌드 잡을 선택하고 빌드 잡 파라미터를 입력할 수 있습니다. 아티팩트의 시작 조건과 종료 조건을 설정할 수 있습니다. 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다. 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.
NHN Cloud에서 제공하는 빌드 도구를 사용할 수 있습니다. - 빌드 환경 설정 - 환경 설정의 이미지 저장소 설정에서 추가한 이미지 저장소를 선택할 수 있습니다. - 빌드할 환경의 이미지 이름을 선택하고, 빌드 도구 성능과 빌드 시간 제한(분), 빌드 명령어를 설정합니다.
태그 포맷 사용을 선택하면 태그 포맷으로 태그가 고정되며, _{BUILD_NUMBER}
형식의 동적으로 생성되는 태그로 이미지가 생성됩니다.
아티팩트 설정
사용자가 직접 구성한 Helm package file 또는 차트 저장소를 이용하여 빌드할 수 있습니다. - 차트 이름은 Helm 엔진으로 구성한 결과물의 이름을 설정합니다. - Namespace는 Helm 엔진으로 구성한 결과물의 Namespace를 설정합니다. - 템플릿 - 저장소 타입은 환경 설정의 소스 저장소 설정 또는 차트 저장소 설정에서 추가한 저장소를 선택할 수 있습니다. - 저장소 타입을 GitHub 파일 또는 GitLab 파일으로 지정한 경우 - 경로는 Helm package file의 경로를 입력해야 합니다. - 브랜치 이름은 Github 또는 Gitlab의 브랜치를 입력합니다. - 저장소 타입을 Helm 차트로 지정한 경우 - 차트 저장소 이름은 차트 저장소 설정에서 설정한 저장소 중 하나를 선택할 수 있습니다. - 차트 이름은 차트 저장소의 구성에서 사용할 수 있는 차트 이름을 선택할 수 있습니다. - 차트 버전은 차트 저장소의 구성에서 사용할 수 있는 차트 버전을 선택할 수 있습니다. - 오버라이드 - 저장소 정보 - 템플릿과 동일한 방식으로 선택할 수 있습니다. - 템플릿을 기본으로 하여 오버라이드에서 지정한 내용으로 치환하여 빌드 결과물을 생성합니다. - 키(Key) / 값(Value) - key, value로 이루어진 값을 입력하고 특정 값을 치환하여 빌드 결과물을 생성합니다. - 기본 유형 치환 - 해당 옵션을 체크하면 오버라이드 값을 주입할 때, --set-string 대신 --set을 사용합니다. --set을 사용하여 주입된 값은 Helm에 의해 기본 자료형으로 변환됩니다. - 아티팩트 - 아티팩트의 시작 조건과 종료 조건을 설정할 수 있습니다. 시작 조건을 설정하여 스테이지 시작 여부를 결정할 수 있습니다. 종료 조건을 설정하여 스테이지의 생성물을 아티팩트로 설정할 수 있습니다.
Kubernetes 환경에 배포를 하는 스테이지입니다.
_{BUILD_NUMBER}
로 입력하면 태그 포맷으로 빌드된 이미지 중 가장 최근 번호의 이미지로 배포할 수 있습니다.
Manifest를 작성하는 방법은 Kubernetes 문서를 참고하십시오.
환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, 배포에 사용할 Manifest를 입력합니다. Patch로 기존 리소스의 정보를 수정할 수 있습니다. Manifest를 작성하는 방법은 Kubernetes 문서를 참고하십시오.
환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, Replicas를 입력합니다. Scale로 Replicas를 수정할 수 있습니다.
환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름, Revision Back을 입력합니다. 지정한 Revision으로 롤백할 수 있습니다.
환경 설정의 배포 대상 설정에서 추가한 배포 대상을 선택할 수 있습니다. Namespace, 리소스 유형, 리소스 이름을 입력합니다. 해당 리소스를 삭제할 수 있습니다.
추가 기능을 제공하는 스테이지입니다.
URL에 HTTP 메소드와 URL을 입력합니다. 필요에 따라 요청 헤더와 요청 데이터를 추가할 수 있습니다. Webhook의 응답값이 Fail Fast HTTP 상태 코드에 입력한 값 중 하나라면 그 즉시 해당 스테이지를 종료합니다.
필요에 따라 실행 관리 스테이지에 대한 설명, 실행 설정값을 입력할 수 있습니다.
실행 설정의 유무와 상관없이 다음 스테이지에 대한 실행 관리(실행, 실행 중지)를 할 수 있습니다. 실행 설정을 추가하여 다음 스테이지의 실행을 선택할 경우 다음에 설명할 스테이지인 Precondition(실행 조건)에 설정값을 전달하여 분기 처리를 할 수 있습니다.
이전 단계로 설정된 Judgement(실행 관리) 스테이지에서 전달받은 값의 실행 조건에 따라 뒤의 스테이지들의 실행을 결정합니다. Judgement(실행 관리) 스테이지에서 전달받은 설정값과 실행 조건의 조건 값에 대해 실행 조건 일치/실행 조건 불일치 중 선택하여 이후 스테이지의 실행을 결정합니다.
스테이지에서 다른 파이프라인 전체를 실행할 수 있습니다.
실행하고자 하는 파이프라인 이름을 선택합니다.
실행 조건을 선택 해제하면 선택한 파이프라인의 실행 상태를 기다리지 않고, 다음 스테이지가 실행됩니다.
기능 - 승인 관리 스테이지 이후의 스테이지들에 대한 실행 관리(실행, 실행 중지)를 승인권자가 관리할 수 있습니다.
스테이지에 요청 내용에 대해 작성할 수 있으며, 승인 관리 스테이지의 실행 관리(실행, 실행 중지) 기능은 해당 프로젝트의 Pipeline APPROVAL ADMIN 역할을 가진 사용자만 할 수 있습니다.
Pipeline APPROVAL ADMIN 역할은 프로젝트의 멤버 관리, 역할 그룹 관리에서 부여할 수 있습니다.