Jenkins 설치 및 초기 설정 따라하기 | Ubuntu 설치부터 첫 빌드 확인까지 순서대로 정리

젠킨스를 처음 설치할 때 가장 어려운 부분은 명령어 자체보다 설치 후 웹 화면에서 무엇을 순서대로 눌러야 하는지입니다.

특히 초보자는 Unlock Jenkins 화면, 초기 비밀번호 확인, 플러그인 설치, 관리자 계정 생성, 새 Job 만들기, 첫 빌드 로그 확인까지 흐름이 한 번에 안 잡히는 경우가 많습니다.

그래서 이번 글은 개념 설명을 길게 늘어놓기보다, Ubuntu 서버에 Jenkins를 설치하고 웹 화면에서 첫 빌드 확인까지 가는 실제 순서만 따라가기 쉽게 정리하겠습니다.

• 진행 기준 환경: Ubuntu 서버
• 목표: Jenkins 설치 후 웹 접속 + 첫 빌드 로그 확인
• 읽는 방법: 위에서 아래로 그대로 따라 하면 됨

이번 글의 실제 흐름

1단계 Ubuntu에 JDK와 Jenkins 설치

2단계 브라우저에서 Unlock Jenkins 화면 확인

3단계 초기 비밀번호 확인 후 관리자 설정 진행

4단계 New Item으로 첫 Job 생성

마지막 Console Output에서 빌드 성공 여부 확인

1. Ubuntu 서버에 Jenkins 설치하기

이 단계는 터미널에서 그대로 실행하면 됩니다

먼저 Ubuntu 서버에 접속한 뒤 JDK를 설치합니다.

sudo apt update
sudo apt install -y fontconfig openjdk-17-jre
java -version

정상이라면 Java 버전이 출력됩니다.

이제 Jenkins 저장소를 추가합니다.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

그다음 Jenkins를 설치합니다.

sudo apt update
sudo apt install -y jenkins

설치가 끝나면 Jenkins 서비스를 시작합니다.

sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

여기서 active (running) 상태가 보이면 정상입니다.

여기서 먼저 확인할 것

• Java가 설치됐는지 java -version으로 확인
• Jenkins 서비스가 올라왔는지 systemctl status jenkins로 확인
• 8080 포트가 열려 있는지 확인

2. 브라우저에서 Unlock Jenkins 화면 확인

설치가 끝났다면 가장 먼저 이 화면이 떠야 합니다

브라우저에서 아래 주소로 접속합니다.

http://서버IP:8080

처음 접속하면 Jenkins가 바로 대시보드를 보여주는 게 아니라, Unlock Jenkins 화면을 먼저 보여줍니다.

공식 Jenkins 문서 기준 Unlock Jenkins 실제 화면

이 단계에서는 아직 로그인이 아닙니다.

먼저 초기 관리자 비밀번호를 서버에서 확인해야 다음 단계로 넘어갈 수 있습니다.

Jenkins 설치 직후 가장 먼저 보게 되는 핵심 화면은 대시보드가 아니라 Unlock Jenkins 화면입니다.

3. initialAdminPassword 확인 후 화면에 입력하기

이 단계에서 가장 많이 막힙니다

초기 관리자 비밀번호는 아래 명령어로 확인합니다.

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

출력된 긴 문자열을 복사해서 아까 본 Unlock Jenkins 화면의 입력 칸에 넣고 Continue를 누르면 됩니다.

공식 Jenkins 문서 기준 initialAdminPassword 확인 실제 화면

이후에는 보통 아래 순서로 진행됩니다.

1. 추천 플러그인 설치
2. 관리자 계정 생성
3. Jenkins URL 확인
4. Jenkins 시작

여기까지 끝나면 이제 Jenkins 메인 화면에서 실제 작업을 만들 수 있습니다.

이 단계에서 자주 하는 실수

• 초기 비밀번호 파일 경로를 잘못 보는 경우
• 복사한 비밀번호 앞뒤 공백까지 같이 넣는 경우
• 플러그인 설치가 끝나기 전에 브라우저를 닫는 경우

