Linux环境下的Jenkins部署：使用Tomcat启动WAR包

本文还有配套的精品资源，点击获取

简介：在Linux环境下，通过Tomcat服务器部署Jenkins WAR包是一种高效实现持续集成和自动化部署的方法。本文详细介绍了部署过程，包括安装Java环境、配置Tomcat服务器、下载并启动Jenkins WAR包、初始化设置、访问和配置Jenkins，以及定期更新维护。掌握这些步骤，可以帮助开发者和系统管理员优化开发流程并提升团队效率。

1. Jenkins概述与WAR包部署基础

Jenkins概述

Jenkins是一个开源的自动化服务器，主要用于自动化各种任务，包括构建、测试和部署软件。它支持各种运行平台，通过其大量的插件支持，几乎可以集成任何软件开发工具。Jenkins通过持续集成（CI）的概念，帮助开发者更快地交付高质量的软件。

WAR包部署的必要性与优势

WAR包是Java Web应用的打包格式，通过部署WAR包，可以将Jenkins安装在任何支持Java的Servlet容器中，例如Tomcat。使用WAR包部署Jenkins的优势在于：
- 平台无关性 ：只要Java运行环境存在，Jenkins就可以在多种操作系统上运行。
- 简化的部署和卸载 ：部署WAR包仅需将其放置在容器的指定目录下，卸载时直接删除即可。
- 易于维护升级 ：更新Jenkins仅需要替换WAR包，管理更加方便。

通过这种方式部署Jenkins，可实现快速安装和高效管理，满足现代IT环境下对自动化工具的需求。

2. 安装Java运行环境

Java是编写Jenkins服务器应用程序的基础，而Jenkins本身也通常以WAR（Web Application Archive）包的形式运行于Java应用服务器上。在深入学习Jenkins的部署之前，确保系统具备运行Java应用的能力是非常关键的。本章节将介绍如何在不同的操作系统上安装和配置Java运行环境。

2.1 检测系统是否已安装Java

在安装Java之前，我们需要验证系统是否已经安装了Java，以及当前安装的版本。这样可以避免重复安装和版本冲突。在大多数Unix-like系统中，Java的安装可以通过命令行进行检测。

检测步骤：

1. 打开终端或命令行界面。
2. 输入 java -version 来检查Java的版本。
3. 若系统提示未安装Java，将显示 Command 'java' not found 。

示例代码：

java -version

输出结果（若未安装）：

bash: java: command not found

2.2 安装OpenJDK

OpenJDK（Open Java Development Kit）是Java的一个开源实现版本，是Jenkins推荐的Java版本。大多数Linux发行版都支持通过包管理器安装OpenJDK。

以Ubuntu为例的安装步骤：

1. 打开终端。
2. 更新包索引：
   bash sudo apt update
3. 安装OpenJDK 11（你可以根据需要安装其他版本，例如1.8或最新的版本）：
   bash sudo apt install openjdk-11-jdk

2.3 验证Java安装配置

安装完成后，我们需要验证Java是否正确安装以及配置是否正确。

验证步骤：

1. 重新检查Java版本：
   bash java -version
2. 验证Java安装路径和环境变量是否设置：
   bash which java

示例代码：

java -version
which java

输出结果：

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment AdoptOpenJDK (build 11.0.9.1+1)
OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.9.1+1, mixed mode)

/usr/bin/java

逻辑分析与参数说明：

• java -version ：此命令用于显示已安装Java的版本信息。
• which java ：此命令用于找出 java 可执行文件的具体路径，以确保Java环境变量配置正确。

至此，我们完成了Java运行环境的安装与验证。下一步，我们将为Jenkins安装Tomcat服务器，并进行相关配置。这将为Jenkins提供一个运行的基础平台，确保Jenkins部署的稳定性和效率。接下来，让我们深入了解如何选择和安装适合Jenkins的Tomcat版本。

3. 安装Tomcat服务器

在成功安装Java运行环境后，接下来的步骤是安装Tomcat服务器，这是运行Jenkins WAR包的关键服务器环境。Tomcat服务器不仅可以托管Jenkins，还可以作为未来部署其他Java Web应用程序的基础。

3.1 选择适合Jenkins的Tomcat版本

选择一个与Jenkins兼容的Tomcat版本至关重要，以确保Jenkins能够顺利运行。截至本文撰写时，Jenkins推荐使用的Tomcat版本为9.x。这一版本不仅提供了改进的安全性和性能，还与最新版本的Java兼容。

