如何自定义Jenkins默认家目录JENKINS_HOME

Posted on Views:

Jenkins 的 JENKINS_HOME 路径，是Jenkins 的数据目录（包括插件、配置、job、用户等）存储的默认目录。

m1.启动参数中指定

在启动 Jenkins 时通过参数指定 JENKINS_HOME：

1
java -DJENKINS_HOME=/your/custom/path -jar jenkins.war

或者使用 systemd 启动方式，也可以通过环境变量传递。

m2.环境变量指定

在 shell 中设置 JENKINS_HOME 环境变量：

1
2
export JENKINS_HOME=/your/custom/path
java -jar jenkins.war

你也可以写入启动脚本或 /etc/profile.d/jenkins.sh 中，适用于手动或系统服务启动。

m3.系统服务配置（systemd）

如果你是使用 yum/apt 安装的 Jenkins（系统服务），可以修改：

1.修改文件（Debian/Ubuntu）：

1
2
sudo vi /etc/default/jenkins
JENKINS_HOME=/var/lib/jenkins  # 修改默认路径

2.修改文件（RedHat/CentOS）：

1
2
sudo vi /etc/sysconfig/jenkins
JENKINS_HOME="/data/jenkins_home"

修改后重启服务：

1
2
sudo systemctl daemon-reexec
sudo systemctl restart jenkins

m4.Docker 环境中指定

若你使用 Docker 部署 Jenkins，挂载 JENKINS_HOME 路径如下：

1
2
3
4
5
docker run -d \
  -p 8080:8080 \
  -v /your/custom/jenkins_home:/var/jenkins_home \
  --name jenkins \
  jenkins/jenkins:lts

Jenkins 镜像中默认的 JENKINS_HOME 是 /var/jenkins_home

检查是否生效

Jenkins 启动后，可以在页面访问：

http://yourhost:8080/systemInfo

查找系统属性：

JENKINS_HOME = /your/custom/path