jenkins通过docker部署后系统时间不正确的问题

原创已于 2025-03-05 14:07:46 修改 · 1.5k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#jenkins #docker #运维

于 2025-03-05 13:45:11 首次发布

jenkins 专栏收录该内容

4 篇文章

订阅专栏

如果 Jenkins 系统里的显示时间仍然慢了 8 小时，这通常是因为 Jenkins 的 JVM 时区配置 未正确设置。Jenkins 是基于 Java 的应用程序，它的时间由 JVM 的默认时区决定。

以下是解决 Jenkins 系统时间显示慢 8 小时问题的详细方法：

1. 检查 Jenkins 的 JVM 时区配置

Jenkins 的时区由 JVM 的 user.timezone 参数决定。如果未显式设置，JVM 会使用默认时区（通常是 UTC）。

查看 Jenkins 的当前时区

登录 Jenkins 控制台。
进入 Manage Jenkins > System Information。
查找 user.timezone 属性，确认当前时区。

如果 user.timezone 显示为 UTC 或其他非预期时区，则需要修改 JVM 的时区配置。

2. 修改 Jenkins 的 JVM 时区

方法 1：通过环境变量设置时区

在运行 Jenkins 容器时，通过环境变量 JAVA_OPTS 或 JENKINS_JAVA_OPTIONS 设置 JVM 时区。

使用 `docker run` 命令

docker run -d \
  --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -e JAVA_OPTS="-Duser.timezone=Asia/Shanghai" \
  jenkins/jenkins:lts

使用 `docker-compose`

在 docker-compose.yml 中添加环境变量：

version: '3'
services:
  jenkins:
    image: jenkins/jenkins:lts
    container_name: jenkins
    ports:
      - "8080:8080"
      - "50000:50000"
    environment:
      - JAVA_OPTS=-Duser.timezone=Asia/Shanghai

方法 2：修改 Jenkins 容器的启动脚本

如果 Jenkins 容器已经运行，可以通过修改启动脚本设置时区。

进入 Jenkins 容器：
```
docker exec -it jenkins /bin/bash
```
编辑 Jenkins 启动脚本（通常位于 /usr/local/bin/jenkins.sh）：
```
vi /usr/local/bin/jenkins.sh
```

找到 exec java 行，添加 -Duser.timezone=Asia/Shanghai 参数：

exec java -Duser.timezone=Asia/Shanghai -jar /usr/share/jenkins/jenkins.war "$@"

保存并退出，然后重启容器：
```
docker restart jenkins
```

3. 验证 Jenkins 时区

登录 Jenkins 控制台。
进入 Manage Jenkins > System Information。
查找 user.timezone 属性，确认时区已正确设置为 Asia/Shanghai。

4. 检查 Jenkins 系统配置

如果 JVM 时区配置正确，但 Jenkins 的时间仍然不正确，可能是 Jenkins 系统配置问题。

检查 Jenkins 系统时间

登录 Jenkins 控制台。
进入 Manage Jenkins > System Information。
查找 user.timezone 和 user.country，确保时区和国家/地区设置正确。

安装并配置 Time Zone 插件

登录 Jenkins 控制台。
进入 Manage Jenkins > Manage Plugins。
在 Available 选项卡中搜索 Time Zone 插件并安装。
安装完成后，进入 Manage Jenkins > Configure System。
找到 Time Zone 配置项，设置正确的时区（例如 Asia/Shanghai）。
保存配置。

5. 检查宿主机和容器时间

确保宿主机和容器的时间同步。

检查宿主机时间

date

检查容器时间

docker exec jenkins date

如果宿主机和容器时间不一致，可以参考以下方法同步时间：

挂载宿主机的 /etc/localtime 和 /etc/timezone：

docker run -d \
  --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -v /etc/localtime:/etc/localtime:ro \
  -v /etc/timezone:/etc/timezone:ro \
  jenkins/jenkins:lts

6. 重启 Jenkins 服务

完成以上配置后，重启 Jenkins 服务以应用更改。

重启 Jenkins 容器

docker restart jenkins

总结

根本原因：Jenkins 的 JVM 时区未正确配置，导致时间显示慢 8 小时。
解决方法：
1. 通过 JAVA_OPTS 或 JENKINS_JAVA_OPTIONS 设置 JVM 时区。
2. 安装并配置 Jenkins 的 Time Zone 插件。
3. 确保宿主机和容器的时间同步。