Jenkins 설치 2025년 최신 가이드 윈도우 리눅스 도커 기반 환경 구축 초기 설정 상세 보기

🚀 Jenkins 설치 2025년 최신 가이드 확인하기

Jenkins는 소프트웨어 개발에서 지속적인 통합(CI)과 지속적인 배포(CD)를 자동화하는 데 사용되는 가장 인기 있는 오픈 소스 자동화 서버입니다. 2025년 현재, 안정성과 최신 기능을 모두 갖춘 LTS(Long-Term Support) 버전을 설치하는 것이 일반적입니다. 특히 2024년 버전에서 개선된 보안 기능과 파이프라인 관리의 효율성은 현재 시점에도 핵심적인 설치 고려 사항입니다.

본 가이드에서는 윈도우, 리눅스(Ubuntu/CentOS), 그리고 경량화된 환경 구성을 위한 Docker 기반의 Jenkins 설치 및 초기 설정 방법을 상세하게 다룹니다. 어떤 운영체제를 사용하든 상관없이, 이 가이드를 통해 Jenkins 서버를 안정적으로 구축할 수 있습니다. Jenkins 설치의 첫 단계는 공식 웹사이트에서 현재 시점의 최신 LTS 버전을 확인하고, 시스템 환경에 맞는 적절한 설치 파일을 다운로드하는 것입니다. 안정적인 CI/CD 환경 구축을 위해선 Java 11 또는 Java 17 버전이 필수적으로 설치되어 있어야 합니다.

💻 윈도우 환경에서 Jenkins LTS 버전 설치 방법 상세 더보기

윈도우 환경에 Jenkins를 설치하는 것은 가장 간단한 방법 중 하나입니다. 설치 파일(.msi 또는 .exe)을 다운로드하여 마법사(Wizard)를 따라 진행하면 됩니다. 윈도우 설치 시 Jenkins는 기본적으로 서비스로 등록되어 시스템 시작 시 자동으로 실행됩니다.

1. Java 설치 확인: Jenkins를 실행하기 위해서는 먼저 Java 11 또는 17이 설치되어 있어야 합니다. 환경 변수(JAVA_HOME) 설정도 필수로 확인해야 합니다.
2. Jenkins 설치 파일 다운로드: Jenkins 공식 다운로드 페이지에서 Windows용 LTS Installer를 다운로드합니다.
3. 설치 마법사 실행: 다운로드한 파일을 실행하고, ‘Next’를 눌러 설치를 시작합니다. 설치 경로와 포트(기본값 8080)를 지정할 수 있습니다. 포트 충돌이 발생하지 않도록 주의합니다.
4. 서비스 시작: 설치 완료 후, Jenkins 서비스가 자동으로 시작되거나, 윈도우 서비스 관리자에서 수동으로 시작할 수 있습니다.

가장 중요한 단계는 설치 후 방화벽 설정을 확인하는 것입니다. 외부에서 Jenkins에 접속하려면, 지정된 포트(기본 8080)에 대해 윈도우 방화벽 인바운드 규칙을 추가해야 합니다. 이 단계를 건너뛰면 로컬 환경에서만 접속이 가능합니다.

🐧 리눅스 서버 (Ubuntu/CentOS) Jenkins 설치 명령어 보기

리눅스 환경에서는 패키지 관리자(APT 또는 YUM/DNF)를 통해 설치하는 것이 권장되며, 이는 시스템 의존성 관리와 업데이트에 용이합니다. 다음은 Ubuntu 환경을 기준으로 한 Jenkins 설치 과정입니다. CentOS/RHEL 계열은 yum 대신 dnf 또는 yum을 사용합니다.

# Java 17 설치 (권장) sudo apt update sudo apt install openjdk-17-jre
Jenkins 리포지토리 키 추가 및 리포지토리 설정
curl -fsSL https://pkg.jenkins.io/debian/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 binary/ | sudo tee
/etc/apt/sources.list.d/jenkins.list > /dev/null
Jenkins 설치
sudo apt update sudo apt install jenkins
Jenkins 서비스 시작 및 상태 확인
sudo systemctl start jenkins sudo systemctl status jenkins

설치 후, 웹 브라우저를 열고 http://[서버IP]:8080으로 접속합니다. 리눅스에서도 마찬가지로 방화벽 (UFW 등) 설정을 통해 8080 포트를 열어주어야 외부 접속이 가능합니다.

🐳 Docker를 이용한 Jenkins 설치 및 실행 방법 확인하기

Docker를 사용하면 호스트 시스템에 영향을 주지 않고 빠르고 격리된 환경에서 Jenkins를 실행할 수 있습니다. 이는 테스트 환경이나 임시 CI/CD 환경을 구축할 때 매우 유용합니다. Docker 이미지를 사용하는 것이 2025년 현재 가장 선호되는 설치 방식 중 하나입니다.

1. Docker 설치 확인: 시스템에 Docker가 설치되어 있고 실행 중인지 확인합니다.
2. Jenkins 이미지 다운로드 및 컨테이너 실행: 아래 명령어를 사용하여 Jenkins LTS 이미지를 다운로드하고 실행합니다. 데이터의 영속성을 위해 볼륨 마운트가 필수입니다.

# jenkins_home 볼륨 생성 (데이터 영속성 확보) docker volume create jenkins_home
Jenkins 컨테이너 실행
docker run -d -p 8080:8080 -p 50000:50000 --name jenkins
-v jenkins_home:/var/jenkins_home
-v /var/run/docker.sock:/var/run/docker.sock
jenkins/jenkins:lts

-p 8080:8080은 호스트의 8080 포트를 컨테이너의 8080 포트에 연결하며, -p 50000:50000은 빌드 에이전트 통신을 위한 포트입니다. -v jenkins_home:/var/jenkins_home 명령을 통해 컨테이너가 삭제되더라도 설정 및 데이터가 유지됩니다.

🔑 Jenkins 초기 설정 및 필수 플러그인 상세 더보기

모든 설치 방법에서 Jenkins 서버를 시작하면, 웹 브라우저를 통해 초기 설정 과정을 진행해야 합니다. http://[설치된IP]:8080으로 접속합니다.

1. 관리자 암호 잠금 해제: 처음 접속하면 초기 관리자 암호를 요구합니다. 이 암호는 서버 내 특정 경로에 저장되어 있습니다.
2. 관리자 암호 확인 경로:
   • 윈도우: C:\ProgramData\Jenkins.jenkins\secrets\initialAdminPassword
   • 리눅스/Docker 볼륨: /var/jenkins_home/secrets/initialAdminPassword

   해당 파일의 내용을 복사하여 웹 페이지에 붙여넣고 잠금을 해제합니다.

3. 플러그인 설치: ‘Install suggested plugins(권장 플러그인 설치)’를 선택하는 것이 가장 일반적입니다. 권장 플러그인에는 파이프라인(Pipeline), Git, 워크스페이스(Workspace) 등 CI/CD에 필수적인 요소들이 포함되어 있습니다.
4. 관리자 계정 생성: 초기 설정의 마지막 단계에서 사용할 관리자 계정(사용자 이름, 암호, 이메일)을 생성합니다.

초기 설정이 완료되면 Jenkins 대시보드에 접속하게 됩니다. 여기서부터는 새로운 Item(프로젝트)를 생성하고 Git 저장소 연동, 빌드 스크립트 작성 등을 통해 본격적인 CI/CD 환경을 구축할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)