[해결] Jenkins 설치 시 "Package jenkins has no installation candidate" 에러

젠킨스 설치시 오류가 발생하여 https://pkg.jenkins.io/debian/ 에서 관련 내용 참고하며 해결하려고 했었고, 중간에 꼬였는지 계속 실패하더라구요.

AI와 같이 해결했고, 같은 문제를 겪으실 분들을 위해 참고차 남깁니다~

1. 문제 원인

• GPG 키 인식 실패:NO_PUBKEY 7198F4B714ABFC68 에러는 APT가 젠킨스 저장소의 서명을 검증할 수 없을 때 발생합니다.

• 보안 정책 강화: 최신 Ubuntu(24.04+)에서는 기존 .asc 형태의 키보다 바이너리 형태인 .gpg 키 저장 방식을 권장하며, 경로가 일치하지 않으면 저장소를 무시합니다.

2. 해결 방법 (최신 표준 방식)

터미널에서 아래 명령어를 순서대로 실행하세요.

Step 1: 기존의 잘못된 설정 파일 삭제

Bash

sudo rm -f /usr/share/keyrings/jenkins-keyring.asc
sudo rm -f /usr/share/keyrings/jenkins-keyring.gpg
sudo rm -f /etc/apt/sources.list.d/jenkins.list

Step 2: 키 서버에서 직접 키 수신 및 변환 저장 가장 확실한 방법으로 우분투 키 서버에서 직접 키를 가져와 .gpg 형식으로 저장합니다.

Bash

sudo gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 7198F4B714ABFC68
sudo gpg --export 7198F4B714ABFC68 | sudo tee /usr/share/keyrings/jenkins-keyring.gpg > /dev/null

Step 3: Jenkins 저장소 등록 (HTTPS 사용)

Bash

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

Step 4: 업데이트 및 설치

Bash

sudo apt update
sudo apt install jenkins -y

3. 설치 확인

설치가 완료된 후 서비스가 정상 동작하는지 확인합니다.

Bash

sudo systemctl status jenkins

Tip: 만약 설치 도중 Java 관련 에러가 발생한다면, 젠킨스 구동을 위해 sudo apt install openjdk-17-jre -y 명령어로 자바를 먼저 설치해 주세요.