본문으로 건너뛰기

Jenkins 설치 및 포트 변경 후 접속이 안될 때

등록일: 2025. 6. 9. 1:04
내용: Jenkins 로컬 설치 및 포트 변경(8083) 설정 가이드 ​

​

✅ 1. Jenkins 설치 준비​

​

# Jenkins GPG 키 및 저장소 추가
wget -q -O - [https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key](https://pkg.jenkins.io/debian-stable/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-stable](https://pkg.jenkins.io/debian-stable) binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
​
# 패키지 목록 업데이트
sudo apt update

​

​

✅ 2. Jenkins 설치​

​

sudo apt install -y jenkins

​​

​

✅ 3. Jenkins 포트 변경 (8080 → 8083)​

​

  • Jenkins 기본 포트는 8080인데, 이미 사용 중일 수 있음.
  • /etc/default/jenkins에 명시적으로 8083 지정: ​
sudo nano /etc/default/jenkins

​

  • 다음과 같이 수정: ​
HTTP_PORT=8083
JENKINS_ARGS="--webroot=/var/cache/jenkins/war --httpPort=8083"

​ ※ 단, 이 설정이 systemd에서는 무시될 수 있음. ​​

​

✅ 4. Systemd 서비스 재정의​

​

  • /etc/systemd/system/jenkins.service 파일 생성: ​
sudo nano /etc/systemd/system/jenkins.service

​

  • 아래 내용으로 작성: ​
[Unit]
Description=Jenkins Continuous Integration Server
After=network.target
​
[Service]
Type=simple
User=jenkins
Group=jenkins
ExecStart=/usr/bin/java -jar /usr/share/java/jenkins.war --httpPort=8083
Restart=on-failure
​
[Install]
WantedBy=multi-user.target

​​

​

✅ 5. 서비스 반영 및 실행​

​

sudo systemctl daemon-reload
sudo systemctl enable jenkins
sudo systemctl restart jenkins

​​

​

✅ 6. 결과 확인​

​

  • 브라우저에서 접속: http://localhost:8083
  • 초기 관리자 패스워드: ​
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

​​

​

🧠 참고 사항​

​

  • 이 방식은 systemd에 포트를 직접 지정하므로 가장 안정적임.
  • /etc/default/jenkins는 무시되므로 향후 설정 변경은 jenkins.service에서 수행.