JENKINS基础使用

gdx

JENKINS总结

修改时间	修改内容	修改人
2016.3.12	创建	刘永志
2016.5.22	添加tomcat+jenkins	刘永志
2016.6.14	添加tomcat找不到ant解决方案	刘永志

　　个人理解持续集成：为解决程序代码提交质量低,提交内容导致原有系统的BUG，按时或按需自动编译版本，进行自动化测试。
　　百度对持续集成的定义：持续集成是一种软件开发实践，即团队开发成员经常集成他们的工作，通常每个成员每天至少集成一次，也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建（包括编译，发布，自动化测试)来验证，从而尽快地发现集成错误。许多团队发现这个过程可以大大减少集成的问题，让团队能够更快的开发内聚的软件。
　　为什么写这篇文章：笔者在学习jenkins的过程中遇到了很多坑，且学习过程中好多搜到的资料过于零散，导致学习进度缓慢，想通过这篇文章，能让大家在学习的过程中少走弯路。虽然我预计这篇文章是做不到的，但是能够帮助到几位也是好的，以此为望，大家共勉。
一、Jenkins安装

系统&安装方式	直接使用WAR文	安装包安装	将WAR文件放到WEB容器
Windows系统	难度：低	难度：中	难度：高
Linux系统	难度：低	难度：中	难度：高
Mac系统	难度：低	难度：中	难度：高

　　笔者推荐直接使用WAR文件，越简单的东西越适合初学者。且笔者在使用安装包安装中，出现过一次无法获取插件列表的情况。
Windows下安装：

系统版本	JDK版本	Jenkins版本
Windows10	JDK8	Jenkins1.651

• 安装JDK：（windows下jdk的安装及环境变量配置百度一下）
  
• 
  下载安装最新版本Jenkins：
  登陆 http://jenkins-ci.org/ 下载windows版本
  下载的压缩包内含一个.msi程序，直接安装
  
  
  
  
• 
  访问Jenkins：直接访问Jenkins http://本机IP：8080 （8080为jenkins默认端口号）
  
  
  
  

Linux Ubuntu下安装：

系统版本	JDK版本	Jenkins版本
Ubuntu 14.04LTS 桌面版	Openjdk-7-jdk	Jenkins1.651

Ubuntu安装包安装：

• 
  安装open-JDK：　　sudo apt-get install openjdk-7-jdk
  
• 
  安装Jenkins：　　   wget -q -O - http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key | sudo apt-key add -
      sudo sh -c 'echo deb http://pkg.jenkins-ci.org/debian binary/ > /etc/apt/sources.list.d/jenkins.list'
      sudo apt-get update -y
      sudo apt-get install jenkins -y
  
• 
  安装位置：　　安装目录：/var/lib/jenkins
  日志目录：/var/log/jenkins/jenkins.log
  
• 
  启动停止服务：　　   sudo /etc/init.d/jenkins start
      sudo /etc/init.d/jenkins stop
  
• 
  访问jenkins：　　http://本机IP:8080/
  

直接使用WAR文件：

• 安装open-JDK（同上文）
  
• 
  下载war文件
  
  
  
  

• 
  将对应war文件传入linux服务器（以下简单介绍几种传入方式，仅仅提供思路以做百度谷歌之用）
  
  
  
  • 架设FTP服务器
    
  • Winscp工具传入
    
  • 虚拟机可用虚拟机增强工具拖入或启动共享文件夹
    
  • U盘等硬件接入
    
  
  
• 
  使用war文件开启服务　　Java -jar /home/jenkins.war(wan文件路径) --Port=8080（端口）
  

• 
  访问jenkins　　http://本机IP:8080/
  
• 
  将服务加入开机启动　　    cd /etc/init.d     //切换目录
    vi jenkins.sh     //编写shell脚本
  插入java -jar /home/jenkins.war(wan文件路径) --Port=8080（端口）&         //后台运行
    chmod 755 jenkins.sh    //修改shell脚本权限
    update-rc.d test defaults 95（启动顺序编号）     //加入启动项
    update-rc.d -f jenkins.sh remove   //删除启动项（需在/etc/init.d目录下执行）
  
  
• 
  Jenkins的安装目录:　　/root/.jenkins/
  
• 
  访问jenkins：　　http://本机IP:8080/jenkins/
  

TomCat+Jenkins：

• 下载安装jdk（同上文）
  
• 下载WAR文件（同上文）
  
• 
  下载安装tomcat
  
  
  • 
    下载tomcat  　　http://tomcat.apache.org/download-80.cgi
    
  • 将tomcat安装包传入服务器
    
  • 
    解压安装包　　tar -cvzf apache-tomcat-8.0.12.tar.gz
    
  • 
    复制解压文件到你想要的安装路径　　cp -r apache-tomcat-8.0.12 /目标路径
    
  • 
    进入安装路径，以/opt/tomcat/为例　　cd /opt/tomcat/
    
  • 
    编辑tomcat启动脚本，加入环境变量　　vim ./bin/startup.sh
    　　加入一下内容，路径改为你自己的环境变量路径
    　　JAVA_HOME=/usr/lib/jvm/jdk1.8.0_31
    　　JRE_HOME=${JAVA_HOME}/jre
    　　PATH=$JAVA_HOME/bin:$PATH
    　　CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
    　　TOMCAT_HOME=/opt/apache-tomcat-8.0.17
    　　ps：需要放在exec "$PRGDIR"/"$EXECUTABLE" start "$@"这一行上边
    
  • 
    编辑catalina.sh文件，加入环境变量，否则jenkins会报找不到Ant错误　　#See the license for the……
    　　JAVA_HOME=/usr/lib/jvm/jdk1.8.0_31
    　　Export JENKINS_HOME="/root/.jenkins"
    
  
  
