[Ubuntu] apt로 설치한 Jenkins 타임존(Timezone) 변경 방법 (KST 설정)

우분투 서버(OS)의 시간을 한국 표준시(KST)로 변경했는데도, Jenkins 콘솔이나 빌드 로그에는 여전히 UTC(국제 표준시)로 표시되는 경우가 있습니다.

이는 Jenkins가 실행될 때 Java 환경 변수(JVM Options)에 타임존 설정이 되어 있지 않기 때문입니다. apt install로 설치한 경우, 서비스 설정 파일을 직접 수정하여 해결할 수 있습니다.

1. Jenkins 서비스 파일 열기

터미널에서 원본 서비스 설정 파일을 엽니다.

sudo nano /lib/systemd/system/jenkins.service

2. JAVA_OPTS 수정

파일 내에서 Environment="JAVA_OPTS=..."로 시작하는 부분을 찾습니다. 기존 옵션 뒤에 -Duser.timezone=Asia/Seoul을 추가합니다.

수정 전 (예시)

Environment="JAVA_OPTS=-Djava.awt.headless=true"

수정 후

Environment="JAVA_OPTS=-Djava.awt.headless=true -Duser.timezone=Asia/Seoul"

3. 서비스 재시작 및 적용

수정한 내용을 저장(Ctrl+O)하고 나 온 뒤, 데몬을 리로드하고 젠킨스를 재시작합니다.

sudo systemctl daemon-reload
sudo systemctl restart jenkins

4. 변경 결과 확인 (Script Console)

설정이 제대로 적용되었는지 확인하기 위해 Jenkins 관리 > Script Console 메뉴로 이동합니다.

아래 명령어를 입력하고 [Run] 버튼을 누릅니다.

System.getProperty("user.timezone")
println(new Date())

Result: 결과창에 Asia/Seoul과 현재 시간이 KST로 표시된다면 성공입니다.