You need to enable JavaScript to run this app. Linux下同一Tomcat 8.5.34部署双Jenkins及独立主目录配置方法
优惠活动
大模型
产品
解决方案
定价
更多

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-dev
  • http://jenkins.dev.com/jen-qa:进入系统信息页,确认显示的Jenkins主目录为/opt/jen-qa
    注:两个实例同属一个Tomcat进程,所有HTTP请求都走Tomcat的统一监听端口,不存在Jenkins内置端口冲突的问题。

内容的提问来源于stack exchange,提问作者cool_stuff_coming

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 19:45:08