Jenkins 인터페이스 살펴보기: 첫 번째 작업 생성 및 실행

소개

Jenkins 를 활용한 첫 번째 실습에 오신 것을 환영합니다. Jenkins 는 소프트웨어 빌드, 테스트 및 배포를 자동화하는 강력한 오픈 소스 자동화 서버로, 지속적 통합 및 지속적 배포 (CI/CD) 를 구현하는 데 널리 사용됩니다.

이번 실습에서는 Jenkins 사용자 인터페이스의 핵심 요소들을 익히게 됩니다. 메인 대시보드를 살펴보고, 첫 번째 간단한 프로젝트를 생성 및 구성한 뒤, 빌드를 실행하고 결과를 확인하는 과정을 안내합니다. 이 환경에는 Jenkins 서비스가 이미 설치되어 실행 중이므로, 기능 탐색에 바로 집중하실 수 있습니다.

이번 실습을 마치면 다음을 수행할 수 있게 됩니다:

Jenkins 메인 대시보드 탐색
새로운 Freestyle 프로젝트 생성
수동으로 빌드 작업 실행
빌드 기록 및 콘솔 출력 확인

이제 시작해 보겠습니다.

Jenkins 대시보드 접속 및 탐색

이 단계에서는 Jenkins 웹 인터페이스에 로그인하고 메인 대시보드에 익숙해지는 시간을 갖습니다. Jenkins 서비스는 이미 컨테이너 내에서 실행 중입니다.

먼저 Jenkins 웹 인터페이스에 접속합니다. LabEx 화면 상단의 Desktop Interface 탭을 클릭하세요. 가상 데스크톱 내에서 Firefox 웹 브라우저를 엽니다. 브라우저는 자동으로 http://localhost:8080으로 연결되므로 URL 을 직접 입력할 필요가 없습니다. 별도의 로그인은 필요하지 않습니다.

Jenkins 대시보드

Jenkins 메인 대시보드가 나타납니다. 주요 구성 요소를 살펴보세요:

탐색 사이드바 (왼쪽): 주요 탐색 메뉴입니다. New Item(새 작업 생성) 이나 Build History(모든 빌드의 전체 보기) 와 같은 중요한 링크를 찾을 수 있습니다.
메인 콘텐츠 영역: 생성된 작업 목록이 표시되는 곳입니다. 처음에는 비어 있습니다.

대시보드에 익숙해졌다면, 이제 첫 번째 프로젝트를 생성할 준비가 되었습니다.

Freestyle 프로젝트 생성

이 단계에서는 "Freestyle project" 유형을 사용하여 첫 번째 Jenkins 작업을 생성합니다. Freestyle 프로젝트는 매우 유연하고 사용하기 쉬워 초보자에게 적합하며, 다양한 자동화 작업에 활용할 수 있습니다.

Jenkins 웹 인터페이스 왼쪽 탐색 사이드바에서 New Item을 클릭합니다.
다음 페이지에서 프로젝트 이름을 입력하고 유형을 선택합니다.
- Enter an item name 필드에 My-First-Job을 입력합니다.
- 옵션 목록에서 Freestyle project를 선택합니다.
- 하단의 OK 버튼을 클릭합니다.

Jenkins 프로젝트 생성 페이지

이제 프로젝트 구성 페이지로 이동합니다. 이곳에서 작업의 동작을 정의합니다. 이번 실습에서는 간단한 빌드 단계를 하나 추가하겠습니다. Build Steps 섹션까지 아래로 스크롤하세요.
Add build step 드롭다운 버튼을 클릭하고 Execute shell을 선택합니다. 이를 통해 빌드 과정에서 셸 명령어를 실행할 수 있습니다.
명령 입력 상자가 나타나면 다음 명령어를 입력합니다:
```
echo "Hello from my first Jenkins job!"
```

빌드 단계가 포함된 Jenkins 프로젝트 구성 페이지

