Windows 安装Jenkins

在Windows上安装Jenkins的最简单方法是使用Jenkins Windows安装程序。该程序将使用用户选择的64位JVM将Jenkins安装为服务。请记住，要将Jenkins作为服务运行，运行Jenkins的帐户必须具有作为服务登录的权限。

先决条件

最低硬件要求：

• 256 MB的RAM

• 1 GB的驱动器空间（尽管如果将Jenkins作为Docker容器运行，建议最低为10 GB）

为小型团队推荐的硬件配置：

• 4 GB+ RAM

• 50 GB以上的驱动器空间

全面的硬件建议：

• 硬件：请参阅硬件建议页面

软件要求：

• Java：查看Java需求页面

• Web浏览器：参见Web浏览器兼容性页面

• 对于Windows操作系统：Windows支持政策

• 对于Linux操作系统：Linux支持策略

• 对于servlet容器：Servlet容器支持策略

使用Windows MSI安装程序的安装步骤

如何在Windows上安装Jenkins

请参阅下载Jenkins页面的Windows部分，下载LTS版本或每周发布的Windows安装程序。下载完成后，打开Windows安装程序并按照以下步骤安装Jenkins。

步骤1：安装向导

打开安装包时，将显示安装设置向导，单击设置向导上的下一步开始安装。

步骤2：选择目标文件夹

选择存储Jenkins安装的目标文件夹，然后单击下一步继续。

第3步：Service Logon Credentials

在安装Jenkins时，建议使用本地或域用户将Jenkins作为独立的Windows服务安装和运行，因为这比使用LocalSystem（Windows相当于root）运行Jenkins安全得多，这将授予Jenkins对您的机器和服务的完全访问权限。

要使用本地或域用户运行Jenkins服务，请指定要运行Jenkins的域用户名和密码，单击测试凭据以测试您的域凭据，然后单击下一步。

如果您在尝试测试凭据时出现“Invalid Error”弹出窗口，请按照此处说明的步骤解决此问题。

步骤4：端口选择

指定Jenkins将运行的端口，测试端口按钮用于验证指定的端口是否在您的机器上空闲。因此，如果端口空闲，它将显示一个绿色勾号，如下所示，然后单击Next。

第5步：选择Java主目录

安装过程检查计算机上的Java，并使用Java主目录预填充对话框。如果您的计算机上未安装所需的Java版本，系统将提示您安装它。

选择Java主目录后，单击Next继续。

第6步：自定义设置

选择需要与Jenkins一起安装的其他服务，然后单击Next。

第7步：安装Jenkins

点击安装按钮开始安装Jenkins。

此外，单击安装按钮将显示安装进度条，如下所示：

步骤8：完成Jenkins安装

安装完成后，单击完成以完成安装。

Jenkins将作为Windows服务安装。您可以通过浏览服务部分来验证这一点，如下所示：

使用MSI安装程序进行静默安装

MSI安装程序可以通过静默方式安装，可以显示基本UI（/qb）或根本不显示UI（/qn）。silent方法不提示用户输入，因此可以将一些属性传递给安装程序以设置特定的值。下面显示了静默安装的一个非常基本的命令行。

msiexec.exe /i "path\to\jenkins.msi" /qn /norestart

这将使用所有的默认值，通常是一个提示，如：

• 安装目录

• 用户名/密码

• Java安装目录

• Jenkins监听的端口

这些东西都可以通过传递一个NAME=VALUE属性对来覆盖你想要覆盖的东西：

属性名称	描述
INSTALLDIR	安装Jenkins的目录的路径。（默认：C：\Program Files\Jenkins）
端口	Jenkins将监听的端口。（默认值：8080）
JAVA_主页	可以找到java.exe的目录。（默认值：在注册表中找到的最新推荐Java运行时）
服务_用户名	服务运行时应使用的用户名。帐户必须具有LogonAsService权限。（默认值：在静默模式下，为LOCALSYSTEM帐户）
服务_密码	SERVICE_USERNAME帐户的密码。只有在提供了SERVICE_USERNAME的情况下才应提供此选项。（默认值：在静默模式下，LOCALSYSTEM无）

下面显示了一个更复杂的示例，包括为安装过程创建日志文件：

