Jenkins发布机优化及权限控制操作手册.doc

Jenkins发布机优化及权限控制操作手册版本号：1.0刘良金二一四年七月编印关于本文档主 题发布机优化及Jenkins权限控制操作手册说明本文档用于详细阐述平台发布机优化操作，实现各系统、各环境“一键发布”的配置过程，以提高架构组工作效率的目的；Jenkins配置基于角色的项目权限，提高基于Jenkins+maven+svn版本的相对安全性。适用对象管理人员：项目总监、部门经理、项目经理、质量经理、技术经理；开发人员：程序员、测试员、文档员；发 布 员：版本发布员、Jenkins管理员；修 订 历 史版 本章 节类 型日 期作 者说 明1.01、2C2014-7-8刘良金说明：类型创建（C）、修改（U）、删除（D）、增加（A）；第一章 Jenkins简介1.1 Jenkins简介Jenkins是一个CI工具。它可以根据设定持续定期编译，运行相应代码；运行UT或集成测试；将运行结果发送至邮件，或展示成报告，这样做的最终目的是：让项目保持健康的状态。如果任何CheckIn Break了Build，每个人都会在最短的时间内通知到，然后问题被Fix。接下来的开发将建立在一个健康正确的基础上，而不是任由问题累积，最后失控。Jenkins和Cruisecontrol都是CI工具，二者在CI中发挥的作用完全一致。而Jenkins作为新一代的CI工具，渐渐开始取代Cruisecontrol。二者都是java程序，但：1. Jenkins提供更为友好的用户界面，而Cruisecontrol在界面方面糟糕的几乎等于没有。2. Jenkins内置的功能提供了极大的便利，不论是新建一个build，还是日常使用，你需要做的大部分时候仅仅是在用户界面上点击而已。在Cruisecontrol新建build是通过创建config.xml来完成的。它仅仅提供非常有限的功能，很多时候你会发现，需要自己完成很多工作。3. Jenkins作为一个欣欣向荣的开源项目，有大批的Plugin。当你发现需要一个Jenkins本身并不提供的功能是，搜索一下Plugin，总会有收获。非常多的流行工具如JBehave，Cobertura都提供Jenkins插件。而针对Cruisecontrol的Plugin却很少。4. Jenkins友好的用户界面让学习成本很少，可以在最短的时间内开始工作。1.2 Jenkins管理员帐号Jenkins已经集成安装在0.221服务器上，访问地址如下：21:8083/jenkins/目前维护的帐号有：序号用户名密码备注1admin管理员2admin管理员3prod管理员4zhangsan生产(prod)环境发布帐号5zhangsan生产(prod)环境发布帐号6lishitest和stage发布帐号需要Jenkins帐号的可以邮件系统组开通。第二章 Jenkins Job管理2.1 Jenkins欢迎页面用admin管理员帐号登录系统后，首页显示如下：首页显示分为三个功能模块区：1 功能权限菜单；2 任务状态；3 Job列表；2.2 创建Job Build点击左上角“新Job”，出现界面如下：填写任务名称，例如“test_build”，选中“构建一个maven2/3项目”，点击“ok”，出现界面如下：选择jdk配置、源码管理选择“Subversion”，填写SVN Repository URL，例如：svn:/79/zt-ecommercial/projects/branch/EC-TEST，“EC-TEST”表示EC工程分支，这里根据实际情况修改，在Build “ROOT POM”填写pom.xml文件路径“prj/pom.xml”（相对于svn地址库中的位置），“Goals and options”填写为“clean install”表示项目构件，填写完毕后点击“保存”保存Job。说明：填写完svn路径后需要输入用户名密码 使用mpsvn.mp该账号；2.3 执行Job Build在Job列表中点击立即构建执行Build，如下图如示：点击Job“Name”查看Job基本信息，如下图所示：点击Build History可以查看Build Log。2.4 创建Job Deploy点击左上角“新Job”，选中“构建一个自由风格的软件项目”，点击“ok”，选择jdk配置、源码管理选择“None”，在构件中选择“Execute shell”，在Command中填写Shell脚本例如：ssh ztds2 bash -x -s /dev/null 2&1 & #启动Tomcat并退出说明：1. 脚本中的端口和路径根据实际环境修改；2. 发布服务器(221)用户(cyl)和远程服务器用户(ztds)必须建立双向ssh 免密码登录服务，此步骤系统组协助完成；3. testDeploy.sh脚本文件上传到发布服务器(221) /home/cyl/路径下；4. testDeploy.sh上传后，执行 dos2unix testDeploy.sh转码；第三章 用户权限控制3.1 Jenkins角色管理由于Jenkins默认的权限管理体系不支持用户组或角色的配置，因此需要安装第三发插件来支持角色的配置，本文将使用Role Strategy Plugin。用管理员帐号登录Jenkins，“系统管理” - “Manage and Assign Roles”页面：点击Manage Roles，进入角色管理页面：可以创建全局角色、项目角色，并可以为角色分配权限。如上图，分别创建了admin、jobRead两个全局角色，EC-prod、EC-stage、EC-test三个项目角色。项目角色与全局角色的区别就是，项目角色只能管理项目，不能管理Jenkins的权限配置。添加项目角色时，需要制定匹配项目的模式，如上图中的Pattern，官方文档介绍该选项支持正则表达式，如“prod.”表示所有以prod开头的项目，“(?i)prod.*”表示以prod开头的项目并且不区分大小写，如以ABC开头的项目可以配置为“prod|prod.*”，也可以使用“test|stage|prod”直接匹配多个项目。3.2创建用户在分配角色之前需要先创建用户。在系统管理页面点击“管理用户”进入管理用户页面：点击新建使用者可以创建新用户，如果之前有项目与scm版本管理系统（如svn、git等）连接并获取源码构建过，Jenkins会从svn中读取到一些用户信息，可以在查看用户菜单中看到下图的这些用户：点击用户id或名称都可以修改用户信息。3.3分配角色（Assign Roles）在Manage and Assign Roles页面选择Assign Roles可以为用户分配所属角色，可以分配全局角色和项目角色：如上图，将不同的用户分别分配给不同的角色，这样用户就可以具有角色所拥有的权限。第四章 深入了解该插件从2011年10月发布1.1.2版本后就不再维护了，因此会有一些小问题，但不影响使用，比如在分配角色后点击保存按钮时有可能会发生异常，浏览器点击后退按钮后重新提交就可以操作成功。另外如果配置失败导致不能登录，可以通过修改配置文件恢复初始设置。首先了解一下配置文件。进入Jenkins安装目录，用户配置信息和角色配置信息都以配置文件的形式存储。上图中users目录存放了各个用户的配置信息，每个用户都会创建与用户名相同的文件夹，文件夹中包含config.xml文件。如果发生用户不能登录的情况，可以尝试以下几种方法解决：1、方法1l 删除用户相关的目录；l 修改$Jenkins_home/config.xml文件：false；l 删除authorizationStrategy、securityRealm节点；l 重新启动Jenkins；l 使用该方法将删除Jenkin