마지막으로 페이지 하단으로 스크롤하여 Save 버튼을 클릭합니다.

저장 후, Jenkins 는 새로 생성된 프로젝트 My-First-Job의 메인 페이지로 이동합니다.

빌드 작업 실행

이 단계에서는 방금 생성한 작업을 실행 (빌드) 합니다. 작업을 실행한다는 것은 구성한 단계를 실제로 수행한다는 의미입니다.

현재 My-First-Job 프로젝트 페이지에 있어야 합니다. 만약 다른 페이지로 이동했다면, Jenkins 메인 대시보드에서 해당 프로젝트 이름을 클릭하여 돌아올 수 있습니다.

My-First-Job 프로젝트 페이지의 왼쪽 탐색 사이드바를 확인하세요. Build Now라는 옵션이 보일 것입니다.

Jenkins 프로젝트 페이지의 Build Now 버튼

Build Now를 클릭하여 빌드 프로세스를 시작합니다.

클릭하면 새로운 빌드가 예약됩니다. 왼쪽 하단의 Build History 섹션에 빌드가 나타나는 것을 볼 수 있습니다. 빌드에는 #1부터 시작하는 번호가 할당됩니다.

Jenkins 빌드 기록

빌드 번호 옆에 작은 상태 아이콘이 나타납니다. 깜빡이는 녹색 아이콘은 빌드가 진행 중임을 의미합니다. 녹색 원은 빌드가 성공했음을 나타냅니다. 작업이 매우 간단하므로 1~2 초 내에 완료될 것입니다.

이제 첫 번째 빌드를 성공적으로 트리거했습니다.

콘솔 출력 확인

이 단계에서는 빌드 결과를 확인하는 방법을 배웁니다. 출력 내용을 검토하는 것은 자동화 프로세스에서 매우 중요한 부분으로, 정확히 어떤 일이 일어났는지, 성공했는지 여부를 알려줍니다.

My-First-Job 프로젝트 페이지 왼쪽 하단의 Build History 섹션을 확인하세요. 성공을 의미하는 녹색 원과 함께 첫 번째 빌드인 #1이 표시되어 있을 것입니다.
빌드 번호 #1을 클릭하여 해당 빌드의 상세 페이지로 이동합니다.
빌드 페이지에는 빌드 실행 시간 등 다양한 정보가 표시됩니다. 디버깅을 위해 가장 중요한 링크는 Console Output입니다. 왼쪽 사이드바에서 Console Output을 클릭하세요.

빌드 상세 페이지의 콘솔 출력 링크

콘솔 출력 페이지에는 빌드 중에 Jenkins 가 수행한 모든 작업의 상세 로그가 표시됩니다. Jenkins 가 빌드를 시작하고, 셸 명령어를 실행한 뒤, 빌드를 완료로 표시한 과정을 확인할 수 있습니다.

출력 내용은 다음과 비슷할 것입니다:

Jenkins 콘솔 출력

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

보시다시피 로그에는 구성했던 echo 명령어와 그 결과인 Hello from my first Jenkins job!이 포함되어 있습니다. 마지막의 Finished: SUCCESS 상태는 작업이 오류 없이 실행되었음을 확인해 줍니다.

요약

입문 실습을 성공적으로 마치신 것을 축하드립니다! Jenkins 의 세계에 첫발을 내디디셨습니다.

이번 실습을 통해 다음을 배웠습니다:

Jenkins 대시보드에 접속하고 주요 구성 요소 파악하기
처음부터 새로운 Freestyle 프로젝트 생성하기
간단한 "Execute shell" 빌드 단계 구성하기
프로젝트 빌드 수동으로 트리거하기
빌드 기록과 상세 콘솔 출력을 찾아 결과를 검증하기

이러한 기초 기술은 더 복잡하고 강력한 자동화 파이프라인을 구축하기 위한 토대가 됩니다. 이제 더 고급 Jenkins 기능을 탐색할 준비가 되었습니다.