3.2 安装Tomcat到系统中

安装Tomcat的步骤依赖于所使用操作系统的类型。以Linux为例，通常的步骤如下：

1. 下载Tomcat压缩包到本地系统。
2. 解压Tomcat压缩包到指定目录。
3. 设置系统环境变量，使Tomcat成为全局可访问的命令。

# 下载Tomcat压缩包
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.54/bin/apache-tomcat-9.0.54.tar.gz

# 解压到当前目录
tar -xvzf apache-tomcat-9.0.54.tar.gz

# 设置环境变量，假设解压到了 /opt 目录下
export CATALINA_HOME=/opt/apache-tomcat-9.0.54
export PATH=$CATALINA_HOME/bin:$PATH

3.3 配置Tomcat系统变量和环境

正确配置Tomcat的系统变量是确保其正常运行的关键步骤。在Linux系统中，通常通过编辑用户目录下的 .bashrc 或 .bash_profile 文件来设置环境变量：

# 打开 .bashrc 文件
nano ~/.bashrc

# 在文件末尾添加以下内容
export CATALINA_HOME=/opt/apache-tomcat-9.0.54
export PATH=$CATALINA_HOME/bin:$PATH

# 使环境变量生效
source ~/.bashrc

在配置完成后，可以通过输入 tomcat 命令测试Tomcat是否已经正确安装并配置。如果出现Tomcat的帮助信息，说明安装成功。

# 测试Tomcat安装
tomcat version

# 预期输出：
Apache Tomcat version 9.0.54

以上步骤为安装Tomcat服务器的概述。然而，安装之后的配置也同样重要。接下来，让我们深入配置Tomcat服务器，以适应Jenkins的部署需求。

4. 配置Tomcat服务器

4.1 修改Tomcat的配置文件server.xml

在Tomcat服务器中， server.xml 是核心的配置文件，它定义了服务器的配置信息，比如端口、连接器等。修改此文件可以对服务器进行细致的调整和优化。

端口配置

Tomcat默认监听8080端口，为了安全考虑，建议更改此端口，同时确保新的端口在防火墙设置中放开。

<Connector port="新端口号" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

连接器配置

除了端口配置，你还可以调整连接器的相关参数。例如，可以设置最大连接数和最大线程数来提高服务器的并发处理能力。

<Connector port="新端口号" protocol="AJP/1.3" redirectPort="8443" />

虚拟主机配置

在server.xml中还可以配置多个虚拟主机，这在一台服务器上托管多个Web应用时非常有用。

<Host name="example.com"  appBase="webapps"
      unpackWARs="true" autoDeploy="true">
</Host>

4.2 设置Tomcat的用户和权限

为了服务器的安全，Tomcat提供了一个用户授权机制，通过在server.xml中添加用户和角色，可以限制访问特定资源。

用户配置

在 <GlobalNamingResources> 标签内添加用户和角色信息。

<Realm className="org.apache.catalina.realm.LockOutRealm">
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
           resource="UserDatabase">
    </Realm>
</Realm>

用户和角色的添加

在 <Users> 和 <Roles> 标签内分别添加用户和角色。

<Realm className="org.apache.catalina.realm.LockOutRealm">
  <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
         resource="UserDatabase">
  </Realm>
</Realm>

4.3 优化Tomcat性能参数

通过调整Tomcat的一些性能参数可以显著提高Web应用的运行效率。比如，通过调整连接器的属性可以增加吞吐量和提高响应速度。

连接器参数

maxThreads 设置最大线程数； minSpareThreads 设置最小空闲线程数； maxKeepAliveRequests 设置一个连接上允许的最大请求数。

<Connector port="新端口号" protocol="AJP/1.3"
           maxThreads="200" minSpareThreads="25"
           maxKeepAliveRequests="100" />

JVM参数配置

在Tomcat的启动脚本中配置JVM参数，优化内存分配、垃圾回收等参数可以提高应用性能。

JAVA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"

配置示例

结合前面的内容，一个优化后的server.xml配置文件可能看起来如下：

<Server port="8005" shutdown="SHUTDOWN">
  <!-- 其他配置省略 -->

  <Service name="Catalina">
    <Connector port="新端口号" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
    <Connector port="新端口号" protocol="AJP/1.3" redirectPort="8443" />

    <Engine name="Catalina" defaultHost="localhost">
      <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resource="UserDatabase">
        </Realm>
      </Realm>

      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">
        <!-- 用户和角色配置省略 -->

        <!-- 其他配置省略 -->
      </Host>
    </Engine>
  </Service>
