Ubuntu/Debian에서 Jenkins LTS 설치하는 방법 (2023 GPG 키 기준)
서버에 CI/CD 구성하려고 Jenkins 올리는 경우 많음. 여기서는 Ubuntu/Debian 계열에서 Jenkins LTS를 공식 APT 저장소로 설치하는 방법 정리함. 2023년 이후 GPG 키 기준으로 진행함.
1) Jenkins 2023 GPG 키 다운로드
예전 키로 설정해두면 apt update에서 서명 오류 나는 경우 있음. 공식 Jenkins 키를 keyring 경로에 저장해두면 깔끔함.
sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
- /usr/share/keyrings/ 경로에 저장하는 이유: signed-by 옵션으로 특정 저장소만 해당 키를 쓰게 묶을 수 있음
- 키 파일 확장자는 .asc로 저장해도 무방함
2) Jenkins APT 저장소 추가 (LTS 기준)
LTS 설치 목적이면 debian-stable 저장소 사용하면 됨. 아래처럼 jenkins.list 파일을 생성해 추가함.
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
포인트는 signed-by 옵션임. 시스템 전체 trusted key에 막 넣는 방식보다 보안적으로 깔끔한 편임.
3) Jenkins 설치 및 서비스 자동 실행
저장소 추가했으면 업데이트 후 설치하면 됨. 설치 이후 부팅 자동 실행도 같이 걸어줌.
sudo apt update
sudo apt install jenkins -y
# 부팅 시 자동 실행 등록 및 지금 바로 시작
sudo systemctl enable --now jenkins
4) Jenkins 상태 확인 + 초기 관리자 비밀번호 확인
서비스가 정상 기동 중인지 먼저 확인해야 함. Active: active (running) 뜨면 1차 통과임.
sudo systemctl status jenkins
처음 접속 시 초기 관리자 비밀번호가 필요함. 아래 파일에서 확인 가능함.
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 브라우저에서 접속은 보통 http://서버IP:8080 형태로 들어감
- 방화벽/보안그룹에서 8080 포트 허용 안 되어 있으면 접속 자체가 안 됨
자주 막히는 포인트
- apt update에서 NO_PUBKEY 오류: GPG 키 경로가 맞는지, jenkins.list의 signed-by 경로가 정확한지 확인 필요함
- Jenkins 서비스가 안 뜸:
journalctl -u jenkins --no-pager -n 200로 로그 먼저 보는 게 빠름 - 8080 접속 불가: ufw 사용 중이면
sudo ufw allow 8080같은 조치 필요할 수 있음
여기까지 하면 Jenkins 설치 + LTS 저장소 구성 + 초기 로그인 준비까지 끝임. 다음 단계는 플러그인 설치하고, 파이프라인/에이전트 붙이면 됨.
Was this helpful?
0 / 0