一、jenkins实现持续集成部署发布
如果不采用工具的话,网站的发布更新是一个简单但麻烦的事情,在这个方面,jenkins是一个很好用的工具。Jenkins是基于Java开发的一种持续集成工具,用于监控持续重复的工作,包括持续的软件版本发布/测试项目。并可监控外部调用执行的工作。今天在本博客平台上部署好了jenkins并实现了一键更新发布。
1. 部署发布的过程
控制台输出:
Started by user KermitBuilding in workspace /dir/dir/jenkins/workspace/007CNUpdating http://svnkermit.cn/kermitsvn at revision '2016-08-02T13:51:41.677 +0800'U keframe/coreapp/KeDebug.class.phpAt revision 185[007CN] $ /bin/sh -xe /tmp/hudson4815050691085860331.sh+ fab -f deploy/fabfile.py production deploy[117.217.87.217] Executing task 'deploy'[localhost] local: tar -czf /tmp/tmpwb0BWN/04007CN.tar.gz -C /var/lib/jenkins/workspace 007CN --exclude .svn --exclude deploy --exclude uploads --exclude storage[117.217.87.217] put: /tmp/tmpwb0BWN/007CN.tar.gz -> /opt/fabric_store/007/007CN.tar.gz[117.217.87.217] sudo: tar -xzf 007CN.tar.gz; mv 04007CN tmp[117.217.87.217] sudo: rm -f 007CN.tar.gz[localhost] local: rm -rf /tmp/tmpwb0BWN[117.217.87.217] sudo: cd /dir/fabric_store/007; mv tmp 20160802-1351[117.217.87.217] sudo: cd /dir/fabric_store/007/20160802-1351/;cp -rf ./* /dirhome/dir/007.cn/;[117.217.87.217] sudo: cd /dir/fabric_store/007;./delmore.sh;Done.Disconnecting from 117.217.87.217... done.Finished: SUCCESS
之前本框架里的日志和缓存目录都放在application/目录下的cache和logs中,考虑到这些集成时不用更新,修改了框架将日志和缓存目录移动到ROOT下的storage目录里,这个是laravel框架里采用的目录架构,这样设计还是有其合理性,至少当我想使用jenkins持续集成时,我发现这很有必要。
2. Jenkins 发布的运行过程。
jenkins的集成过程也很简单。
1,从SVN地址中导出目录
2,将网站代码打包(此处去除要排除的目录及文件,比如刚才的storage缓存日志目录,以及由WEB自身更新的uploads目录等
3,将打包文件上传至目标服务器(可同时更新多个)。
4,在目标服务器上解压,并将解压后的文件夹覆盖到WEB目录中。
5,上面我增加执行了一个delmore.sh的shell脚本,功能是检查服务器上已有多少个目录(这些是每次集成解压后的目录,相当于一个历史版本的存放,可用于代码回滚),并控制最多保存3个回滚版本。
当然多服务器不建议执行shell脚本的,因为如果要使用shell脚本,就需要在每个服务器上部署好shell脚本,实际可将shell放至fabfile.py中执行。
二、Jenkins应用中的常见问题及解决办法列表
1. jenkins忘记密码了怎么办 - jenkins找回密码
一段时间没登录jenkins,可能把密码忘记了,再登录时总是提示:登录信息无效。请重试。If you are a system administrator and suspect this to be a configuration problem, see the server console output for more details.应该是密码或者账号不对了。怎么找回密码呢,只能去配置文件中修改了
首先找到jenkins的目录:-DJENKINS_HOME=/var/lib/jenkins
此目录下会有一个users文件夹,存放着各登录用户的账号信息,一个用户账户一个文件夹。文件夹里有配置文件:config.xml,内容如下:
<?xml version='1.0' encoding='UTF-8'?><user> <fullName>admin</fullName> <description>总管理员账号</description> <properties> <jenkins.security.ApiTokenProperty> <apiToken>rWArknUk9PnLS7riVJGISU/HFkjErmpNNNuiDC31aFd0SjdAh0ih3tN8GDkC94Nm</apiToken> </jenkins.security.ApiTokenProperty> <jenkins.security.LastGrantedAuthoritiesProperty> <roles> <string>authenticated</string> </roles> <timestamp>1475071638132</timestamp> </jenkins.security.LastGrantedAuthoritiesProperty> <hudson.model.MyViewsProperty> <primaryViewName></primaryViewName> <views> <hudson.model.AllView> <owner class="hudson.model.MyViewsProperty" reference="../../.."/> <name>All</name> <filterExecutors>false</filterExecutors> <filterQueue>false</filterQueue> <properties class="hudson.model.View$PropertyList"/> </hudson.model.AllView> </views> </hudson.model.MyViewsProperty> <hudson.model.PaneStatusProperties> <collapsed/> </hudson.model.PaneStatusProperties> <hudson.security.HudsonPrivateSecurityRealm_-Details> <passwordHash>#jbcrypt:$2a$10$NqPv3NpgxkpQi/ffEsEkhuMZYpbKc5cVVrP60cD6MX5IujYkLlOGm</passwordHash> </hudson.security.HudsonPrivateSecurityRealm_-Details> <org.jenkinsci.main.modules.cli.auth.ssh.UserPropertyImpl> <authorizedKeys></authorizedKeys> </org.jenkinsci.main.modules.cli.auth.ssh.UserPropertyImpl> <hudson.search.UserSearchProperty> <insensitiveSearch>false</insensitiveSearch> </hudson.search.UserSearchProperty> </properties></user>
如上面的配置文件,把passwordHash改成上面的值(对应密码是123456),账户就是这个文件夹的名称,改好后登录jenkins,在管理平台上修改密码即可。
2. jenkins 报错Password input may be echoed.的解决办法
使用jenkins做自动部署时会报错:/usr/local/python27/lib/python2.7/getpass.py:83: GetPassWarning: Can not control echo on the terminal. Password input may be echoed.之前我其它的某篇博客里也曾有写过报这个错的解决办法:当时是在脚本中对密码设置进行了修改,把以下密码设置:
env.passwords = {'123.1.101.23':'123456'}
改成下面的这种方式就解决了这个问题。写法如下:
env.passwords = {'root@123.1.101.23':'123456'}
我的阿里云上装的jenkins是2.9-1.1 版本,这个报错实际就是在执行的时候在命令行中弹出了输入密码的提示,今天在公司服务器的服务器部署时也碰到了这个问题,凭着一点印象在我的博客里搜索这个报错,找到了我以前的解决办法,然而在公司的服务器上使用时却起不到效果,可能是版本差异的问题,公司里的jenkins版本是Jenkins ver. 2.19。最后使用的方法是密码的另一种写法。
比如有多个服务器需要部署,密码采用一样的密码,使用下面这种写法:
env.hosts = ['123.11.22.11','123.11.22.12','123.11.22.13']env.password = 'abcdefg'
将密码的格式写成字符串,而不要写成一个服务器对应一个密码的格式。解决了这个问题,不过也不清楚具体导致问题的地方。做个笔记记录这个问题。
3. JENKINS报错hudson.scm.SVNRevisionState cannot be cast to hudson.scm.SVNRevisionState
最近在给一些老项目添加jenkins发布权限,碰到的一些小问题做个记录。报错FATAL: hudson.scm.SVNRevisionState cannot be cast to hudson.scm.SVNRevisionState ,详细如下:
FATAL: hudson.scm.SVNRevisionState cannot be cast to hudson.scm.SVNRevisionState java.lang.ClassCastException: hudson.scm.SVNRevisionState cannot be cast to hudson.scm.SVNRevisionState at hudson.scm.SubversionSCM.calcChangeLog(SubversionSCM.java:756) at hudson.scm.SubversionSCM.checkout(SubversionSCM.java:891) at hudson.scm.SCM.checkout(SCM.java:495) at hudson.model.AbstractProject.checkout(AbstractProject.java:1202) at hudson.model.AbstractBuildAbstractBuildExecution.defaultCheckout(AbstractBuild.java:574)atjenkins.scm.SCMCheckoutStrategy.checkout(SCMCheckoutStrategy.java:86)athudson.model.AbstractBuildAbstractBuildExecution.defaultCheckout(AbstractBuild.java:574)atjenkins.scm.SCMCheckoutStrategy.checkout(SCMCheckoutStrategy.java:86)athudson.model.AbstractBuildAbstractBuildExecution.run(AbstractBuild.java:499) at hudson.model.Run.execute(Run.java:1727) at hudson.model.FreeStyleBuild.run(FreeStyleBuild.java:43) at hudson.model.ResourceController.execute(ResourceController.java:97) at hudson.model.Executor.run(Executor.java:429) Email was triggered for: Failure - Any Sending email for trigger: Failure - Any An attempt to send an e-mail to empty list of recipients, ignored. Finished: FAILURE
解决:这个报警比较陌生,看到后到网上查了查,有说自己是Jenkins构建工程名称用了中文导致的,因为我的项目发布归类是用的中文,但JOB是中文,开始也怀疑是中文的问题,改成英文发现并不是中文的问题,后来发现是发布目标服务器的权限问题(未给发布脚本使用的账号权限导致的这个错误)。再加到JENKINS,其顶部的JOB归类使用中文是可以的。
4. jenkins异常:We trust you have received the usual lecture from the local System..
[192.221.162.70] out: We trust you have received the usual lecture from the local System[192.221.162.70] out: Administrator. It usually boils down to these three things:[192.221.162.70] out: [192.221.162.70] out: #1) Respect the privacy of others.[192.221.162.70] out: #2) Think before you type.[192.221.162.70] out: #3) With great power comes great responsibility.[192.221.162.70] out: #在停止发布之后显示的提示内容[192.221.162.70] out: [sudo] password for jenkins: Build was abortedAborted by 04007.cnFinished: ABORTED
解决:这次发布执行很久,开始还以为是网络慢,后来发现执行的时间太长有问题,中止执行后看到上面的报错password for jenkins: Build was aborted,这时才注意到上面的提示:We trust you have received the usual lecture from the local System 云云这句有点印象的话,有时在服务器上切换执行sudo时会显示上面的内容然后提示输入root用户的密码,说明当前脚本正在等着客户端输入密码,而在jenkins中无法操作所以卡住了。解决办法就是要么不加sudo执行看看。要么修改/etc/sudoers进行修改,给发布账号添加sudo权限。