스테이지

사용자는 스테이지 종류와 각 스테이지별 항목에 대한 설명을 확인할 수 있습니다.

빌드 파이프라인 추가하기 또는 빌드 파이프라인 수정하기에서 스테이지 설정을 할 수 있습니다.

공통 항목

스테이지 설정 페이지는 다음과 같이 구성되어 있습니다.

항목	설명
Tools	스테이지에서 기본으로 설정된 툴 외에 특정한 툴을 지정해서 사용하고 싶은 경우에 사용으로 선택 `JDK` `Maven` `Git` `Ant` `Go` `Gradle` `NodeJS`
스테이지 종류	목록에서 필요로 하는 스테이지를 선택하고, 필요한 정보를 입력합니다.
스테이지 명	스테이지 이름을 입력합니다.

표. 스테이지 입력 항목 구성

Checkout

코드 저장소에 등록된 Git 저장소에서 checkout 명령어를 수행하는 스테이지 입니다.

스테이지 종류로 Checkout을 선택합니다.

항목	설명
URL	`checkout`을 수행할 코드 저장소를 선택합니다.
Branch 명	`checkout` 할 브랜치 명을 입력합니다.

표. Checkout 스테이지 입력 항목

Build

애플리케이션을 빌드하는 명령어를 수행하는 스테이지 입니다.

스테이지 종류로 Build를 선택합니다.

항목	설명
언어	애플리케이션이 사용하는 프로그래밍 언어를 선택합니다.
빌드 도구	애플리케이션 빌드에 사용하는 빌드 도구를 선택합니다. 선택한 빌드 도구에 따라 기본 Shell 명령어를 제공합니다.
Shell 명령어	애플리케이션 빌드에 사용할 명령어를 입력합니다. Shell에서 사용가능한 모든 명령어 사용이 가능합니다.

표. Build 스테이지 입력 항목

Docker Build

Docker 이미지 빌드를 수행하는 스테이지 입니다.

스테이지 종류로 Docker Build를 선택합니다.

항목	설명	예시
Registry URL (`docker push`)	Docker 빌드 완료된 결과 이미지가 push 될 이미지 저장소를 선택하세요.
ID	이미지저장소에 사용될 계정의 ID 값
이미지 태그 패턴	선택한 패턴에 따라 Docker 이미지의 tag가 자동 생성됩니다. `{YYYYMMDD}`: 년월일 `{HHMMSS}`: 시분초 `{BUILD_NUM}`: 현재 빌드 파이프라인이 실행된 번호	`{YYYYMMDD}.{HHMMSS}`: 20200414.150938 `{YYYYMMDD}.{BUILD_NUM}`: 20220414.13
Base 이미지 저장소 추가	Base 이미지 저장소 추가 팝업창이 열립니다. 자세한 설명은 Base 이미지 저장소 추가를 참고 하세요.
Registry URL (`docker pull`)	Dockerfile 파일에서 사용하는 Base Image(Dockerfile의 FROM 절, docker pull)를 제공하는 이미지 저장소와 Registry URL(docker push)의 이미지 저장소가 다른 경우 docker pull을 위해 이미지 저장소를 선택하세요.
이미지빌드 도구	이미지 빌드 도구를 표시합니다.
빌드 전 명령어	Docker 이미지 빌드 전에 수행해야 하는 명령어가 있다면 Shell 명령어 형식으로 작성하세요.	`cp target/*.jar docker/`
이미지빌드 폴더	Docker 이미지 빌드를 특정 폴더에서 실행해야 하는 경우 체크박스 선택 후 폴더 경로를 입력하세요.	`docker`
도커파일	Dockerfile 파일명을 입력하세요.	`Dockerfile`
이미지빌드 옵션	이미지 빌드 도구에 추가 옵션 사용이 필요한 경우 입력하세요.	`--no-cache`
빌드 명령어	실제 실행하게 되는 이미지 빌드 명령어를 표시합니다.
빌드 후 명령어	Docker 이미지 빌드 후에 수행해야 하는 명령어가 있다면 Shell 명령어 형식으로 작성하세요.	`rm -rf docker/*.jar`

표. Docker Build 스테이지 입력 항목

예시 스크립트

예시의 결과로 만들어진 빌드 파이프라인 스크립트는 다음과 같습니다.

항목	설명
➊	빌드 전 명령어
➋	이미지빌드 폴더
➌	이미지빌드 옵션
➍	빌드 후 명령어

표. Docker Build 예시 스크립트 설명

Deploy to K8S

Kubernetes 배포를 수행하는 스테이지 입니다.

스테이지 종류로 Deploy to K8S를 선택합니다.

항목	설명
유형	배포 유형을 선택 헬름릴리스(헬름차트유형) 워크로드 ArgoCD
K8S 클러스터	K8S 클러스터를 선택 헬름릴리스(헬름차트유형) 선택 시 DevOps Console을 통해 배포된 헬름릴리스 목록이 나타납니다.
네임스페이스	네임스페이스를 선택하세요.
헬름릴리스	헬름릴리스를 선택하세요.
배포 방식	배포 방식을 선택 Recreate Rolling Update
Registry URL	Kubernetes에 배포가 될 이미지가 `docker push` 된 이미지 저장소를 선택하세요.
시크릿	시크릿 정보 입력방식을 선택 자동생성: Registry URL에서 선택한 이미지 저장소에 해당하는 시크릿을 `DevOps Console`에서 자동으로 생성해서 사용합니다. 기존 시크릿 사용: K8S 시크릿 관리를 통해 미리 생성한 시크릿 사용합니다.

표. Deploy to K8S 스테이지 입력 항목

Deploy to VM

VM 배포를 수행하는 스테이지 입니다.

스테이지 종류로 Deploy to VM을 선택합니다.

항목	설명
배포 구성	배포 구성 방법을 선택 배포 대상 설정(SSH 명령어/Agent 이용): SSH 명령어 또는 Agent를 활용해서 배포합니다. 직접 스크립트 작성: 사용자가 직접 모든 명령어를 입력해서 배포합니다.
배포 그룹	배포 그룹을 선택 VM 배포 추가하기 를 통해 추가할 수 있습니다.
배포 정보	배포 그룹에 저장된 내용이 자동 설정됩니다.
수동 배포	수동 배포 기본값을 선택 파이프라인 실행 시 수동 배포 관련 매개변수의 기본 설정값을 선택하세요.

표. Deploy to VM 스테이지 입력 항목

Trigger Build

원격으로 파이프라인을 실행하는 스테이지 입니다.

스테이지 종류로 Trigger Build를 선택합니다.

항목	설명
대상 파이프라인	원격으로 실행할 대상 파이프라인을 선택하세요. 파이프라인의 개발/운영 구분에 따라 선택 가능한 항목이 달라집니다.
매개변수 정보	대상 파이프라인의 매개변수 설정 여부에 따라 노출됩니다. 파이프라인 실행 시점에 입력한 매개변수 정보가 사용됩니다.

표. Trigger Build 스테이지 입력 항목

원격 실행 정보 확인

Trigger Build 스테이지를 통한 원격 실행 정보(상위/하위 파이프라인)는 빌드 상세보기 화면에서 확인 가능합니다.

기타 스테이지

항목	설명
Archive	애플리케이션 빌드 결과를 archive 합니다. archive 한 파일은 `Jenkins`에서 다운로드 받을 수 있습니다.
Code Quality	Code Quality 단계 실행을 위한 스테이지 입니다.
Custom	사용자가 원하는 형태로 직접 파이프라인 스크립트를 작성합니다.

표. 기타 스테이지 설정 항목

빌드 파이프라인

멀티브랜치 파이프라인