Jenkins 简明教程

Jenkins Tomcat 设置必须满足以下先决条件。

对于本练习，您需要确保已从安装了 Jenkins 的机器上连接互联网。在 Jenkins 仪表板（主屏幕）中，单击左侧的管理 Jenkins 选项。

在下一个屏幕中，单击“管理插件”选项。

在下一个屏幕中，单击“可用”选项卡。此选项卡将提供可下载的插件列表。在“筛选”选项卡中，键入“Git 插件”

随后将筛选列表。选中 Git 插件选项，然后单击按钮“不重启安装”

然后将开始安装，并且屏幕将刷新以显示下载状态。

所有安装完成后，使用浏览器中的以下命令 restart Jenkins。 http://localhost:8080/jenkins/restart

Jenkins 重新启动后，在配置作业时 Git 将可用作一个选项。要验证，单击 Jenkins 菜单选项中的新建项。然后为作业输入名称，在以下情况下，输入的名称为“Demo”。选择“自由风格项目”作为项目类型。单击确定按钮。

在下一个屏幕中，如果您浏览到源代码管理部分，您现在将会看到“Git”作为一项选项。

您可能在之前的练习中看到过我们不得不在 Jenkins 内配置选项的几次。下面显示了 Jenkins 中的各种配置选项。

因此，可以通过单击左侧菜单侧的“管理 Jenkins”选项来获取 Jenkins 的各种配置选项。

然后，将显示以下屏幕 -

单击配置系统。下面讨论了一些 Jenkins 配置设置，这些设置可以执行。

要管理 Jenkins，请单击左侧菜单侧的“管理 Jenkins”选项。

因此，可以通过单击左侧菜单侧的“管理 Jenkins”选项来获取 Jenkins 的各种配置选项。

然后，将显示以下屏幕 -

系统管理选项中的部分选项如下 −

对于此练习，我们将在 Jenkins 中创建一个作业，该作业将选取一个简单的 HelloWorld 应用程序，构建并运行 Java 程序。

Step 1 − 转到 Jenkins 仪表板并单击新建项

Step 2 − 在下一个屏幕中，输入项名称，在本例中我们将其命名为 Helloworld。选择“Freestyle project option”（自由风格项目选项）

Step 3 − 将出现以下屏幕，你可以在其中指定作业的详细信息。

Step 4 − 我们需要指定需要构建的文件的位置。在此示例中，我们将假设已设置包含“HelloWorld.java”文件的本地 Git 存储库 (E:\Program)。因此，向下滚动并单击 Git 选项，然后输入本地 Git 存储库的 URL。

Note − 如果你将存储库托管在 Github 上，你还可以在此处输入该存储库的 URL。除此之外，你需要单击凭据的添加按钮，以便向 Github 存储库添加用户名和密码，以便可以从远程存储库中选取代码。

Step 5 − 现在转到构建部分，然后单击添加构建步骤 → 执行 Windows 批处理命令

Step 6 − 在命令窗口中，输入以下命令，然后单击保存按钮。

Step 7 − 保存后，你可以单击立即构建选项，查看你是否已成功定义作业。

Step 8 − 计划构建后，它将运行。以下构建历史记录部分显示构建正在进行。

Step 9 − 构建完成后，构建状态将显示构建是否成功。在我们的示例中，已成功执行以下构建。单击构建历史记录中的 #1，以显示构建的详细信息。

Step 10 − 单击控制台输出链接查看构建的详细信息

除了上面显示的步骤之外，还有很多方法可以创建构建作业，可用的选项很多，这使得 Jenkins 成为如此出色的持续部署工具。

Jenkins 为 Junit 提供开箱即用的功能，并针对其他技术提供大量单元测试插件，例如用于 .Net 单元测试的 MSTest。如果你前往链接 https://wiki.jenkins-ci.org/display/JENKINS/xUnit+Plugin ，它将提供可用的单元测试插件列表。

