Linux下同一Tomcat 8.5.34部署双Jenkins及独立主目录配置方法
单Tomcat部署双Jenkins实例主目录隔离配置方案
问题根因
之前通过shell export 设置的 JENKINS_HOME 是Tomcat进程级全局环境变量,同进程下所有Jenkins Web应用启动时都会读取同一个全局值,自然无法实现主目录分离。要实现隔离,必须为每个Web应用单独绑定专属的环境变量,脱离对全局配置的依赖。
具体配置步骤
1. 提前准备主目录权限
给两个目标主目录授予Tomcat运行用户的读写权限,避免启动后无权限读写配置文件:
# 替换为你的Tomcat实际运行用户,生产环境不建议用root运行Tomcat chown -R tomcat:tomcat /opt/jen-dev /opt/jen-qa chmod -R 755 /opt/jen-dev /opt/jen-qa
2. 为每个Jenkins应用单独指定JENKINS_HOME
Tomcat支持为单个Web应用通过context.xml配置专属初始化参数,优先级高于全局环境变量:
- jen-dev实例配置
优先把配置放到Tomcat全局的应用配置目录(避免后续重部署war时覆盖配置),路径为$CATALINA_HOME/conf/Catalina/localhost/jen-dev.xml,文件内容:<?xml version="1.0" encoding="UTF-8"?> <Context> <!-- 当前webapp专属JENKINS_HOME配置,override=false表示不允许全局参数覆盖 --> <Parameter name="JENKINS_HOME" value="/opt/jen-dev" override="false" /> </Context> - jen-qa实例配置
同目录下创建$CATALINA_HOME/conf/Catalina/localhost/jen-qa.xml,文件内容:
如果之前尝试过把配置写到<?xml version="1.0" encoding="UTF-8"?> <Context> <Parameter name="JENKINS_HOME" value="/opt/jen-qa" override="false" /> </Context>webapps/[应用名]/META-INF/context.xml下,需要注意:每次重新上传war包都会覆盖webapps目录下的配置文件,容易丢失配置,优先使用Tomcat全局conf目录下的配置方式。
3. 清理无效的旧配置
- 删除所有在shell全局配置文件(如
/etc/profile、用户家目录.bashrc)、Tomcat启动脚本(如bin/catalina.sh、bin/setenv.sh)中手动添加的export JENKINS_HOME=xxx全局配置,避免全局变量干扰应用级配置 - 清空Tomcat工作目录的旧缓存,避免类加载残留旧配置:
rm -rf $CATALINA_HOME/work/Catalina/localhost/jen-dev rm -rf $CATALINA_HOME/work/Catalina/localhost/jen-qa
生效验证
启动Tomcat后分别访问两个地址:
http://jenkins.dev.com/jen-dev:进入系统信息页,确认显示的Jenkins主目录为/opt/jen-devhttp://jenkins.dev.com/jen-qa:进入系统信息页,确认显示的Jenkins主目录为/opt/jen-qa
注:两个实例同属一个Tomcat进程,所有HTTP请求都走Tomcat的统一监听端口,不存在Jenkins内置端口冲突的问题。
内容的提问来源于stack exchange,提问作者cool_stuff_coming
相关产品推荐
相关产品推荐