</Server>

通过这些配置，Tomcat服务器将更加安全、高效地运行。确保在修改配置后重新启动Tomcat服务以使改动生效。接下来，我们会继续讲解如何下载Jenkins WAR包，并最终将Jenkins部署到Tomcat服务器中。

5. 下载Jenkins WAR包

5.1 访问Jenkins官网获取下载链接

当准备部署Jenkins时，第一步是要获取Jenkins的WAR包。这可以通过访问Jenkins的官方网站来完成，官方网站提供了最新的稳定版Jenkins及其WAR包的下载链接。根据Jenkins的使用许可协议（通常为MIT许可证），你可以免费下载并使用Jenkins。在官方网站上，还可以找到关于不同操作系统安装和配置的详细文档。

在获取WAR包之前，请确保你已经安装了适当的Java运行环境，因为Jenkins需要Java环境来运行。安装Java后，就可以访问Jenkins官网，下载所需版本的WAR包。如果你打算使用特定的插件或者对性能有特别的要求，应该下载对应的Jenkins WAR包版本。

访问官方网站并下载的步骤

1. 打开浏览器，输入 Jenkins官网 的地址。
2. 点击网站上提供的下载链接。
3. 在下载页面上，你可以看到多个版本的下载选项，包括最新的稳定版和其他的候选发布版本。
4. 根据你的操作系统和需要，选择合适的版本，下载WAR包到本地。

确保选择正确的版本非常重要，因为不同的版本可能有不兼容的插件和功能更新。如果你不确定哪个版本更适合你的需求，可以选择最新稳定版，因为它通常包含最新的安全修复和功能改进。

5.2 根据系统环境选择合适版本的WAR包

选择合适版本的WAR包对确保Jenkins的正常运行至关重要。Jenkins提供了多种版本的WAR包，包括支持不同Java版本和操作系统的不同构建。在选择版本时，应考虑以下因素：

• 支持的Java版本 ：确保你下载的WAR包与你系统上安装的Java版本兼容。
• 操作系统兼容性 ：选择与你的服务器操作系统兼容的版本。
• 功能需求 ：某些特定功能可能只在最新版本中提供。
• 性能和安全 ：选择最新稳定版以获得最佳性能和安全更新。

选择WAR包的步骤

1. 确认你的操作系统和Java环境。
2. 根据操作系统选择相应的WAR包类型。例如，如果你使用的是Linux系统，那么应该下载以 .war 结尾的文件。
3. 确定需要的Java版本。比如，如果你使用的是Java 8，那么应该选择兼容Java 8的Jenkins WAR包。
4. 检查可用的特性，并与你的需求对比，确认是否需要最新的功能。
5. 下载对应版本的WAR包到本地。

当你从官方网站下载WAR包时，应关注页面上的说明，有时会提到版本特定的注意事项或已知问题。下载后，确保检查文件的完整性，通常可以使用MD5或SHA-1校验码来验证。

5.3 下载并验证Jenkins WAR包的完整性

为了确保下载的WAR包没有损坏或被篡改，验证其完整性是非常重要的一步。Jenkins官网为每个发布的版本提供了相应的MD5或SHA-1校验码。这些校验码可以帮助你确认下载文件的完整性，从而保证部署过程的可靠性和安全性。

验证步骤

1. 下载相应的校验码文件，通常是一个文本文件，例如 jenkins.war.md5 或 jenkins.war.sha1 。
2. 使用命令行工具，比如Linux中的 md5sum 或 sha1sum 命令，或者Windows系统中的PowerShell命令来验证WAR包。
3. 使用下载的校验码文件中提供的哈希值和命令行工具生成的哈希值进行对比。

示例代码块

# 使用md5sum命令验证MD5校验码
md5sum -c jenkins.war.md5

# 使用sha1sum命令验证SHA-1校验码
sha1sum -c jenkins.war.sha1

验证时，如果输出结果为”OK”，则说明文件完整，可以继续进行下一步的部署。如果显示错误，则表示文件可能在下载过程中损坏或被篡改，此时应重新下载WAR包。

一旦验证通过，你可以将WAR包放置到Tomcat的 webapps 目录下，以便在下一章节中完成部署。请记得备份WAR包和相关的校验码文件，以便将来需要时验证文件的完整性。