持续集成的基本原则之一是构建应该是可验证的。您必须能够客观确定特定构建是否准备好进入构建过程的下一阶段，而最便捷的方式是使用自动化测试。如果没有适当的自动化测试，您会发现自己必须保留许多构建工件并手动测试它们，这几乎不符合持续集成的精神。以下示例展示了如何使用 Selenium 运行自动化网络测试。

Step 1 − 前往“管理插件”。

Step 2 − 找到 Hudson Selenium 插件并选择安装。重新启动 Jenkins 实例。

Step 3 − 前往“配置系统”。

Step 4 − 配置 Selenium 服务器 jar，并单击“保存”按钮。

Note − Selenium jar 文件可以从以下位置下载： SeleniumHQ

单击下载 Selenium 独立服务器。

Step 5 − 返回到您的仪表板并单击 HelloWorld 项目的“配置”选项。

Step 6 − 单击“添加构建步骤”并选择“seleniumHQ htmlSuite 运行”选项。

Step 7 − 添加 Selenium 测试的必要详细信息。这里的 suiteFile 是使用 Selenium IDE 生成的 TestSuite。点击保存并执行构建。现在，构建后会启动 Selenium 驱动程序并执行 html 测试。

Jenkins 自带了一项开箱即用的功能，可为构建项目添加电子邮件通知。

Step 1 - 配置 SMTP 服务器。转到管理 Jenkins → 配置系统。转到电子邮件通知部分，并输入所需的 SMTP 服务器和用户电子邮件后缀详细信息。

Step 2 - 在 Jenkins 项目中配置收件人 - 当你配置任何 Jenkins 构建项目时，最后都会有能力添加将收到不稳定或中断构建电子邮件通知的收件人。然后，单击保存按钮。

除了默认设置外，市场上还有通知插件可用。一个示例是 Tikal Knowledge 的通知插件，它允许 JSON 和 XML 格式发送 job 状态通知。此插件允许将端点配置如下所示。

以下是每个选项的详细说明 -

如上文所示，有许多可用报告插件，最简单的插件是为 jUnit 测试提供的报告。

在任何作业的后构建操作中，您可以定义要创建的报告。构建完成之后，测试结果选项将可用以供进一步细化。

Jenkins 有一系列代码分析插件。各种插件可以在 https://wiki.jenkins-ci.org/display/JENKINS/Static+Code+Analysis+Plugins 找到。

该插件为静态代码分析插件提供实用程序。Jenkins 可以解析来自各种代码分析工具（例如 CheckStyle、FindBugs、PMD 等）的结果文件。对于每个相应的代码分析工具，需要在 Jenkins 中安装相应的插件。

此外，插件附加项 Static Analysis Collector 可以将这些插件的个别结果合并到单个趋势图和视图中。

该插件可以提供以下信息：

如果存在需要定期构建的更大、更繁重的项目，有时需要使用许多构建机器。在中央机器上运行所有这些构建可能不是最佳选择。在这样的情况下，可以将其他 Jenkins 机器配置为从属机器以减轻主 Jenkins 服务器的负载。

有时您可能还需要不同的环境来测试您的构建。在这种情况下，几乎必须使用从属来表示每个所需的环境。

从属是一台计算机，用于从主服务器卸载构建项目，一旦完成设置，此任务分配将是完全自动的。确切的委派行为取决于每个项目的配置；一些项目可能会选择“坚持”到特定机器进行构建，而另一些项目可能会选择在从属之间自由漫游。

由于每个从属都运行一个称为“从属代理”的单独程序，因此无需在从属上安装完整的 Jenkins（程序包或编译的二进制文件）。有各种方法可以启动从属代理，但最终从属代理和 Jenkins 主程序需要建立双向通信链接（例如 TCP/IP 套接字）才能运行。

要在 Jenkins 中设置从属/节点，请按照以下步骤操作。

Step 1 - 转到管理 Jenkins 部分并向下滚动到管理节点部分。

Step 2 - 单击新建节点

Step 3 - 为节点指定一个名称，选择哑从属选项并单击确定。

