Jenkins 사용 방법¶
Jenkins 설치가 완료되었다면, 이제 실제로 작업을 정의하고 실행하는 방법을 알아보겠습니다. 가장 기본적인 대시보드 구성부터 Job(Item) 생성, 그리고 대표적인 프로젝트 유형에 대해 다룹니다.
1. 메인 대시보드 둘러보기¶
로그인 후 처음 보이는 화면입니다.
- 새로운 Item (New Item): 새로운 빌드 프로젝트(Job)를 생성합니다.
- 사람 (People): Jenkins 사용자 목록을 확인하고 관리합니다.
- 빌드 기록 (Build History): 실행된 빌드들의 상태(성공, 실패, 진행 중)를 한눈에 볼 수 있습니다.
- Jenkins 관리 (Manage Jenkins): 플러그인 관리, 시스템 설정, 보안 설정 등 관리자 기능을 수행합니다.
- 나의 보기 (My Views): 사용자가 관심 있는 Job들만 모아서 볼 수 있는 대시보드입니다.
2. 새로운 Job 생성하기¶
Jenkins에서 모든 작업의 단위는 Item 또는 Job이라고 부릅니다.
- 대시보드 좌측 메뉴에서 [새로운 Item]을 클릭합니다.
- 이름을 입력합니다. (예:
My-First-Project) - 프로젝트 유형을 선택합니다.
- [OK] 버튼을 누르면 세부 설정 화면으로 이동합니다.
3. 주요 프로젝트 유형 (Freestyle vs Pipeline)¶
Jenkins에는 여러 프로젝트 유형이 있지만, 가장 많이 사용되는 두 가지는 Freestyle Project와 Pipeline입니다.
🐣 Freestyle Project¶
가장 전통적이고 기본적인 방식입니다.
- 특징: 웹 UI에서 필요한 항목을 클릭하고 입력하여 빌드 과정을 구성합니다.
- 장점: 초보자가 직관적으로 이해하고 사용하기 쉽습니다.
- 단점: 빌드 과정이 복잡해지면 관리가 어렵고, 설정 변경 이력을 추적하기 어렵습니다(버전 관리 불가).
- 사용처: 단순한 스크립트 실행이나 테스트 용도.
🏗️ Pipeline (권장)¶
연속적인 작업의 흐름(파이프라인)을 코드로 정의하는 방식입니다.
- 특징: Groovy 문법을 기반으로 한 스크립트(
Jenkinsfile)를 작성하여 빌드 프로세스를 정의합니다. - 장점: 복잡한 빌드/배포 로직을 구현할 수 있으며, 코드로 작성되므로 Git과 같은 버전 관리 시스템에서 관리할 수 있습니다. (Infrastructure as Code)
- 단점: 문법(Declarative vs Scripted)을 익혀야 합니다.
- 사용처: 실제 프로덕션 환경의 CI/CD 파이프라인.
4. 간단한 빌드 테스트 (Hello World)¶
Freestyle Project를 사용하여 간단한 빌드를 테스트해봅시다.
- 새로운 Item -> Freestyle project 선택 -> OK.
- 설정 화면 하단 Build Steps 섹션으로 이동합니다.
- [Add build step] -> Execute shell (Windows의 경우 Execute Windows batch command) 선택.
-
명령창에 다음을 입력합니다:
-
하단 [저장] 클릭.
- 프로젝트 화면 좌측의 [지금 빌드 (Build Now)] 클릭.
- 아래 Build History에
#1이 나타나면 클릭 후 [Console Output]을 확인합니다. Hello, Jenkins!가 출력되고SUCCESS로 끝나면 성공입니다.