jenkins-jdk8.0部署

1. 环境准备

1.1 安装 Java

• Jenkins 依赖 Java 运行，需安装 JDK 8 或 JDK 11（根据 Jenkins 版本选择）：

  1. 下载 JDK：

     • Oracle JDK 8（历史版本需注册账号）

     • OpenJDK 8

  2. 安装 JDK，配置环境变量：

     • 新建系统变量 JAVA_HOME，值为 JDK 安装路径（如 C:\Program Files\Java\jdk1.8.0_361）。

     • 在 Path 中添加 %JAVA_HOME%\bin。

  3. 验证安装：

     bash

      

     复制

      

     下载

     java -version

---

2. 下载 Jenkins WAR 包

1. 访问 Jenkins 官方仓库，选择版本（需兼容你的 Java 版本）：

   • 支持 Java 8 的旧版本（如 2.346.x）：
     https://archives.jenkins.io/war-stable/2.346.3/jenkins.war

   • 新版 Jenkins（需 Java 11+）：
     https://www.jenkins.io/download/ → 选择 "Generic Java package (.war)"

2. 将下载的 jenkins.war 保存到本地目录（如 C:\jenkins）。

---

3. 运行 Jenkins WAR 包

3.1 直接运行（临时测试）

1. 打开命令提示符，进入 jenkins.war 所在目录：

   bash

    

   复制

    

   下载

   cd C:\jenkins

2. 启动 Jenkins：

   bash

    

   复制

    

   下载

   java -jar jenkins.war --httpPort=8080

   • --httpPort：指定端口（默认 8080，若冲突可改为 8081 等）。

   • 控制台会输出初始管理员密码（记下来备用）。

3. 浏览器访问：
   http://localhost:8080

---

3.2 注册为 Windows 服务（后台运行）

直接运行 WAR 包时，关闭命令行窗口会导致 Jenkins 停止。推荐注册为系统服务：

1. 安装 WinSW（Windows Service Wrapper）：

   • 下载 WinSW，选择 .exe 文件（如 WinSW-x64.exe）。

   • 将 WinSW-x64.exe 重命名为 jenkins-service.exe，并复制到 C:\jenkins 目录。

2. 创建配置文件 jenkins-service.xml：
   在 C:\jenkins 中新建文件，内容如下：

   xml

    

   复制

    

   下载

    

    

   运行

   <service>
     <id>jenkins</id>
     <name>Jenkins</name>
     <description>Jenkins CI Server</description>
     <executable>java</executable>
     <arguments>-jar "C:\jenkins\jenkins.war" --httpPort=8080</arguments>
     <logmode>rotate</logmode>
     <onfailure action="restart" />
   </service>

3. 安装服务：

   • 以管理员身份打开命令提示符：

     bash

      

     复制

      

     下载

     cd C:\jenkins
     jenkins-service.exe install

4. 启动服务：

   bash

    

   复制

    

   下载

   net start jenkins

   • 服务状态管理：

     • 停止服务：net stop jenkins

     • 卸载服务：jenkins-service.exe uninstall

---

4. 初始化 Jenkins

1. 浏览器访问 http://localhost:8080。

2. 获取初始管理员密码：

   • 密码文件路径显示在启动日志中（若通过服务启动，查看 %JENKINS_HOME%\secrets\initialAdminPassword，默认路径为 C:\Users\<用户名>\.jenkins）。

3. 安装插件：

   • 选择推荐插件或自定义安装。

4. 创建管理员账户：

   • 设置用户名、密码和邮箱。

---

5. 配置 Jenkins

1. 全局工具配置：

   • 进入 Manage Jenkins > Global Tool Configuration，配置 JDK、Maven、Git 等路径。

2. 插件管理：

   • 安装常用插件（如 Git、Pipeline、SSH）。

---

6. 常见问题

6.1 端口冲突

• 修改启动参数：

  bash

   

  复制

   

  下载

  java -jar jenkins.war --httpPort=8081

6.2 服务启动失败

• 检查日志文件：
  WinSW 的日志位于 C:\jenkins\jenkins-service.wrapper.log。

• 确保 java 命令在 Path 中可访问。

6.3 插件安装缓慢

• 更换国内镜像源：

  1. 进入 Manage Jenkins > Manage Plugins > Advanced。

  2. 修改 Update Site URL 为：

      

      

     复制

      

     下载

     https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

---

7. 数据目录迁移（可选）

默认 Jenkins 数据存储在 C:\Users\<用户名>\.jenkins。若需迁移：

1. 停止 Jenkins 服务。

2. 复制 .jenkins 文件夹到新位置（如 D:\jenkins_home）。

3. 设置环境变量 JENKINS_HOME 指向新路径。

4. 重启服务。