Step 4 - 输入节点从属机器的详细信息。在下面的示例中，我们认为从属机器是 Windows 机器，因此选择“让 Jenkins 以 Windows 服务形式控制此 Windows 从属”作为启动方法。我们还需要添加从属节点的必要详细信息，例如节点名称和节点机器的登录凭据。单击保存按钮。标签名称输入为“New_Slave” 的内容可用于配置作业以使用此从属机器。

完成上述步骤后，新节点机器最初将处于脱机状态，但如果正确输入前一个屏幕中的所有设置，则它将变为联机状态。如果需要，可以随时使节点从属机器脱机。

有许多可用的插件，这些插件可用于在成功构建后将构建文件传输到相应应用程序/Web 服务器。一个示例是“将文件部署到容器插件”。若要使用，请按照以下步骤操作。

Step 1 − 转到“管理 Jenkins → 管理插件”。转到“可用”部分，找到插件“将文件部署到容器插件”，然后安装插件。重新启动 Jenkins 服务器。

该插件会获取一个 war/ear 文件，并在构建结束时将该文件部署到正在运行的远程应用程序服务器。

Tomcat 4.x/5.x/6.x/7.x

JBoss 3.x/4.x

Glassfish 2.x/3.x

Step 2 − 转到“Build project”，然后单击“Configure”选项。选择“将 war/ear 部署到容器”选项

Step 3 − 在“将 war/ear 部署到容器”部分，输入需要部署文件的服务器所需详细信息，然后单击“Save”按钮。这些步骤现在将确保在成功构建后将所需文件部署到所需的容器。

Jenkins 中提供各种插件，用于展示一段时间内执行的构建的指标。这些指标非常有用，可以帮助您了解构建以及它们随时间推移的失败/通过频率。例如，我们来看看“构建历史记录指标插件”。

该插件在安装后会为所有构建计算以下指标：

Step 1 − 转到 Jenkins 仪表板，并单击“Manage Jenkins（管理 Jenkins）”

Step 2 − 转到“Manage Plugins（管理插件）”选项。

Step 3 − 转到“Available（可用）”选项卡，搜索插件“Build History Metrics plugin（构建历史记录指标插件）”，并选择“install without restart（不重启安装）”。

Step 4 − 屏幕上将显示以下画面，确认已成功安装插件。重新启动 Jenkins 实例。

转到“Job（作业）”页面时，您将看到包含已计算指标的表格。指标显示为过去 7 天、过去 30 天以及所有时间段。

要查看 Jenkins 中的总体趋势，可以使用插件来收集 Jenkins 和构建中的信息，并以图表格式显示这些信息。此类插件的一个示例为“Hudson global-build-stats plugin”。接下来，我们按步骤执行。

Step 1 − 转到 Jenkins 仪表板，并单击“Manage Jenkins（管理 Jenkins）”

Step 2 − 转到“Manage Plugins（管理插件）”选项

Step 3 − 转到“Available（可用）”选项卡，搜索插件“Hudson global-build-stats plugin（Hudson 全局构建统计插件）”，并选择“install without restart（不重启安装）”。

Step 4 − 屏幕上将显示以下画面，确认已成功安装插件。重新启动 Jenkins 实例。

要查看全局统计信息，请按照步骤 5 至 8 进行操作。

Step 5 − 转到 Jenkins 仪表板，并单击“Manage Jenkins（管理 Jenkins）”。在“Manage Jenkins（管理 Jenkins）”屏幕中向下滚动，您现在将看到一个名为“Global Build Stats（全局构建统计信息）”的选项。单击此链接。

Step 6 − 单击“Initialize stats（初始化统计信息）”按钮。此操作将收集已执行构建的所有现有记录，并根据这些结果创建图表。

Step 7 − 初始化数据后，即可创建新图表。单击“Create new chart（创建新图表）”链接。

Step 8 − 屏幕上会出现一个弹出窗口，其中输入新图表详细信息的相关信息。输入以下必需信息：

