TobeDevOps에서는 프로젝트의 자동 빌드를 위해 GitLab을 사용합니다.

TobeDevOps는 프로젝트의 코드 변경 사항을 자동으로 빌드. 테스트, 배포하는 CI 도구인 GitLab-Runner를 사용합니다. CI/CD 파이프라인이 구성된 Git Repository에 코드 변경 사항을 Push 하거나 브랜치를 통합하는 Merge와 같은 이벤트가 발생하면 자동으로 테스트, 빌드, 배포 작업이 진행됩니다.

소스 빌드, 도커 이미지 생성 및 업로드, GitOps 업데이트 3가지의 Job과정이 기본 제공되며 WEB의 개발 환경은 넥사크로 테스트 단계(Lint)가 추가됩니다.

서버 구분	사용 환경	Job	설명
WEB	DEV	nexacro_test	넥사크로 소스 테스트 (Lint 연동)
WEB WAS XENI	DEV STG PRD	build_source	프로젝트 소스 빌드
		build_push_docker_image	도커 이미지 생성 및 이미지 저장소 업로드
		update_gitops	GitOps에 이미지 버전 업데이트

Lint란 넥사크로 소스 테스트 도구로 포털에서 프로젝트 Web 컨테이너 생성 시 개발 환경의 빌드 단계에서 진행되도록 구성되어 Lint 사용법은 투비소프트 고객센터로 문의해 주세요.

빌드 조회

내가 포함된 프로젝트 카드를 확인하고 카드를 선택하여 Pipeline 별 상세 정보를 확인합니다.

[빌드] 메뉴를 선택하여 사용자가 포함된 프로젝트 카드 리스트를 확인합니다.

화면 상단에 프로젝트 구분 탭을 사용하여 상태 별 프로젝트 목록을 확인할 수 있으며 기본 상태 값은 [Running]입니다. [All] 탭 선택 시 전체 프로젝트 목록을 확인할 수 있습니다.

이미지_2024-07-30_101033675

내가 포함된 프로젝트가 카드 형태로 나타나며 각 프로젝트에 생성된 서버(DB 제외) 클릭 시 빌드 내역을 확인할 수 있습니다.

이미지_2024-07-30_101135964

프로젝트 카드의 서버를 선택하면 하단에 브랜치 및 Pipline 영역이 노출됩니다.

이미지_2024-07-30_101212149

[Branch]에서는 브랜치를 수동 빌드할 수 있습니다. 콤보 박스로 빌드 할 Branch 선택 하고 [Run Bulid] 버튼을 클릭하면 브랜치 및 태그가 수동으로 빌드 진행됩니다.

선택한 브랜치의 빌드 권한이 없으면 버튼은 사용할 수 없습니다.

이미지_2024-07-30_101307778

수동 빌드가 발생하거나 Git Repository의 변경 사항을 확인하기 위해 Pipeline 새로 고침을 클릭하여 상태를 갱신합니다.

이미지_2024-07-30_101436844

[Pipeline 목록]에서는 컨테이너 별 Git Repository의 빌드 현황(CI/CD Pipeline) 을 확인합니다.

조회할 빌드 내역을 배포 환경에 따라 확인할 수 있으며 [All]탭 선택 시 전체 목록이 확인됩니다. Pipline 목록은 최신 진행된 3건이 조회되며 Pipeline의 status를 함께 확인할 수 있습니다.

이미지_2024-07-30_101516488

Pipeline status와 status 별 의미는 Gitlab 매뉴얼 Pipline API에서 확인해 주세요.

각 목록의 Pipeline 클릭 시 Git Repository로 이동하여 선택한 Pipeline 상세 정보를 확인할 수 있고, More 버튼 클릭 시 선택된 서버의 전체 Pipeline 목록을 확인할 수 있습니다.

Stages 컬럼에서는 Pipeline 별 Job 상태 및 현황을 보여줍니다. 각 아이콘에 마우스 오버하면 tooltip으로 Job의 명칭과 진행 상태를 확인할 수 있으며 클릭 시 Git Repository로 이동하여 Job의 진행 상태를 상세 log로 확인할 수 있습니다.

이미지_2024-07-30_102006640

빌드 관리

프로젝트 변경 사항이 발생하면 GitLab-Runner를 통해 자동으로 빌드가 진행됩니다.

브랜치 및 태그 별로 빌드 시점의 차이가 발생하며 배포 환경 별 사용 기능은 프로젝트 권한에 따라 달라집니다.

개발 환경	브랜치, 태그	빌드 방법	프로젝트 권한
PRD	release-*	검증 브랜치 태깅	프로젝트 관리자
STG	Main Branch	개발 브랜치를 검증 브랜치로 Merge 승인	프로젝트 관리자
DEV	Develop Branch	개발 소스 git push	프로젝트 관리자, 멤버

개발 브랜치(Develop Branch)

개발 브랜치는 서버의 프로젝트 개발 환경에서 사용되며 포털 화면의 [빌드 > Pipeline 목록 > DEV 탭]에서 확인합니다.

개발 브랜치는 프로젝트 관리자 및 멤버 권한의 사용자가 제한없이 로컬 개발 환경에서 변경한 소스 코드를 push 할 수 있으며 자동으로 빌드 진행됩니다.

로컬 개발 환경 구성 방법은 [Getting Started_초보자 가이드]를 확인하세요.

검증 브랜치(Main Branch)

검증 브랜치는 서버의 프로젝트 검증 화면에서 사용되며 포털 화면의 [빌드 > Pipeline 목록 > STG 탭]에서 확인합니다.

검증 브랜치는 프로젝트 관리자 권한의 사용자가 Merge 승인하면 자동으로 빌드가 진행됩니다.

운영 태그(release-*)

운영 태그(release-*)란 빌드는 프로젝트 운영 환경에서 사용되며 포털 화면의 [빌드 > Pipeline 목록 > PRD 탭]에서 확인합니다.

운영 태그(release-*)는 프로젝트 관리자 권한의 사용자가 TobeDevOps 내 규칙에 맞게 Git tagging(태깅) 하면 자동으로 빌드 진행됩니다.