콘텐츠로 이동

Jenkins 사용 방법

Jenkins 설치가 완료되었다면, 이제 실제로 작업을 정의하고 실행하는 방법을 알아보겠습니다. 가장 기본적인 대시보드 구성부터 Job(Item) 생성, 그리고 대표적인 프로젝트 유형에 대해 다룹니다.

1. 메인 대시보드 둘러보기

로그인 후 처음 보이는 화면입니다.

  • 새로운 Item (New Item): 새로운 빌드 프로젝트(Job)를 생성합니다.
  • 사람 (People): Jenkins 사용자 목록을 확인하고 관리합니다.
  • 빌드 기록 (Build History): 실행된 빌드들의 상태(성공, 실패, 진행 중)를 한눈에 볼 수 있습니다.
  • Jenkins 관리 (Manage Jenkins): 플러그인 관리, 시스템 설정, 보안 설정 등 관리자 기능을 수행합니다.
  • 나의 보기 (My Views): 사용자가 관심 있는 Job들만 모아서 볼 수 있는 대시보드입니다.

2. 새로운 Job 생성하기

Jenkins에서 모든 작업의 단위는 Item 또는 Job이라고 부릅니다.

  1. 대시보드 좌측 메뉴에서 [새로운 Item]을 클릭합니다.
  2. 이름을 입력합니다. (예: My-First-Project)
  3. 프로젝트 유형을 선택합니다.
  4. [OK] 버튼을 누르면 세부 설정 화면으로 이동합니다.

3. 주요 프로젝트 유형 (Freestyle vs Pipeline)

Jenkins에는 여러 프로젝트 유형이 있지만, 가장 많이 사용되는 두 가지는 Freestyle ProjectPipeline입니다.

🐣 Freestyle Project

가장 전통적이고 기본적인 방식입니다.

  • 특징: 웹 UI에서 필요한 항목을 클릭하고 입력하여 빌드 과정을 구성합니다.
  • 장점: 초보자가 직관적으로 이해하고 사용하기 쉽습니다.
  • 단점: 빌드 과정이 복잡해지면 관리가 어렵고, 설정 변경 이력을 추적하기 어렵습니다(버전 관리 불가).
  • 사용처: 단순한 스크립트 실행이나 테스트 용도.

🏗️ Pipeline (권장)

연속적인 작업의 흐름(파이프라인)을 코드로 정의하는 방식입니다.

  • 특징: Groovy 문법을 기반으로 한 스크립트(Jenkinsfile)를 작성하여 빌드 프로세스를 정의합니다.
  • 장점: 복잡한 빌드/배포 로직을 구현할 수 있으며, 코드로 작성되므로 Git과 같은 버전 관리 시스템에서 관리할 수 있습니다. (Infrastructure as Code)
  • 단점: 문법(Declarative vs Scripted)을 익혀야 합니다.
  • 사용처: 실제 프로덕션 환경의 CI/CD 파이프라인.

4. 간단한 빌드 테스트 (Hello World)

Freestyle Project를 사용하여 간단한 빌드를 테스트해봅시다.

  1. 새로운 Item -> Freestyle project 선택 -> OK.
  2. 설정 화면 하단 Build Steps 섹션으로 이동합니다.
  3. [Add build step] -> Execute shell (Windows의 경우 Execute Windows batch command) 선택.
  4. 명령창에 다음을 입력합니다:

    echo "Hello, Jenkins!"
    

  5. 하단 [저장] 클릭.

  6. 프로젝트 화면 좌측의 [지금 빌드 (Build Now)] 클릭.
  7. 아래 Build History#1이 나타나면 클릭 후 [Console Output]을 확인합니다.
  8. Hello, Jenkins!가 출력되고 SUCCESS로 끝나면 성공입니다.