Jenkins 修改主目录 JENKINS_HOME

Windows 安装 Jenkins 运行后，默认数据目录，也就是工作区目录，即每次构建的项目数据文件所在目录为：

    C:\Users\Administrator\AppData\Local\Jenkins\.jenkins

随着项目和构建次数增加，这是个空间暴涨的目录，因此有必要将它转移到别的地方。

登录 Jenkins 访问 Manage Jenkins ->System Configuration -> Configure System 可以看到页面最上面第一项就是当前主目录位置信息，即：

    C:\Users\Administrator\AppData\Local\Jenkins\.jenkins

字符串信息的右边有帮助图标，点击图标，会显示修改这个值的帮助信息。共3种方法可以改变该目录。

Jenkins储存所有的数据文件在这个目录下. 你可以通过以下几种方式更改：

1. 使用你Web容器的管理工具设置JENKINS_HOME环境参数.
2. 在启动Web容器之前设置JENKINS_HOME环境变量.
3. (不推荐)更改Jenkins.war(或者在展开的Web容器)内的web.xml配置文件.

这个值在Jenkins运行时是不能更改的. 其通常用来确保你的配置是否生效.

不幸的是，在 Jenkins v2.289 版本之后，这3个方法都无效，设置 JENKINS_HOME 环境变量，修改 web.xml 重启服务，依然无效。

网上也有很多方法，方法类似，结果可想而知，全都没有效果。

其实方法很简单，只是 Jenkins 在文档和软件帮助提示中没有更新这方面的内容，都是去年的黄历了。

正确方法：

进入 Jenkins 安装目录，打开 jenkins.xml 文件，找到 

<env name="JENKINS_HOME" value="%LocalAppData%\Jenkins\.jenkins"/>

这就是主目录的配置信息，修改这行代码，把 value  换成要转移到的目标目录。例如：

    G:\Services-data\Jenkins\.jenkins

把原来目录  %LocalAppData%\Jenkins\.jenkins 里的内容复制到新目标目录，或者直接把这个目录移动到 G:\Services-data\Jenkins\ 下。

重启 Jenkins, 登录 Jenkins 访问 Manage Jenkins ->System Configuration -> Configure System 验证新的主目录是否生效了。手动来一次构建，一切 OK 。