¶ Native jenkins deployment
¶ 개요
RHEL · Rocky · AlmaLinux 에 Jenkins LTS 를 패키지로 설치하고 systemd 서비스로 띄운다. 요구사항과 Java 지원 표는 Jenkins 에 있다.
¶ Jenkins LTS 2.568.x 패키지 설치 가이드 (RHEL 계열)
¶ 설치
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/rpm-stable/jenkins.repo
sudo yum upgrade -y
# Jenkins 패키지의 의존성
sudo yum install -y fontconfig java-21-openjdk
sudo yum install -y jenkins
sudo systemctl daemon-reload
¶ 서비스 등록
sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins
¶ 방화벽
기본 포트는 8080 이다.
YOURPORT=8080
PERM="--permanent"
SERV="$PERM --service=jenkins"
sudo firewall-cmd $PERM --new-service=jenkins
sudo firewall-cmd $SERV --set-short="Jenkins ports"
sudo firewall-cmd $SERV --set-description="Jenkins port exceptions"
sudo firewall-cmd $SERV --add-port=$YOURPORT/tcp
sudo firewall-cmd $PERM --add-service=jenkins
sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload
¶ 동작 확인
브라우저에서 http://<host>:8080 에 접속하면 Unlock 화면이 뜬다. 초기 비밀번호는 로그 또는 다음 파일에 있다.
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:
b429bd1bb1134194b56fbe5c45c81584
This may also be found at: /var/lib/jenkins/secrets/initialAdminPassword
이후 절차는 Jenkins 초기 설정 을 따른다.
¶ systemd 설정 (포트 · TLS · JAVA_HOME)
패키지가 넣는 유닛 파일은 /lib/systemd/system/jenkins.service 다. 직접 고치지 말고 systemctl edit jenkins 로 override 를 만든다. 아래는 HTTPS 리스너로 바꾸고 JDK 를 고정한 예다. 키스토어(JKS)는 미리 만들어 둔다.
sudo systemctl edit jenkins
[Service]
# 여러 JDK 가 설치돼 있을 때
Environment="JAVA_HOME=/usr/lib/jvm/java-21-openjdk"
# HTTP 를 끄고 HTTPS 만 연다
Environment="JENKINS_PORT=-1"
Environment="JENKINS_HTTPS_LISTEN_ADDRESS=0.0.0.0"
Environment="JENKINS_HTTPS_PORT=8443"
Environment="JENKINS_HTTPS_KEYSTORE=/var/lib/jenkins/certs/server.jks"
Environment="JENKINS_HTTPS_KEYSTORE_PASSWORD=${KEYSTORE_PASSWORD}"
# 로그 파일
Environment="JENKINS_LOG=/var/log/jenkins/jenkins.log"
sudo systemctl daemon-reload
sudo systemctl restart jenkins
참고로 패키지 기본 유닛의 주요 항목은 다음과 같다.
[Unit]
Description=Jenkins Continuous Integration Server
Requires=network.target
After=network.target
StartLimitBurst=5
StartLimitIntervalSec=5m
[Service]
Type=notify
NotifyAccess=main
ExecStart=/usr/bin/jenkins
Restart=on-failure
SuccessExitStatus=143
User=jenkins
Group=jenkins
Environment="JENKINS_HOME=/var/lib/jenkins"
WorkingDirectory=/var/lib/jenkins
Environment="JENKINS_WEBROOT=%C/jenkins/war"
Environment="JAVA_OPTS=-Djava.awt.headless=true"
[Install]
WantedBy=multi-user.target
¶ Jenkins LTS 2.5xx 패키지 설치 (2025년 테스트 됨)
위 버전과 저장소는 오래된 것이라 저장소가 존재하지 않을 수 있다.
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
sudo yum upgrade
sudo yum install fontconfig java-21-openjdk
sudo yum install jenkins
sudo systemctl daemon-reload
최신 LTS 2.568.3 — 2026-09-20 확인. https://www.jenkins.io/changelog-stable/ ↩︎
Installing Jenkins on Linux — Red Hat. 2026-09-20 확인. https://www.jenkins.io/doc/book/installing/linux/ ↩︎