其余信息可以保留原样。输入信息后，单击“Create New chart（创建新图表）”。

您现在将会看到显示构建随时间推移趋势的图表。

如果您单击图表中的任何部分，它将为您提供有关该作业及其构建的详细信息的分解。

以下是一些您将执行的基本活动，其中一些是 Jenkins 服务器维护的最佳实践

Jenkins 为提供连续部署和交付提供了良好的支持。如果您查看通过部署进行的任何软件开发流程，它将如下所示。

持续部署的主要部分是确保上面显示的整个流程是自动化的。Jenkins 通过各种插件实现所有这些，其中之一是“部署到容器插件”，该插件在早期课程中介绍过。

有可用的插件可以实际提供连续部署流程的图形化表示。但首先在 Jenkins 中创建另一个项目，以便我们可以很好地了解此内容如何运作。

让我们创建一个模拟 QA 阶段的简单项目，并对 Helloworld 应用程序执行测试。

Step 1 − 进入 Jenkins 仪表盘并单击“新建项目”。选择“自由风格项目”，然后输入项目名称“QA”。单击“确定”按钮创建项目。

Step 2 − 在此示例中，我们保持简单，只需使用此项目为 Helloworld 应用程序执行测试程序。

所以我们的 QA 项目现已设置。您可以进行构建以查看是否正确构建。

Step 3 − 现在进入您的 Helloworld 项目并单击“配置”选项

Step 4 − 在项目配置中，选择“添加构建后操作”，然后选择“构建其他项目”。

Step 5 − 在“要构建的项目”部分，输入 QA 作为要构建的项目名称。您可以将选项保留为默认的“仅在构建稳定时触发”。单击保存按钮。

Step 6 − 构建 Helloworld 项目。现在，如果您查看控制台输出，您还将看到在 Helloworld 项目成功构建后，QA 项目的构建也会发生。

Step 7 − 现在安装 Delivery pipeline 插件。转至管理 Jenkins → 管理插件。在可用选项卡中，搜索“Delivery Pipeline 插件”。单击无需重新启动即可安装。完成后，重启 Jenkins 实例。

Step 8 − 要在操作中查看 Delivery pipeline，在 Jenkins 仪表板中，单击“全部”选项卡旁边的选项卡中的加号符号。

Step 9 − 输入任何视图名称，然后选择“Delivery pipeline 视图”选项。

Step 10 − 在下一个屏幕中，您可以保留默认选项。可以更改以下设置 −

您现在可以查看整个交付管道的出色视图，并且您将能够看到整个管道中每个项目的进度。

另一个著名的插件是 build pipeline plugin 。让我们来看看这个。

Step 1 − 转至管理 Jenkins → 管理插件。在可用选项卡中，搜索“Build Pipeline 插件”。单击无需重新启动即可安装。完成后，重启 Jenkins 实例。

Step 2 − 要在操作中查看 Build pipeline，在 Jenkins 仪表板中，单击“全部”选项卡旁边的选项卡中的加号符号。

Step 3 − 输入任何视图名称，然后选择“Build Pipeline 视图”选项。

Step 4 − 接受默认设置，仅在选定的初始作业中，确保输入 Helloworld 项目的名称。单击确定按钮。

您现在可以查看整个交付管道的出色视图，并且您将能够看到整个管道中每个项目的进度。

要获取 Jenkins 中所有可用插件的列表，可以访问链接 − https://wiki.jenkins-ci.org/display/JENKINS/Plugins

我们已经看到了很多安装插件的实例，让我们看看与插件相关的其他一些维护任务

在 Jenkins 中，您可以设置用户及其在 Jenkins 实例上的相关权限。默认情况下，您不希望每个人都能够在 Jenkins 中定义作业或其他管理任务。因此，Jenkins 具有使用安全配置的能力。

要配置 Jenkins 中的安全，请执行以下步骤。

Step 1 − 单击“管理 Jenkins”，然后选择“配置全局安全性”选项。