msiexec.exe /i "path\to\jenkins.msi" /qn /norestart INSTALLDIR="D:\Jenkins" JAVA_HOME="C:\Program Files\SomeJava" PORT=80 /L*v "path\to\logfile.txt"

这将把Jenkins安装到D：\Jenkins中，使用C：\Program Files\SomeJava中的Java运行时，Jenkins将监听端口80。

安装后设置向导

下载、安装和运行Jenkins后，安装后设置向导开始。

这个设置向导将带您完成一些快速的“一次性”步骤来解锁Jenkins，使用插件对其进行自定义，并创建第一个管理员用户，通过该用户您可以继续访问Jenkins。

解锁Jenkins

当你第一次访问一个新的Jenkins实例时，系统会要求你使用自动生成的密码解锁它。

步骤1

浏览到http://localhost:8080（或安装Jenkins时为Jenkins配置的任何端口），并等待直到出现“安装Jenkins”页面。

步骤2

初始管理员密码应该在Jenkins安装路径下找到（在Jenkins安装的步骤2中设置）。

对于默认安装位置C：\Program Files\Jenkins，可以在C：\Program Files\Jenkins\secrets下找到名为initialAdminPassword的文件。

但是，如果选择了Jenkins安装的自定义路径，那么您应该检查initialAdminPassword文件的位置。

步骤3

打开突出显示的文件并复制initialAdminPassword文件的内容。

步骤4

在安装Jenkins页面上，将此密码粘贴到管理员密码字段中，然后单击继续。
备注：

• 您还可以在安装期间指定的Jenkins目录中的jenkins.err.log文件中访问Jenkins日志。

• Jenkins日志文件是另一个可以获取初始密码的位置（在Jenkins主目录中）。

必须在新Jenkins安装的安装向导中输入此密码，然后才能访问Jenkins的主UI。如果您碰巧跳过安装向导中的后续用户创建步骤，此密码也可用作默认管理员帐户的密码（用户名为“admin”）。

使用插件自定义Jenkins

解锁Jenkins后，将显示Customize Jenkins页面。在这里，您可以安装任何数量的有用插件作为初始设置的一部分。

单击显示的两个选项之一：

• 安装建议的插件-安装基于最常见用例的推荐插件集。

• 选择要安装的插件-选择最初要安装的插件集。当您第一次访问插件选择页面时，默认情况下会选择建议的插件。

如果您不确定需要哪些插件，请选择安装建议的插件。您可以稍后通过Jenkins中的Manage JenkinsPlugins

安装向导显示配置Jenkins的进度以及安装您选择的Jenkins插件集。此过程可能需要几分钟。

创建第一个管理员用户

最后，在使用插件自定义Jenkins之后，Jenkins要求您创建第一个管理员用户。

1. 出现“创建第一个管理员用户”页时，在相应字段中指定管理员用户的详细信息，然后单击保存并完成。

2. 当出现Jenkins is ready页面时，单击Start using Jenkins。
   备注：

   • 这个页面可能表明Jenkins几乎准备好了！如果是，请单击“重新启动”。

   • 如果您的浏览器没有自动跳转，请点击这里

3. 如果需要，使用您刚刚创建的用户的凭据登录Jenkins，您就可以开始使用Jenkins了！

Windows安装疑难解答

无效的服务登录凭据

安装要在域用户帐户下运行的服务时，该帐户必须有权作为服务登录。此登录权限严格应用于本地计算机，并且必须在本地安全策略中授予。

执行以下步骤，编辑要定义“作为服务登录”权限的计算机的本地安全策略：

1. 以管理权限访问计算机。

2. 打开管理工具并打开本地安全策略

3. 如果您的系统中缺少本地安全策略，请参阅在哪里下载Windows 10家庭版GPEdit.exe中的答案。有关Microsoft Community的疑难解答问题

4. 展开本地策略，然后单击用户权限分配

5. 在右窗格中，右键单击“作为服务登录”，然后选择“属性”。

6. 单击添加用户或组.按钮以添加新用户。

7. 在“选择用户或组”对话框中，找到要输入的用户，然后单击“确定

8. 单击“作为服务登录”属性中的“确定”以保存更改。

完成上述步骤后，尝试使用添加的用户再次登录。