• 将WAR文件放入tomcat安装路径/webapps/目录下
  
• 
  启动&关闭tomcat　　 ./bin/startup.sh
  　　./bin/shutdown.sh
  
• 
  Jenkins的安装目录:　　/root/.jenkins/
  

二、Jenkins配置及插件安装使用简介
　　HTML Publisher Plugin 插件在新的Jenkins版本中会导致打开的网页中无法加载CSS以及无法点击按钮的情况，由于CSP导致，可在Jenkins控制台中执行：System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")以解决此问题。其他由于CSP原因导致的html插件也可用此方法解决。

插件安装：

安装方式 　　在线安装 　　下载后安装 　　优势缺陷 　　优势：自动安装依赖 　　缺陷：安装速度慢 　　优势：速度快 　　缺陷：不会自动安装依赖

在线安装：

• 
  进入系统管理
  
  
  
• 
  进入插件管理
  
  
  
• 
  切换可选插件分页
  
  
  
• 
  选择插件，直接安装
  
  
  

• 
  若遇到可选插件为空的情况
  
  
  
  • 切换到高级界面
    
  
  
  
  
  
  • 点击立即获取按钮
    
  
  
  
  
  
  • 若报错，建议直接重新安装jenkins（查了一天解决办法，放弃了，直接重装好了）
    
  
  

离线安装：

• 
  进入插件管理，高级分页
  
  
  
• 
  上传插件
  
  
  
  
• 上传成功后会自动安装
  
• 若安装失败请去对应插件页面检查是否安装对应依赖
  

账户安全配置：
　　PS：
如果用户权限配置错误导致无法修改，修改服务器jenkins安装目录下config.xml文件，重启jenkins服务即可。

• 
  进入系统管理—Configure Global Security
  
  
  
  
• 
  选择Jenkins专用用户数据库，允许用户注册，保存
  
  
  
  
• 
  注册用户
  
  
  
  
• 再次进入Configure Global Security
  
• 
  启动安全矩阵，添加用户，添加权限，保存
  
  
  
  

三、Jenkins的环境变量说明

• 
  环境变量列表:　　-BUILD_NUMBER，唯一标识一次build，例如23；
     - BUILD_ID，基本上等同于BUILD_NUMBER，但是是字符串，例如2011-11-15_16-06-21；当前只有ID
     - JOB_NAME， job的名字，例如JavaoWorld；
     - BUILD_TAG，作用同BUILD_ID,BUILD_NUMBER,用来全局地唯一标识一此build，例如jenkins-JavaHelloWorld-23；
     - EXECUTOR_NUMBER， 例如0；
     - NODE_NAME，slave的名字，例如MyServer01；
     - NODE_LABELS，slave的label，标识slave的用处，例如JavaHelloWorldMyServer01；
     - JAVA_HOME， java的home目录，例如C:\Program Files (x86)\Java\jdk1.7.0_01；
     - WORKSPACE，job的当前工作目录，例如c:\jenkins\workspace\JavaHelloWorld；
     - HUDSON_URL = JENKINS_URL， jenkins的url，例如http://localhost:8000/；
     - BUILD_URL，build的url 例如http://localhost:8000/job/JavaHelloWorld/23/；
     - JOB_URL， job的url，例如http://localhost:8000/job/JavaHelloWorld/；
     - SVN_REVISION，svn 的revison， 例如4；
  
  
• 
  需要特殊注意的是系统管理，系统设置，高级中3个变量的引用（尤其注意重装jenkins后一定要检查是否与之前Jenkins的一致，哪怕是同一个版本甚至于同一个WAR文件）
  
  
  

四、Jenkins使用

• 
  创建项目，输入项目名称，选择项目类型
  
  
  
• 
  根据项目情况输入项目信息
  
  
  
• 
  构建
  
  
  
• 
  查看构建结果（蓝点为成功，红点为失败，Console Output选项为查看构建的log）
  
  
  

五、构建

• 
  构建触发器
  
  
  
  
  
  • 触发远程构建（脚本构建）
    
  • Build after other projects are built（在其他构建完成后构建本项目）
    
  • Build periodically（定期构建）
    
  • 
    Poll SCM（检查代码库）
    
  
  
• 
  构建脚本
  
  
  
  
  
  
  
  
  • Execute Windows batch command:添加Dos脚本构建步骤
    
  • Execute shell：添加shell构建步骤
    
  • Invoke Ant：添加Ant构建步骤
    
  • Invoke top—level Maven targets：添加Marven构建步骤
    
  
  
• 
  构建后操作
  
  
  
  
  
  • E-mail Notification 增加发送邮件配置
    
  • Publish Html report （HTML Publisher plugin插件）,增加查看Html结果配置（绝对路径，相对路径以workspace开始）
    
  
  

六、Jenkins在跨平台使用注意事项

• 路径：
  Jenkins路径格式：
  Windows服务器下也支持"/""\"并存模式，推荐使用"/"，方便跨平台使用。
  PS：看资料是可以，未尝试