至此，第五章的三个小节已经详细描述了从Jenkins官网获取、选择合适版本以及验证WAR包完整性的详细步骤。在开始部署之前，请确保你已经完全按照这些指示操作，以保证整个部署过程的顺利进行。

6. 启动Tomcat并部署Jenkins

在我们安装并配置好Tomcat服务器之后，接下来的步骤是启动Tomcat服务，以及部署Jenkins WAR包。本章节将详细指导您完成这些任务，并确保Jenkins能够在Tomcat服务器中顺利运行。

6.1 启动Tomcat服务

启动Tomcat服务是部署Jenkins的第一步。确保您已经正确安装了Tomcat，并且按照前文所述配置好了系统环境变量。下面是启动Tomcat服务的具体步骤。

首先，打开命令行工具。在Windows系统中，您可以使用命令提示符（CMD）或PowerShell。在Unix/Linux系统中，则使用终端（Terminal）。

接着，切换到Tomcat的 bin 目录下。这个目录包含了用于启动和停止Tomcat的脚本文件。命令示例如下：

cd /path/to/your/tomcat/bin

在该目录下，根据您的操作系统选择合适的脚本文件来启动Tomcat服务。对于Windows系统，使用 startup.bat 脚本；对于Unix/Linux系统，使用 startup.sh 脚本。

Windows系统示例：

startup.bat

Unix/Linux系统示例：

./startup.sh

执行上述命令后，Tomcat服务应该会被启动。如果遇到任何错误，Tomcat会输出错误信息到控制台，您可以根据这些信息进行问题排查。

6.1.1 验证Tomcat服务启动状态

服务启动后，您可以通过访问Tomcat默认的欢迎页面来验证服务是否正常运行。在Web浏览器中输入以下地址：

http://localhost:8080

如果看到Tomcat的默认欢迎页面，说明Tomcat服务已经成功启动。如果访问失败，请检查Tomcat的端口号（默认是8080，如果被占用，需要修改 server.xml 文件中相应的配置）以及防火墙设置。

6.2 部署Jenkins WAR包到Tomcat

部署Jenkins的WAR包是使用Tomcat作为其Web应用服务器的一部分。以下是如何将Jenkins WAR包部署到Tomcat的详细步骤。

6.2.1 将Jenkins WAR包复制到Tomcat的 webapps 目录

首先，确保您已经从Jenkins官网下载了合适的WAR包，并且已经验证了其完整性。接下来，将WAR包复制到Tomcat的 webapps 目录下。

cp /path/to/jenkins.war /path/to/your/tomcat/webapps/

6.2.2 自动部署Jenkins

Tomcat能够自动识别 webapps 目录下的WAR包，并在启动时自动部署这些应用。由于我们已经将Jenkins WAR包复制到了这个目录下，因此当Tomcat重新启动或者重启时，它会自动部署Jenkins。

6.2.3 手动部署Jenkins

在某些情况下，您可能需要手动部署WAR包。这可以通过访问Tomcat的 Manager App 来完成。首先，确保Tomcat的 manager 应用已经启动并且可用。

通过输入以下地址来访问 Manager App ：

http://localhost:8080/manager/html

通常，您需要使用用户名和密码登录。这些凭据可以通过修改 tomcat-users.xml 文件进行设置。成功登录后，您可以通过界面上传WAR包，并进行部署。

6.3 检查Jenkins在Tomcat中的部署状态

在部署Jenkins WAR包之后，需要检查其部署状态以确保部署成功。这可以通过访问Tomcat的管理界面或者直接访问Jenkins应用来进行。

6.3.1 使用Tomcat管理界面检查

如前文所述，通过 Manager App 的Web界面可以查看所有部署的应用。如果看到名为 jenkins 的应用已经部署，并且状态为 running ，则说明部署成功。

6.3.2 直接访问Jenkins

另一种检查部署状态的方法是直接访问Jenkins的首页。按照以下地址访问：

http://localhost:8080/jenkins

如果Jenkins成功部署，您将看到初始化页面。如果没有看到Jenkins页面，可能是因为部署过程中存在问题，这时候需要检查Tomcat的日志文件来定位问题。

6.3.3 日志检查

Tomcat的日志文件位于其 logs 目录下。最常见的日志文件是 catalina.out 。检查这个文件可以获取关于Jenkins部署和启动的详细信息。使用以下命令来查看日志：

tail -f /path/to/your/tomcat/logs/catalina.out

在日志文件中寻找关于Jenkins的任何错误信息。如果有错误，这些信息将对问题诊断有很大帮助。

6.4 常见问题排查