Step 2 − 单击“启用安全”选项。作为一个示例，让我们假设我们希望 Jenkins 维护它自己的用户数据库，因此在“安全域”中，选择“Jenkins 自己的用户数据库”选项。

默认情况下，您希望中央管理员在系统中定义用户，因此请确保未选中“允许用户注册”选项。您可以暂时将其余选项保持原样，然后单击“保存”按钮。

Step 3 − 您将被提示添加您的第一个用户。作为一个示例，我们正在为系统设置一名管理员用户。

Step 4 − 现在是时候在系统中设置您的用户了。现在，当您转到“管理 Jenkins”，然后向下滚动时，您将看到“管理用户”选项。单击此选项。

Step 5 − 就像您定义管理员用户一样，开始为系统创建其他用户。作为一个示例，我们只创建了名为“user”的另一个用户。

Step 6 − 现在是设置您的权限的时候了，基本上是谁可以访问什么。转到“管理 Jenkins → 配置全局安全性”。

现在在授权部分，点击“基于 Matrix 的安全性”

Step 7 - 如果你在用户组列表中看不到该用户，输入用户名并将其加入到列表中。然后给用户分配相应的权限。

在你定义相关的授权之后，点击保存按钮。

你的 Jenkins 安全性现已设置好。

Note - 对于 Windows AD 身份验证，有必要给 Jenkins 添加活动目录插件。

Jenkins 有一个备份插件，可用于备份与 Jenkins 相关的关键配置设置。按照以下步骤执行，即可执行备份。

Step 1 − 点击管理 Jenkins 并选择“管理插件”选项。

Step 2 − 在可用选项卡中，搜索“备份插件”。点击在不重启的情况下安装。完成后，重启 Jenkins 实例。

Step 3 − 现在，当您转到管理 Jenkins 并向下滚动时，您会看到“备份管理器”作为一个选项。点击此选项。

Step 4 - 单击设置。

Step 5 - 在这里，要定义的主要字段是备份目录。请确保它位于与 Jenkins 实例设置所在的驱动器不同的另一个驱动器上。单击保存按钮。

Step 6 - 从备份管理器屏幕中单击“备份 Hudson 配置”以启动备份。

下一个屏幕将显示备份状态

要从备份中恢复，请转到备份管理器屏幕，单击还原 Hudson 配置。

将显示备份列表，单击适当的备份以单击启动还原以开始还原备份。

Web 测试，比如硒测试，可以通过 master 从属和 selenium 套件插件安装在远程从属机上运行。下列步骤显示如何使用此配置运行远程测试。

Step 1 - 确保你的 master-slave 配置已经完成。前往你的 master Jenkins 服务器。前往管理 Jenkins → 管理节点。

在我们的节点列表中，DXBMEM30 标签是 slave 机。在本例中，master 和 slave 机器都是 Windows 机器。

Step 2 - 为 DXBMEM30 slave 机点击配置。

Step 3 - 确保启动方法被设置为“通过 Java Web Start 启动从属代理”

Step 4 - 现在前往你的 slave 机并在那里，使用浏览器实例打开你的 Jenkins master 实例。然后前往管理 Jenkins → 管理节点。前往 DXBMEM30 并点击

Step 5 - 点击 DXBMEM30 实例。

Step 6 - 向下滚动，你会看到启动选项，它是启动“Java Web Start”的选项

Step 7 - 你将会收到一条安全警告。点击接受复选框并点击运行。

你现在将会看到一个 Jenkins Slave 窗口被打开，并且已经连接。

Step 8 - 配置你的测试在 slave 上运行。在此，你必须确保被创建的任务具体用于只运行硒测试。

在任务配置中，确保选项“限制该项目可以运行的位置”已被选中，并在标签表达式中放入 slave 节点的名称。

Step 9 - 确保 Selenium 的任务部分已配置。你必须确保 Sample.html 文件和 selenium-server.jar 文件也存在于 slave 机器上。

一旦你完成了所有上述步骤，并点击构建，此项目将会像预期的那样在 slave 机器上运行 Selenium 测试。