hudson(jenkins)搭建手册

### Hudson (Jenkins) 搭建手册 #### 第1章 概述 Hudson（后更名为Jenkins）是一款开源的持续集成工具，主要用于自动化构建、测试和部署软件项目。本手册将详细介绍如何搭建和使用Hudson来创建敏捷开发环境。 #### 第2章 基础篇 ##### 2.1 Hudson 安装 ###### 2.1.1 资源下载 1. **下载Hudson** 首先从官方网站 [http://hudson-ci.org/](http://hudson-ci.org/) 下载最新的Hudson版本，当前最新版本为1.383，下载文件名为`hudson.war`。 2. **环境准备** - **JAVA_HOME**: 设置JDK的安装目录，推荐使用JDK5或更高版本。 - **ANT_HOME**: 设置Ant的安装目录，建议使用最新版本1.8。 - **HUDSON_HOME**: 设置Hudson的配置文件目录，建议设为Hudson的安装目录，以便于管理和备份。 - **PATH**: 将Java和Ant的bin目录加入到系统PATH环境中。 - **CLASSPATH**: 将JDK的`tools.jar`加入到系统CLASSPATH环境中。 ###### 2.1.2 运行Hudson 的前提 1. **环境变量设置** - 确保`JAVA_HOME`、`ANT_HOME`、`HUDSON_HOME`、`PATH`和`CLASSPATH`已经正确设置。 2. **外部条件** - 需要WebLogic9.2.3的远程控制的jar文件：`weblogic_sp.jar`、`weblogic.jar`和`webservices.jar`。这些文件位于WebLogic安装目录下的`server\lib`目录中，并需将它们添加到系统CLASSPATH环境变量中。 ###### 2.1.3 Hudson 启动 1. **直接通过命令行** - 转到`hudson.war`所在目录，例如`D:\hudson`。 - 使用命令`java -jar hudson.war --httpPort=8080 –prefix=hudson`启动Hudson，其中`httpPort`表示Hudson运行的端口，默认为8080。 2. **在Web容器中运行** - 可以在标准的Web服务器如Tomcat、JBoss或WebLogic中部署Hudson，只需将`hudson.war`放置到Web服务器的webapps目录下，然后启动服务器。 ###### 2.1.4 Hudson 访问 - 验证Hudson是否运行正常，可以通过访问`http://hostIP:port/hudson`来进行。Hudson支持IE、Firefox等多种浏览器。 ##### 2.2 Hudson 基本设置 ###### 2.2.1 设置JDK - 在Hudson的系统管理页面中，可以设置`JAVA_HOME`。如果系统已设置`JAVA_HOME`，则无需重复配置。此外，Hudson还可以自动安装额外的JDK版本。 ###### 2.2.2 设置ANT - 在系统管理页面中，可以设置`ANT_HOME`。如果系统已设置`ANT_HOME`，则无需重复配置。Hudson还支持自动安装最新版本的Ant。 ###### 2.2.3 配置邮件信息 - 为了使Hudson能够在构建完成后发送邮件通知，需要配置邮件服务器的相关信息。包括SMTP服务器地址、端口、登录用户名和密码等。同时需要配置Hudson的URL地址作为后期访问地址。 ##### 2.3 创建任务 1. **新建任务** - 在Hudson主菜单点击“新建任务”，输入任务名称并选择构建类型。 2. **配置构建环境** - 根据项目的具体需求，配置构建脚本（如Ant或Maven构建命令）、源代码仓库信息、构建触发器等。 3. **运行构建** - 可以手动触发构建，也可以通过配置定时任务自动触发构建。 4. **查看构建结果** - 构建完成后，可以在Hudson的主控制面板中查看构建的状态和日志。 #### 第3章 提高篇 ##### 3.1 插件管理 1. **FindBugs插件设置** - FindBugs插件用于静态代码分析，可以帮助发现潜在的bug。配置FindBugs插件需要指定扫描规则集和扫描范围。 2. **Ftp插件配置** - Ftp插件用于构建后的结果上传到FTP服务器上，方便远程访问构建结果。 3. **JUnit插件** - JUnit插件用于整合JUnit测试报告，便于在Hudson界面中查看测试结果。 4. **远程访问触发** - 通过HTTP请求触发构建，适用于自动化测试场景。 5. **WebLogic.Deployer** - WebLogic.Deployer插件用于部署应用程序到WebLogic服务器。 ##### 3.2 安全篇 - 包括用户权限管理、认证机制、SSL加密等高级安全配置。 ##### 3.3 个性化设置 - 包括界面主题、语言选择等个性化选项。 #### 第4章 常见问题 1. **EditLock问题** - EditLock是由于多个用户同时尝试编辑同一个配置导致的冲突，解决方法是在编辑前锁定配置。 2. **IOException: Unable to delete问题** - 这个问题是由于文件被占用导致无法删除。解决方法通常是重启Hudson或者检查文件的权限设置。 3. **Not recognized as a valid application type问题** - 这个问题通常出现在部署某些特定类型的Web应用程序时。解决方案是确保应用程序打包格式正确，例如使用正确的WAR文件格式。 #### 第5章 其它说明 ##### 5.1 CI挑战 - 持续集成（CI）面临的挑战包括构建时间过长、测试覆盖率不足、构建频繁失败等问题。 ##### 5.2 ANT基本知识 - Ant是一个基于Java的构建工具，用于自动化构建过程。它通过XML构建文件来定义构建步骤，支持多种任务如编译Java源代码、运行测试等。 通过上述章节的学习，您应该能够熟练掌握Hudson的基础安装和配置，以及如何利用其丰富的插件生态系统来提高构建效率和质量。对于新手来说，逐步学习并实践这些内容是构建敏捷开发环境的关键步骤。