4. New Item으로 첫 Job 만들기

웹 설정이 끝났다면 이제 실제 작업을 하나 만들어야 합니다

Jenkins에 들어왔다면 이제 대시보드에서 New Item을 눌러 첫 작업을 만듭니다.

처음에는 복잡한 파이프라인보다, 새 작업을 하나 만들고 빌드가 도는 흐름을 먼저 보는 것이 좋습니다.

공식 Jenkins 문서 기준 New Item 실제 화면

기본 흐름은 아래처럼 보면 됩니다.

Dashboard
 → New Item
 → 작업 이름 입력
 → 프로젝트 타입 선택
 → OK

실무에서는 프로젝트 타입이 다양하지만, 초반에는 중요한 게 하나입니다.

새 작업을 만들고, 빌드를 실행해보고, 로그를 확인하는 흐름을 먼저 익히는 것입니다.

여기서 체크할 포인트
- Item name 입력
- 원하는 작업 타입 선택
- 생성 후 저장까지 마무리

5. Build Now 실행 후 Console Output 확인

설치가 끝났는지 판단하는 가장 중요한 단계입니다

Job을 만들고 나면 좌측 메뉴 또는 작업 화면에서 Build Now를 눌러 첫 빌드를 실행합니다.

그리고 바로 아래 순서로 결과를 확인합니다.

Build Now 클릭
 → Build History 확인
 → 방금 실행된 빌드 번호 클릭
 → Console Output 열기

빌드가 정상이라면 Console Output의 마지막 부분에서 성공 메시지를 확인할 수 있습니다.

공식 Jenkins 문서 기준 Console Output 실제 화면

여기서 중요한 건 딱 하나입니다.

Jenkins 설치의 완료 기준은 웹 화면이 뜨는 게 아니라, Console Output에서 실제 빌드 결과를 확인하는 것입니다.

처음 Jenkins를 붙일 때는 설치 완료보다 Build Now → Console Output 확인까지 가는 흐름을 먼저 익히는 것이 더 중요합니다.

6. 따라하다가 자주 막히는 포인트

설치 글에서는 이 부분까지 같이 봐야 실전성이 생깁니다

• 웹 접속이 안 되는 경우
  • Jenkins 서비스 상태 확인
  • 8080 포트 확인
• Unlock Jenkins 화면에서 못 넘어가는 경우
  • initialAdminPassword 파일 경로 확인
  • 복사한 문자열이 정확한지 확인
• 플러그인 설치 중 멈춘 것처럼 보이는 경우
  • 잠시 기다리면서 진행 상태 확인
  • 네트워크가 막혀 있지 않은지 확인
• 새 Job은 만들었는데 빌드가 안 되는 경우
  • 저장이 제대로 됐는지 확인
  • Build Now 버튼을 눌렀는지 확인
  • Console Output에서 첫 번째 에러 줄부터 보기

이 글을 읽을 때 기준점

• 설치 명령어는 Ubuntu 기준으로 따라가기
• 웹 화면은 Unlock Jenkins → New Item → Console Output 흐름으로 보기
• 첫 빌드 결과 확인까지 가야 설치가 끝난 것으로 보기

마무리

설치 글이라면 흐름이 가장 중요합니다

이번 글은 일부 설정을 전부 다 담는 것보다, 설치 방법의 실제 순서와 웹 화면 흐름을 맞추는 것에 초점을 맞췄습니다.

즉,

• Ubuntu에서 설치하고
• Unlock Jenkins를 보고
• 초기 비밀번호를 입력하고
• New Item으로 작업을 만들고
• Console Output에서 결과를 확인하는 순서입니다.

처음 Jenkins를 접하는 독자라면 이 흐름만 제대로 잡아도 다음 글인 Git 연동, 자동 빌드, 배포 단계로 자연스럽게 넘어갈 수 있습니다.

설치 가이드는 정보가 많다고 좋은 게 아니라, 실제 화면과 실제 순서가 정확히 맞아야 따라가기 쉬워집니다.