Skip to content
W3S101

Jenkins - Tomcat 设置

Jenkins – Tomcat 安装设置（可选）

Section titled “Jenkins – Tomcat 安装设置（可选）”

虽然通过 java -jar jenkins.war 或使用 Docker 运行 Jenkins 很常见，但你也可以将 Jenkins 作为 Web 应用程序 (.war 文件) 部署到像 Apache Tomcat 这样的 Servlet 容器中。如果你已经在 Tomcat 中管理其他应用程序，这可能是首选方法。

注意： 这种方法增加了在管理 Jenkins 的同时管理 Tomcat 的复杂性。对于更简单的设置，请优先考虑 standalone 或 Docker 选项。

先决条件

Section titled “先决条件”
  1. Java Development Kit (JDK): Jenkins 需要一个兼容的 JDK (推荐 Java 11 或 17) 才能运行。Tomcat 也需要 Java。确保 JDK 已安装并正确设置了 JAVA_HOME 环境变量。
  2. Apache Tomcat: 从官方网站下载并安装最新版本的 Tomcat (例如，Tomcat 9.x 或 10.x): https://tomcat.apache.org/
  3. Jenkins WAR 文件: 从 https://www.jenkins.io/download/ 下载“通用 Java 包 (.war)”文件。

步骤 1: 验证 Java 安装

Section titled “步骤 1: 验证 Java 安装”

打开你的终端或命令提示符，运行：

java -version

确保输出显示兼容的版本（例如，11.x.x 或 17.x.x）。

# Example Output (Linux/macOS)
openjdk version "11.0.15" 2022-04-19
OpenJDK Runtime Environment (build 11.0.15+10-Ubuntu-0ubuntu0.20.04.1)
OpenJDK 64-Bit Server VM (build 11.0.15+10-Ubuntu-0ubuntu0.20.04.1, mixed mode, sharing)


# Example Output (Windows)
java version "17.0.3" 2022-04-19 LTS
Java(TM) SE Runtime Environment (build 17.0.3+8-LTS-111)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.3+8-LTS-111, mixed mode, sharing)

还要验证是否设置了 JAVA_HOME：

# Linux/macOS
echo $JAVA_HOME


# Windows
echo %JAVA_HOME%

步骤 2: 准备 Tomcat

Section titled “步骤 2: 准备 Tomcat”

  1. 下载适用于你操作系统的适当 Tomcat 二进制发行版（例如，zip 或 tar.gz）。

  2. 将下载的压缩包解压到合适的位置（例如，/opt/tomcat 或 C:\Program Files\Tomcat）。这个位置被称为 CATALINA_HOME。

  3. 内存配置（推荐）： Jenkins 通常比 Tomcat 的默认配置需要更多内存。编辑 Tomcat 启动脚本的环境设置。创建或修改 CATALINA_HOME/bin/setenv.sh (Linux/macOS) 或 CATALINA_HOME/bin/setenv.bat (Windows) 并添加 Java 选项：

# Example setenv.sh (Linux/macOS)
export CATALINA_OPTS="$CATALINA_OPTS -Xms1G -Xmx2G -Djenkins.install.runSetupWizard=false"


# Example setenv.bat (Windows)
set CATALINA_OPTS=%CATALINA_OPTS% -Xms1G -Xmx2G -Djenkins.install.runSetupWizard=false

根据你的服务器资源调整 -Xms（初始堆大小）和 -Xmx（最大堆大小）（例如，初始 1GB，最大 2GB）。-Djenkins.install.runSetupWizard=false 标志可以选择性地禁用初始设置向导，如果你已预先配置 Jenkins。

步骤 3: 部署 Jenkins WAR 文件

Section titled “步骤 3: 部署 Jenkins WAR 文件”

  1. 找到你下载的 jenkins.war 文件。

  2. 将 jenkins.war 文件复制到 CATALINA_HOME/webapps/ 目录中。

步骤 4: 启动 Tomcat

Section titled “步骤 4: 启动 Tomcat”

  1. 打开你的终端或命令提示符。

  2. 导航到 CATALINA_HOME/bin 目录。

  3. 运行启动脚本：

# Linux/macOS
./startup.sh


# Windows
startup.bat

Tomcat 将会启动，你应该在日志中看到指示其正在部署 jenkins.war 文件的消息（例如，CATALINA_HOME/logs/catalina.out）。

# Example log output excerpt
INFO [main] org.apache.catalina.startup.HostConfig.deployWAR Deploying web application archive [/path/to/tomcat/webapps/jenkins.war]
... many Jenkins startup logs ...
INFO [main] jenkins.install.SetupWizard.init Jenkins is fully up and running

步骤 5: 访问 Jenkins

Section titled “步骤 5: 访问 Jenkins”

  1. 打开你的 Web 浏览器，导航到 http://<你的服务器IP或主机名>:8080/jenkins（假设 Tomcat 运行在 8080 端口）。

  2. 如果这是首次运行 Jenkins，你将按照安装章节所述，通过初始设置向导（解锁 Jenkins、安装插件、创建管理员用户），除非已禁用。

注意事项

Section titled “注意事项”
  • JENKINS_HOME: 在 Tomcat 中部署时，Jenkins 通常会在运行 Tomcat 的用户配置文件目录下创建其 JENKINS_HOME 目录，或根据上下文参数/环境变量进行配置。你可能需要为 Tomcat 进程显式设置 JENKINS_HOME 环境变量以控制其位置。
  • 升级: 要升级 Jenkins，停止 Tomcat，替换 webapps 目录中的 jenkins.war 文件，删除 webapps 内已解压的 jenkins 目录（Tomcat 通常会处理，但手动删除可确保干净部署），然后重启 Tomcat。
  • 资源争用: Jenkins 可能会占用大量资源。在同一个 Tomcat 实例中与其他关键应用程序一起运行，可能会导致性能问题。请仔细监控资源使用情况。