빌드 템플릿
빌드 템플릿을 이용하면 워크플로우 엔진 기반의 편의성과 제공되는 여러 템플릿을 이용하여 DevOps CI/CD를 손쉽게 구성할 수 있다. 또한, 빌드 템플릿은 파이프라인 등록과 사용을 역할에 따라 기능을 분리함으로써 관리자를 통한 중앙 통제를 가능하게 한다. 이를 통해서 DevOps 기반의 CI/CD를 전사 표준화 할 수 있다.
1. 빌드 템플릿 목록
- 빌드 템플릿 ID & 설명
-
빌드 템플릿 식별을 위한 고유한 ID와 빌드 템플릿 설명
- 배포 리소스 유형
-
애플리케이션 빌드 및 배포에 사용되는 리소스 유형
항목 설명 Gitlab
Gitlab에 저장된 리소스를 사용
Container Image
컨테이너 이미지를 사용
Object Storage
Object Storage에 저장된 리소스를 사용
FTP
특정 FTP 서버에 위치하는 리소스를 사용
ITSM
ITSM을 통해 전달 받은 리소스를 사용
- 애플리케이션 유형
-
빌드 템플릿이 사용될 애플리케이션 유형
항목 설명 Stateless Online
쿠버네티스 Deployment로 배포될 애플리케이션
CI/CD Pipeline
파이프라인 수행을 위한 애플리케이션
- 관계 기관
-
빌드 템플릿을 생성한 관계 기관 정보
- 버전 개수
-
빌드 템플릿과 관련된 파이프라인 버전 개수
- 참조 개수
-
빌드 템플릿을 참조하고 있는 애플리케이션 개수
- 우선 순위
-
애플리케이션 템플릿에서 표시될 순서
- 사용 여부
-
애플리케이션 템플릿에 빌드 템플릿 노출 여부
- 액션
-
항목 설명 빌드 템플릿 수정
등록된 빌드 템플릿 수정
빌드 템플릿 삭제
등록된 빌드 템플릿 삭제
2. 빌드 템플릿 추가
2.1. 기본 설정
빌드 템플릿 관리에 필요한 기본 정보를 등록한다.
- 빌드 템플릿 명
-
빌드 템플릿 식별을 위한 고유한 이름을 입력한다.
-
제약사항 : 최대 64 문자
-
- 애플리케이션 유형
-
빌드 템플릿을 사용할 애플리케이션 유형을 선택한다.
-
제약사항 : Stateless Online / CICD Pipeline
-
기본값 : Stateless Online
-
|
클러스터가 Legacy인 경우, CI/CD Pipeline만 선택할 수 있다. |
- 배포 리소스 유형
-
빌드 템플릿에서 사용될 리소스 유형을 선택한다.
-
제약사항 : Gitlab / Container Image / Object Storage / FTP / ITSM
-
기본값 : Gitlab
-
- 아이콘
-
빌드 템플릿을 대표하는 아이콘을 선택한다.
-
제약사항 : 없음
-
- 관계 기관
-
빌드 템플릿을 구성하는 관계 기관을 입력한다.
-
제약사항 : 정보성
-
- 빌드 템플릿 설명
-
빌드 템플릿 관리에 필요한 추가 구성 정보를 입력한다.
-
제약사항 : 최대 2048 문자
-
- 우선 순위
-
클러스터 목록에서 표시될 우선 순위를 선택한다.
-
제약사항 : 숫자 1 ~ 10 선택 (작은 숫자 우선)
-
기본값 : 5
-
- 사용 여부
-
사용 여부에 대한 On/Off를 선택한다.
-
제약사항 : On / Off
-
기본값 : On
-
2.2. CI/CD 버전 정보
빌드 템플릿은 버전별 CI/CD 파이프라인으로 구성되며 사용자는 특정 버전의 파이프라인을 선택하여 수행한다.
- 파이프라인 명 & 설명
-
파이프라인 식별을 위한 고유한 이름과 파이프라인 설명
- 사용 여부
-
파이프라인 사용 여부
- 액션
-
항목 설명 파이프라인 수정
등록된 파이프라인 수정
파이프라인 삭제
등록된 파이프라인 삭제
파이프라인 복제
등록된 파이프라인 복제
2.2.1. CI/CD 버전 추가
파이프라인 관리에 필요한 기본 정보를 등록한다.
- 파이프라인 버전
-
파이프라인 버전 정보는 시스템에서 자동으로 채번된다.
-
제약사항 : 자동 채번
-
- 파이프라인 ID
-
파이프라인 식별을 위한 고유한 ID를 입력한다.
-
제약사항 : 없음
-
- 파이프라인 설명
-
파이프라인 관리에 필요한 추가 구성 정보를 입력한다.
-
제약사항 : 없음
-
- 빌드 넘버 유형
-
파이프라인에서 사용할 빌드 넘버 유형을 선택한다.
항목 설명 자동 채번
자동으로 채번되는 빌드 넘버를 사용
사용자 지정 키
사용자가 별도로 지정한 키를 빌드 넘버로 사용
- Agent Label
-
파이프라인을 수행할 디폴트 Agent를 선택한다. Agent는 Jenkins에서 파이프라인이 수행될 노드를 의미한다.
-
제약사항 : 없음
-
- 파이프라인 Timeout
-
파이프라인의 디폴트 Timeout 시간을 입력한다.
-
제약사항 : 분
-
기본값 : 60
-
- 빌드 이력 유지 기간
-
Jenkins에서 빌드 이력 정보를 유지할 기간을 입력한다.
-
제약사항 : 일
-
기본값 : 7
-
- 빌드 이력 유지 개수
-
Jenkins에서 빌드 이력 정보를 유지할 개수를 입력한다.
-
제약사항 : 개수
-
기본값 : 100
-
- 워크스페이스 초기화 여부
-
파이프라인이 수행되는 워크스페이스의 초기화 여부를 선택한다.
-
제약사항 : On / Off
-
기본값 : Off
-
- 사용 여부
-
파이프라인의 사용 여부를 선택한다.
-
제약사항 : On / Off
-
기본값 : On
-
2.2.2. 파이프라인 생성
빌드 템플릿에서는 다양한 방법으로 파이프라인을 손쉽게 구성할 수 있도록 기능을 제공한다.
- 새로운 파이프라인
-
처음부터 새롭게 파이프라인을 구성한다.
- 템플릿으로 생성
-
기존에 등록된 파이프라인 템플릿을 통해서 파이프라인을 구성한다.
- 기존 데이터로 생성
-
기존에 등록된 빌드 템플릿의 파이프라인을 이용해서 파이프라인을 구성한다.
|
동일한 워크스페이스에 등록된 파이프라인만 참조할 수 있다. 다른 워크스페이스의 파이프라인을 참조해야 하는 경우, 해당 파이프라인을 다운로드하고 "JSON 파일로 생성" 기능을 통해서 생성할 수 있다. |
- JSON 파일로 생성
-
다운로드 받은 파이프라인 JSON을 이용해서 파이프라인을 구성한다.
2.2.3. 파이프라인 상세
워크플로우 엔진 기반의 파이프라인 구성을 지원한다. Stage와 Step을 통해서 원하는 기능을 구성할 수 있다.
- Stage
-
Step을 수행하기 위한 기반 환경을 구성한다.
- Step
-
파이프라인에서 수행할 스크립트를 작성한다.
2.2.5. PRE & POST 스크립트
파이프라인에서 사용할 Shell Script를 템플릿으로 제공한다.
- Initialization 스크립트
-
파이프라인 시작 시점에 호출된다.
- Finally 스크립트
-
파이프라인 마지막 종료 시점에 호출된다.
- Common 스크립트
-
파이프라인 전체에서 사용자가 참조할 수 있다.
2.2.7. 스텝 알림 템플릿
파이프라인의 모든 스텝에서 공통으로 사용될 스텝 성공 및 실패 정보 스크립트를 정의한다. 관리자가 필요에 따라 수정할 수 있다.
- 알림 템플릿
-
성공 또는 실패 알림을 선택한다.
-
제약사항 : Success 알림 / Fail 알림
-
- 알림 제목
-
파이프라인의 성공 또는 실패 알림의 제목을 입력한다.
- 알림 내용
-
파이프라인의 성공 또는 실패 알림의 내용을 입력한다.
- 발신자
-
파이프라인의 성공 또는 실패 알림의 발신자를 선택한다.
-
제약사항 : 해당 워크스페이스에 등록된 사용자 목록 중 선택
-
- 알림 유형
-
파이프라인의 성공 또는 실패 알림의 유형을 선택한다.
-
제약사항 : Info / Warning / Error
-
- 알림 수신범위
-
파이프라인의 성공 또는 실패 알림의 수신범위를 선택한다.
항목 설명 사용자
해당 워크스페이스에 등록된 사용자 중 선택 목록
프로젝트
파이프라인이 수행되는 프로젝트에 등록된 사용자 전체 목록
워크스페이스
파이프라인이 수행되는 워크스페이스에 등록된 사용자 전체 목록
전체 사용자
ADM에 등록된 사용자 전체 목록
