Jenkins
1. Jenkins 简介
Jenkins是基于Java开发的一种持续集成工具，用于监控持续重复的工作，其前身叫hudson ,功能包括：
1、持续的软件版本发布/测试项目。
2、监控外部调用执行的工作。
Jenkins 发布和运行的形式都很简单，您可以去 Jenkins 官网下载安装包后，只需一个“java -jar jenkins.war”命令就能将其运行起来。官网：http://jenkins-ci.org/
Jenkins 特性
l 易于安装-只要把jenkins.war部署到servlet容器，不需要数据库支持。
l 易于配置-所有配置都是通过其提供的web界面实现。
l 集成RSS/E-mail通过RSS发布构建结果或当构建完成时通过e-mail通知。
l 生成JUnit/TestNG测试报告。
l 分布式构建支持Jenkins能够让多台计算机一起构建/测试。
l 文件识别:Jenkins能够跟踪哪次构建生成哪些jar，哪次构建使用哪个版本的jar等。
l 插件支持:支持扩展插件，你可以开发适合自己团队使用的工具。
l 易于配置-所有配置都是通过其提供的web界面实现。
l 集成RSS/E-mail通过RSS发布构建结果或当构建完成时通过e-mail通知。
l 生成JUnit/TestNG测试报告。
l 分布式构建支持Jenkins能够让多台计算机一起构建/测试。
l 文件识别:Jenkins能够跟踪哪次构建生成哪些jar，哪次构建使用哪个版本的jar等。
l 插件支持:支持扩展插件，你可以开发适合自己团队使用的工具。
Jenkins 使用步骤
平台具体的实现和配置流程，主要包含以下步骤：
安装 Jenkins 及必要的第三方插件；
建立新用户及配置权限；
为自动化测试建立和配置新任务；
配置用户输入定制化选项；
配置执行报告保存；
配置 email 提醒；
2. Jenkins 安装--window版本
step1： 首先保证系统中已经安装了jdk，最好是jdk1.5以上（适合linux和windows）。
step 2: http://jenkins-ci.org/ 下载本机环境相对应包安装。
step 2: http://jenkins-ci.org/ 下载本机环境相对应包安装。
第一种是直接在http://jenkins-ci.org/ 页面上下载jenkins for windows 的安装包. 下载好了之后安装即可.
第二种是下载jenkins的war包, 用java命令执行war包, 如java -jar jenkins.war。此时默认端口号为8080.
第二种是下载jenkins的war包, 用java命令执行war包, 如java -jar jenkins.war。此时默认端口号为8080.
如果 命令为： java -jar jenkins.war -httpPort=8082，此时使用的端口号为8082
更多启动命令：
| --httpPort=$HTTP_PORT | Runs Jenkins listener on port $HTTP_PORT using standard http protocol. The default is port 8080. To disable (because you're using https), use port -1. |
| --httpListenAddress=$HTTP_HOST | Binds Jenkins to the IP address represented by $HTTP_HOST. The default is 0.0.0.0 — i.e. listening on all available interfaces. For example, to only listen for requests from localhost, you could use: --httpListenAddress=127.0.0.1 |
| --httpsPort=$HTTP_PORT | Uses HTTPS protocol on port $HTTP_PORT |
| --httpsListenAddress=$HTTPS_HOST | Binds Jenkins to listen for HTTPS requests on the IP address represented by $HTTPS_HOST. |
| --ajp13Port=$AJP_PORT | Runs Jenkins listener on port $AJP_PORT using standard AJP13 protocol. The default is port 8009. To disable (because you're using https), use port -1. |
| --ajp13ListenAddress=$AJP_HOST | Binds Jenkins to the IP address represented by $AJP_HOST. The default is 0.0.0.0 — i.e. listening on all available interfaces. |
| --argumentsRealm.passwd.$ADMIN_USER | Sets the password for user $ADMIN_USER. If Jenkins security is turned on, you must log in as the $ADMIN_USER in order to configure Jenkins or a Jenkins project. NOTE: You must also specify that this user has an admin role. (See next argument below). |
| --argumentsRealm.roles.$ADMIN_USER=admin | Sets that $ADMIN_USER is an administrative user and can configure Jenkins if Jenkins' security is turned on. SeeSecuring Jenkins for more information. |
| -Xdebug -Xrunjdwp:transport=dt_socket,address=$DEBUG_PORT,server=y,suspend=n | Sets debugging on and you can access debug on $DEBUG_PORT. |
| - |
Logging to desired file |
| -XX:PermSize=512M -XX:MaxPermSize=2048M -Xmn128M -Xms1024M -Xmx2048M | referring to these options for Oracle Java |
step3: 在浏览器中输入 http://localhost:8080 或 http://IP:8080访问。
注： 如果在step2中修改了端口号，则输入http://localhost:端口号 访问
进入界面会发现Jenkins正在初始化，稍等片刻，可以看到主界面：
step 4: 选择菜单左边的管理JENKINS(Manage Jenkins), 找到安装windows服务(install as windows service)，之后选择安装路径，等着安装成功吧。
3. 命令行操作说明
假设Jenkins的URL为：http://localhost:8080（或http://localhost:8080/jenkins/）
基本的格式为：
java -jar jenkins-cli.jar [-s JENKINS_URL] command [options][args]
java -jar jenkins-cli.jar [-s JENKINS_URL] command [options][args]
具体实例
| 命令 | 参数说明 |
| help |
|
| build | 执行一次构建 JOB : Name of the job to build 要构建的job名称 -c : Check for SCM changes before starting the build, and if there's no change, exit without doing a build -p : Specify the build parameters in the key=value format. -r VAL : Number of times to retry reading of the output log if it does not exists on first attempt. Defaults to 0. Use with -v. -s : Wait until the completion/abortion of the command -v : Prints out the console output of the build. Use with -s -w : Wait until the start of the command --username VAL : User name to authenticate yourself to Jenkins --password VAL : Password for authentication. Note that passing a password in arguments is insecure. --password-file VAL : File that contains the password |
| login | 保存登录状态 --username VAL : User name to authenticate yourself to Jenkins --password VAL : Password for authentication. Note that passing a password in arguments is insecure. --password-file VAL : File that contains the password |
| logout | Deletes the credential stored with the login command. 注销 |
| Reads stdin and sends that out as an e-mail | |
| restart | Restart Jenkins 重启Jenkins |
| safe-restart | Safely restart Jenkins 安全重启Jenkins，即等待已有的构建完成再重启 |
| safe-shutdown | wait for existing builds to be completed, and then shut down Jenkins.安全关闭Jenkins |
| list-plugins | Outputs a list of installed plugins. 列出安装的所有插件 |
| list-jobs | 列出所有的jobs名称，其后可以接视图名称，默认显示全部 |
| install-plugin | Installs a plugin either from a file, an URL, or from update center. 安装插件 |
| get-job | Dumps the job definition XML to stdout 得到job定义的XML文档 JOB : Name of the job --username VAL : User name to authenticate yourself to Jenkins --password VAL : Password for authentication. Note that passing a password in arguments is insecure. --password-file VAL : File that contains the password |
| disable-job | Disables a job 相当于“停止构建” JOB : Name of the job --username VAL : User name to authenticate yourself to Jenkins --password VAL : Password for authentication. Note that passing a password in arguments is insecure. --password-file VAL : File that contains the password |
| delete-job | JOB : Name of the job --username VAL : User name to authenticate yourself to Jenkins --password VAL : Password for authentication. Note that passing a password in arguments is insecure. --password-file VAL : File that contains the password |
| create-job | Creates a new job by reading stdin as a configuration XML file. 从一个XML文档中创建一个job java -jar /home/jboss/.jenkins/jenkins-cli.jar -s http://localhost:8080/jenkins/ create-job testttt |
tips :
为了操作方便，建议先通过login命令保存登录状态，这样就不需要每次执行操作都加上用户名密码参数了；缺点是安全性不好，记得操作结束之后logout
linux安装配置：
4. jenkins须知
（1） Jenkins把配置文件和数据保存在$user.home/.jenkins中
5. 配置Jenkins
（1）安装插件
系统管理--管理插件--可选插件。 Jenkins的插件安装管理配置都很简单，通过web直接全能搞定。
勾选需要的插件，到页面最下面有两个按钮“Install without restart” “Download now and install after restart”，根据需要点选提交开始安装.
（2）Jenkins如何对账号管理（用户注册）
（3） 用户权限分配
点击“Assign Roles”如下图所示，在“Global roles”下“User/group to add”栏中输入添加的用户名，然后勾选管理组。记得把默认的匿名用户“Anonymous”的默认admin权限去掉，在添加管理员之后，否则不需登录就能控制整个Jenkins的权限；在“Project roles”下“User/group to add”栏中输入添加的用户名，然后勾选对应构建权限名。设置完保存即可
6. 进阶
1） 使用jenkins前疑问解答
疑问1：jenkins不用maven\ant 或者脚本等构建工具，能构建项目吗？
答：不能自动构建
你必须要有自动构建的脚本规则，告诉jenkins使用哪一种构建方案，使用什么样的构建命令和构建参数去执行等等。不然jenkins怎么知道你的项目如何构建
疑问2： eclipse 如何自动生成ant需要的build.xml文件?
选择你要生成Build.xml文件的项目,右键. Export-> General -> Ant Buildfiles .
点Next,再点Finish
点Next,再点Finish
疑问3：jenkins自动构建普通的java项目？
注：Jenkins支持两种工程：FreeStyle工程和Maven工程。如果代码是用Maven构造的，可以直接建立Maven工程
例如ant构建(注： 有了build.xml，后 ant taskname 即可我们build.xml里的task name)，项目代码在本地
step1: 安装ant，配置win7环境变量
step2: 启动jenkins
java -jar jenkens.war
http://localhost:8080/ 就可到jenkins的首页。
http://localhost:8080/ 就可到jenkins的首页。
step3:
创建job
