젠킨스(Jenkins) 설치 가이드 - Mac, Amazon Linux

English
#Jenkins#CI/CD#DevOps#Mac#Amazon Linux

젠킨스 설치하기

젠킨스를 설치하려면 먼저 자바(JDK)가 필요하다. 현재 Jenkins LTS는 Java 17 이상 을 요구하며, weekly 릴리즈는 Java 21 이상 이 필요하다. 2026년 기준으로 Java 21을 설치하는 게 가장 안전하다.

참고로 Jenkins를 돌리는 JVM 버전과 빌드에 사용하는 JDK 버전은 별개다. Jenkins 자체는 Java 17/21로 실행하면서, 프로젝트 빌드는 Global Tool Configuration에서 설정한 JDK 8이나 11로 할 수 있다.

기존 젠킨스가 설치되어 있던 경우

이미 젠킨스가 설치되어 있었던 PC라면 그냥 설치하면 ~/.jenkins 폴더가 이미 존재하여 이상한 경로에 JENKINS_HOME 이 설정되는 경우가 있다.

따라서 .jenkins 경로를 완전히 지우고 젠킨스를 삭제한 뒤에 다시 아래 커맨드로 젠킨스를 설치해야 한다.

Mac

Mac에서는 Homebrew로 설치하면 된다.

brew install jenkins-lts
brew services start jenkins-lts

설치 후 http://localhost:8080 에 접속하면 초기 설정 화면이 뜬다.

초기 관리자 비밀번호는 아래 커맨드로 확인할 수 있다.

cat ~/.jenkins/secrets/initialAdminPassword

Mac에서 젠킨스를 완전히 삭제하려면 아래 순서대로 진행하면 된다.

brew services stop jenkins-lts
brew uninstall jenkins-lts
rm -rf ~/.jenkins

Amazon Linux

공식 가이드는 여기를 참고하면 된다.

Amazon Linux 2023 기준으로 젠킨스 설치 과정은 다음과 같다.

# 시스템 업데이트
sudo yum update -y

# Jenkins 저장소 추가
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key

# Java 설치 (Amazon Corretto 17 또는 21)
sudo dnf install java-17-amazon-corretto -y

# Jenkins 설치
sudo yum install jenkins -y

# Jenkins 시작
sudo systemctl enable jenkins
sudo systemctl start jenkins

설치 후 http://<인스턴스-IP>:8080 으로 접속한다. EC2 보안 그룹에서 8080 포트를 열어두는 것을 잊지 말자.

초기 관리자 비밀번호는 아래 커맨드로 확인한다.

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

젠킨스를 설치한 뒤에 Node.js 환경도 함께 세팅해주면 좋다.

# nvm 및 node 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
. ~/.nvm/nvm.sh
nvm install --lts
nvm use --lts
nvm alias default lts/*

# pm2 yarn 설치
npm i -g pm2 yarn

.jenkins 디렉토리 마이그레이션

젠킨스를 재설치할 때 기존 .jenkins 디렉토리에 있는 것들을 일부 마이그레이션할 수 있다.

실험적으로 해본 결과, 아래 항목들은 그대로 옮겨도 정상 동작했다.

  • users — 기존 사용자 계정 정보
  • nodes — 등록해둔 노드(에이전트) 설정

해당 폴더를 새로 설치한 젠킨스의 ~/.jenkins 경로에 복사해주면 기존 설정을 그대로 이어서 사용할 수 있다. 복사 후 젠킨스 웹 UI에서 Jenkins 관리 → 설정 다시 불러오기 를 눌러주면 재시작 없이 반영된다.

젠킨스 디렉토리 관리

젠킨스는 ~/.jenkins 디렉토리 아래에 모든 설정과 빌드 데이터를 저장한다. 주요 구조는 다음과 같다.

~/.jenkins/
├── config.xml          # 젠킨스 전체 설정
├── jobs/               # 각 빌드 잡의 설정과 빌드 기록
│   └── [JOB_NAME]/
│       ├── config.xml
│       ├── builds/
│       └── workspace/  # 소스 코드가 체크아웃되는 곳
├── nodes/              # 노드(에이전트) 설정
├── plugins/            # 설치된 플러그인
├── users/              # 사용자 정보
├── secrets/            # 인증 정보
└── workspace/          # 워크스페이스

빌드를 반복하다 보면 jobs/ 하위의 builds/ 와 workspace/ 디렉토리 용량이 꽤 커질 수 있다. 디스크 용량이 부족해지지 않도록 주기적으로 확인해주는 게 좋다.