Jenkins 인터페이스 탐색: 첫 번째 작업 생성 및 실행

소개

Jenkins 와 함께하는 첫 실습에 오신 것을 환영합니다. Jenkins 는 소프트웨어를 빌드, 테스트 및 배포하는 데 사용되는 강력한 오픈 소스 자동화 서버로, 지속적 통합 및 지속적 배포 (CI/CD) 라고도 합니다.

이 실습에서는 Jenkins 사용자 인터페이스의 기본 측면에 익숙해질 것입니다. 주요 대시보드를 안내하고, 첫 번째 간단한 프로젝트를 생성 및 구성하는 방법, 빌드를 실행하고 결과를 검사하는 방법을 보여드리겠습니다. Jenkins 서비스는 이 환경에 이미 설치되어 실행 중이므로, 기능 탐색에 직접 집중할 수 있습니다.

이 실습이 끝나면 다음을 수행할 수 있습니다.

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

시작해 봅시다.

Jenkins 대시보드 액세스 및 탐색

이 단계에서는 Jenkins 웹 인터페이스에 로그인하고 기본 대시보드에 익숙해지는 과정을 진행합니다. Jenkins 서비스는 이미 컨테이너 내에서 실행 중입니다.

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

Jenkins login page

주요 Jenkins 대시보드가 나타납니다. 주요 구성 요소를 살펴보는 시간을 가지십시오:

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

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

Freestyle 프로젝트 생성

이 단계에서는 "Freestyle project" 유형을 사용하여 첫 번째 Jenkins 작업을 생성합니다. 프리스타일 프로젝트는 매우 유연하고 사용하기 쉬운 옵션으로, 초보자와 광범위한 자동화 작업에 완벽합니다.

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

Jenkins project creation page

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

Jenkins project configuration page with build step

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

저장 후 Jenkins는 새로 생성된 프로젝트인 My-First-Job의 메인 페이지로 리디렉션됩니다.

빌드 작업 실행

이 단계에서는 방금 생성한 작업을 실행하거나 "빌드"합니다. 작업을 실행한다는 것은 구성한 단계를 실행하는 것을 의미합니다.

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

My-First-Job 프로젝트 페이지에서 왼쪽 탐색 사이드바를 확인합니다. Build Now라는 옵션을 볼 수 있습니다.

Jenkins project page Build Now button

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

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

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

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

콘솔 출력 보기

이 단계에서는 빌드 결과를 확인하는 방법을 배웁니다. 출력 검토는 자동화 프로세스에서 매우 중요한 부분입니다. 이는 정확히 무슨 일이 일어났는지, 그리고 성공했는지 여부를 알려주기 때문입니다.

My-First-Job 프로젝트 페이지에서 왼쪽 하단 모서리에 있는 빌드 기록 (Build History) 섹션을 확인합니다. 성공을 나타내는 녹색 원과 함께 #1로 표시된 첫 번째 빌드가 보일 것입니다.
빌드 번호 #1을 클릭하여 해당 특정 빌드의 상세 페이지로 이동합니다.
빌드 페이지에서는 빌드가 실행된 시간 등 다양한 세부 정보를 볼 수 있습니다. 디버깅을 위해 여기서 가장 중요한 링크는 **콘솔 출력 (Console Output)**입니다. 왼쪽 사이드바에서 Console Output을 클릭합니다.

Console output link on build details page

콘솔 출력 페이지에는 빌드 중에 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 기능을 탐색할 준비가 되었습니다.