部署过程中可能会遇到一些常见问题。以下是一些常见问题及其排查方法。

6.4.1 端口冲突

如果Tomcat无法启动，并在日志中显示端口冲突的错误，那么您需要修改 server.xml 中的端口号。找到以下行并修改端口：

<Connector port="8080" ... />

6.4.2 权限问题

如果遇到权限相关的问题，请确保运行Tomcat的用户具有对Tomcat安装目录及其子目录的足够权限。

6.4.3 WAR包不完整或损坏

如果Jenkins应用无法正常加载，可能是因为WAR包不完整或损坏。确保从Jenkins官网下载的WAR包完整且未损坏。

通过以上步骤，您应该能够在Tomcat服务器上成功部署并启动Jenkins。如果遇到任何问题，请根据日志文件中的错误信息进行排查。接下来，您将进入Jenkins的初始化和访问设置阶段，这是第七章的内容。

7. Jenkins初始化及访问设置

7.1 访问Jenkins首页并完成初始化设置

初始化Jenkins是安装过程中的重要一步，它涉及到配置系统的基本参数，并为后续的管理活动打下基础。完成Tomcat部署Jenkins WAR包之后，首先需要在浏览器中输入Tomcat服务器的地址加上Jenkins的上下文路径访问Jenkins首页。

例如，如果Tomcat运行在本地服务器且使用默认端口8080，Jenkins部署在根路径下，则访问的URL通常是 http://localhost:8080/jenkins/ 。

首次访问Jenkins首页时，会看到一个初始化页面，提示你输入初始管理员密码。需要前往Tomcat服务器的安装目录，打开 logs 目录，找到 jenkins.log 文件，查找初始密码。在命令行中可以使用如下命令来快速找到密码：

cat /path/to/tomcat/logs/jenkins.log | grep "INFO: Jenkins is fully up and running"

找到密码后，将其输入到初始化页面中，然后点击“继续”按钮进入下一步，完成插件安装推荐步骤。安装推荐的插件可以帮助你快速开始使用Jenkins，同时也可以选择自定义安装，这通常适用于对Jenkins有特定需求的用户。

完成插件安装后，系统会提示你设置管理员用户信息，包括用户名、密码和邮箱地址。这些信息将用于登录Jenkins管理界面和接收系统通知。设置完成后，点击保存并完成按钮，即可完成Jenkins的初始化过程。

7.2 设置Jenkins全局安全配置

初始化完成后，为了保证Jenkins的安全性，需要进行一些安全设置。安全设置通常在Jenkins的管理界面中的“系统配置”部分进行配置。

进入“管理Jenkins” > “配置系统”，找到“安全”部分，这里可以配置全局安全策略。默认情况下，Jenkins提供了几种安全域实现：

• Jenkins专有用户数据库
• LDAP
• 系统集成的外部用户认证
• 禁用安全

对于大多数环境，推荐使用“Jenkins专有用户数据库”，因为它提供了简单且易于管理的用户验证和授权机制。在“安全”部分中，可以配置登录限制、会话超时等参数，以增强系统的安全性。

7.3 完成管理员账户和邮箱配置

管理员账户和邮箱的配置是保证系统正常通讯和管理的必要步骤。在“系统配置”界面中找到“管理用户”部分，可以在这里配置和管理管理员账户信息。

这里不仅可以修改当前登录管理员账户的密码，还可以添加新的管理员账户。为确保系统有备份的管理账户，强烈建议创建至少一个额外的管理员账户。

邮箱配置则涉及到Jenkins如何发送邮件给管理员或用户。可以通过设置SMTP服务器的详细信息来配置邮件发送功能。这包括SMTP服务器地址、端口、用户名、密码等信息。配置完成后，可以发送测试邮件来验证配置是否正确。

以上步骤完成后，Jenkins就可以用于正常的项目构建和管理任务了。然而，为了进一步提升工作效率，下一章将介绍如何通过安装和配置Jenkins插件来增强Jenkins的功能。

本文还有配套的精品资源，点击获取

简介：在Linux环境下，通过Tomcat服务器部署Jenkins WAR包是一种高效实现持续集成和自动化部署的方法。本文详细介绍了部署过程，包括安装Java环境、配置Tomcat服务器、下载并启动Jenkins WAR包、初始化设置、访问和配置Jenkins，以及定期更新维护。掌握这些步骤，可以帮助开发者和系统管理员优化开发流程并提升团队效率。

本文还有配套的精品资源，点击获取