jenkins 使用记录

2016-11-18 Frank

[TOC]

jenkins 持续集成工具。本文在开发环境测试，应用应该部署在测试和生产环境。

1. 安装

准备环境：jdk1.8 、tomcat8.0
下载并安装
从官网下载之后，放到Tomcat的webapps目录，启动Tomcat，访问http://localhost:8080/jenkins ，按照提示进行安装，选择推荐插件。有些插件安装会失败。
通过插件网站下载相应插件hpi文件。浏览器下载会下载不完整，所以建议复制地址到迅雷下载。
下载的插件，在插件管理的高级里上传进行安装。
另一种启动方式：
```
java -jar jenkins.war --httpPort=8000
```
Centos安装
```
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
yum install jenkins
```
启动
```
sudo systemctl start jenkins.service
```
解决：
Starting Jenkins bash: /usr/bin/java: No such file or directory
Failed to start LSB: Jenkins Automation Server.
```
sudo ln -s /usr/local/java/jdk1.7.0_80/bin/java /usr/bin/java
```
修改端口
```
vim /etc/sysconfig/jenkins
JENKINS_PORT="8085"
```
日志查看
```
tail -f /var/log/jenkins/jenkins.log
```
查看初始密码
```
more /var/lib/jenkins/secrets/initialAdminPassword
```
How to Install Jenkins on CentOS 7

2. 构建

源码管理：
配置GIT 地址和Credentials（证书）
构建触发器：
勾选Poll SCM，并填入日程表
H/10 //每十分钟触发构建

保存。
立即构建，等待。。

3. jenkins构建时支持git选择分支

安装Git Parameter Plugin
为了避免浪费时间，一定要下载安装包进行安装。
插件安装成功后，在项目配置中后看到多了一个“参数化构建过程”
勾选“参数化构建过程”，然后添加Git Parameter,配置如下
name: BRANCH
Default Value: origin/testing
在源码管理中添加如下：
Branches to build: $BRANCH
原本的“立刻构建”变成了“Build with Parameters”

4. jenkins的构建触发中Poll SCM和Build periodically的区别

Poll SCM：定时检查源码变更（根据SCM软件的版本号），如果有更新就checkout最新code下来，然后执行构建动作。
Build periodically：周期进行项目构建（它不care源码是否发生变化）。

5. 在jenkins中配置令牌远程触发项目构建

1 . 在用户的【设置】页面的【API Token】部分可以获取用户的令牌

2 . 在项目配置页面的【构建触发器】部分勾选【触发远程构建】，在身份验证令牌中输入可构建者的令牌

3 . 通过发送触发url到jenkins服务器即可远程触发该项目的构建，如：http://127.0.0.1:8180/jenkins/job/testCI/build?token=967ae5423f43915463d7436bb13d7e54

curl —user admin:1234 -s http://localhost:8080/jenkins/job/liuwan/build?token=c1e9e2489611a6987142ccad72b53be7

6. Jenkinsapi 远程启动jenkins参数化构建(parameterized build)

#!/use/bin/python
'''
http://pythonhosted.org/jenkinsapi/
https://github.com/pycontribs/jenkinsapi/tree/master/examples

http://python-jenkins.readthedocs.io/en/latest/

curl --user admin:1234 -s http://localhost:8080/jenkins/job/liuwan/buildWithParameters?token=c1e9e2489611a6987142ccad72b53be7

'''
from jenkinsapi.jenkins import *
from jenkinsapi.build import *
from jenkinsapi.job import *

jenkins_url = 'http://localhost:8080/jenkins'
jenkins_user = 'admin'
jenkins_password = '1234'
job_name = 'liuwan'
jenkins = Jenkins(jenkins_url,jenkins_user,jenkins_password)
job_url = jenkins_url+'/job/'+job_name
print job_url


my_job = jenkins.get_job(job_name)
previous_build_number = my_job.get_last_buildnumber()
current_build_number = previous_build_number+1
print 'Previous build number is {0}'.format(previous_build_number)
print 'Current build number is {0}'.format(previous_build_number)
My_Build_Drop_Location = r"origin/testing"
Buid_Parameters = {"Build_Drop_Location":My_Build_Drop_Location}
# my_job.invoke("None",False,False,3,15,Buid_Parameters)
# my_job.invoke("c1e9e2489611a6987142ccad72b53be7",False,Buid_Parameters,None,None,5)
my_job.invoke(None,False,Buid_Parameters,None,None,5)
# my_job.enable()
# my_job.disable()

last_build = my_job.get_last_build()
print last_build
print my_job.get_last_buildnumber()
print 'Build Status is {0}'.format(last_build.get_status())

执行远程构建

python build.py

报错：
No valid crumb was included in the request
解决：

安全配置里面（/jenkins/configureSecurity/）反选防止跨站点请求伪造

7. 配置构建后发送邮件

系统管理->系统设置->邮件通知里设置smtp地址，在高级里设置端口、用户名、密码，然后选择通过发送测试邮件测试配置。如果失败请确保上面的“系统管理员邮件地址”填写用户名一样的地址再重新测试。

8 .其他构建相关

切换jenkins用户生成密钥

su jenkins -s /bin/bash
ssh-keygen -t rsa

修改数据库配置文件

sed -i 's#<property name=\"username\" value=\".*\"/>#<property name=\"username\" value=\"user\"/>#g' src/main/resources/applicationContex.xml

sed -i 's#<property name=\"password\" value=\".*\"/>#<property name=\"password\" value=\"pass\"/>#g' src/main/resources/applicationContext.xml

修改项目目录所有者为jenkins

chown -R jenkins:jenkins /workspace/project

拷贝项目文件到指定目录

cp -rf build/classes/main/ /workspace/project/src/main/webapp/WEB-INF/classes/

让jenkins用户能用sudo执行脚本

$visudo

jenkins   ALL=NOPASSWD: /opt/apache-tomcat-8.5.15/bin/restart.sh

$ vim restart.sh

#!/bin/sh
bin=$(cd `dirname $0`; pwd)
pid=$(ps aux | grep tomcat | grep -v grep | grep -v restart | grep ${bin} | awk '{print $2}') 

if [ -n "${pid}" ]; then
  echo "Shutdown..."
  sh ${bin}/shutdown.sh
  sleep 3

  pid=$(ps aux | grep tomcat | grep -v grep | grep -v restart | grep ${bin} | awk '{print $2}')
  if [ -n "${pid}" ]; then
    kill -9 ${pid}
    sleep 1
  fi
fi

echo "Startup..."
sh ${bin}/startup.sh
if [ "$1" = "-v" ]; then
  tail -f ${bin}/../logs/catalina.out
fi

触发构建

hook方式没成功，暂时用poll scm

同步文件

#!/bin/bash
SOURCE_DIR=/var/lib/jenkins/workspace/${JOB_NAME}
DEST_DIR=/opt/www/xxx
REMOTE_IP=192.168.60.61
/usr/bin/rsync -e "ssh -p2222" -avpgolr --delete-before $SOURCE_DIR $REMOTE_IP:$DEST_DIR

解决jenkins内存溢出的问题

同样修改jenkins的配置文件，修改JAVA_OPTIONS参数
vim /etc/sysconfig/jenkins
找到JENKINS_JAVA_OPTIONS=”-Djava.awt.headless=true”
修改成
JENKINS_JAVA_OPTIONS=”-Djava.awt.headless=true -Xms256m -Xmx512m -XX:MaxNewSize=256m -XX:MaxPermSize=256m”

参考：
jenkins构建时支持git选择分支
 jenkins的构建触发中Poll SCM和Build periodically的区别
 在jenkins中配置令牌远程触发项目构建
 How to configure Git post commit hook
Jenkinsapi 远程启动jenkins参数化构建(parameterized build)

[TOC]

jenkins 持续集成工具。本文在开发环境测试，应用应该部署在测试和生产环境。
## 1. 安装
- 准备环境：jdk1.8 、tomcat8.0
- 下载并安装
从[官网](https://jenkins.io/)下载之后，放到Tomcat的webapps目录，启动Tomcat，访问http://localhost:8080/jenkins ，按照提示进行安装，选择推荐插件。有些插件安装会失败。
通过[插件网站](https://updates.jenkins-ci.org/download/plugins/) 下载相应插件hpi文件。浏览器下载会下载不完整，所以建议复制地址到迅雷下载。
下载的插件，在插件管理的高级里上传进行安装。
另一种启动方式：
```
 java -jar jenkins.war --httpPort=8000
```
Centos安装
```
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
yum install jenkins
```
启动
```
sudo systemctl start jenkins.service
```
解决：
Starting Jenkins bash: /usr/bin/java: No such file or directory
Failed to start LSB: Jenkins Automation Server.
```
sudo ln -s /usr/local/java/jdk1.7.0_80/bin/java /usr/bin/java
```
修改端口
```
vim /etc/sysconfig/jenkins
JENKINS_PORT="8085"
```
日志查看
```
tail -f /var/log/jenkins/jenkins.log
```
查看初始密码
```
more /var/lib/jenkins/secrets/initialAdminPassword
```
[How to Install Jenkins on CentOS 7](https://www.vultr.com/docs/how-to-install-jenkins-on-centos-7)

## 2. 构建
- 源码管理：
配置GIT 地址和Credentials（证书）
- 构建触发器：
勾选Poll SCM，并填入日程表
H/10 * * * * //每十分钟触发构建

保存。
立即构建，等待。。

## 3. jenkins构建时支持git选择分支
- 安装[Git Parameter Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Git+Parameter+Plugin) 
为了避免浪费时间，一定要下载安装包进行安装。

- 插件安装成功后，在项目配置中后看到多了一个“参数化构建过程”
   勾选“参数化构建过程”，然后添加Git Parameter,配置如下
   name: BRANCH
   Default Value: origin/testing
  ![](http://img.blog.csdn.net/20160728155445925?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
- 在源码管理中添加如下：
	Branches to build: $BRANCH
![](http://img.blog.csdn.net/20160728155501082?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
- 原本的“立刻构建”变成了“Build with Parameters”
![](http://img.blog.csdn.net/20160728155548708?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQv/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)

## 4. jenkins的构建触发中Poll SCM和Build periodically的区别
- Poll SCM：定时检查源码变更（根据SCM软件的版本号），如果有更新就checkout最新code下来，然后执行构建动作。

- Build periodically：周期进行项目构建（它不care源码是否发生变化）。

## 5. 在jenkins中配置令牌远程触发项目构建

1 . 在用户的【设置】页面的【API Token】部分可以获取用户的令牌

2 . 在项目配置页面的【构建触发器】部分勾选【触发远程构建】，在身份验证令牌中输入可构建者的令牌

3 . 通过发送触发url到jenkins服务器即可远程触发该项目的构建，如：http://127.0.0.1:8180/jenkins/job/testCI/build?token=967ae5423f43915463d7436bb13d7e54

curl --user admin:1234 -s http://localhost:8080/jenkins/job/liuwan/build?token=c1e9e2489611a6987142ccad72b53be7
## 6. Jenkinsapi 远程启动jenkins参数化构建(parameterized build)
```python
#!/use/bin/python
'''
http://pythonhosted.org/jenkinsapi/
https://github.com/pycontribs/jenkinsapi/tree/master/examples

http://python-jenkins.readthedocs.io/en/latest/

curl --user admin:1234 -s http://localhost:8080/jenkins/job/liuwan/buildWithParameters?token=c1e9e2489611a6987142ccad72b53be7

'''
from jenkinsapi.jenkins import *
from jenkinsapi.build import *
from jenkinsapi.job import *

jenkins_url = 'http://localhost:8080/jenkins'
jenkins_user = 'admin'
jenkins_password = '1234'
job_name = 'liuwan'
jenkins = Jenkins(jenkins_url,jenkins_user,jenkins_password)
job_url = jenkins_url+'/job/'+job_name
print job_url

my_job = jenkins.get_job(job_name)
previous_build_number = my_job.get_last_buildnumber()
current_build_number = previous_build_number+1
print 'Previous build number is {0}'.format(previous_build_number)
print 'Current build number is {0}'.format(previous_build_number)
My_Build_Drop_Location = r"origin/testing"
Buid_Parameters = {"Build_Drop_Location":My_Build_Drop_Location}
# my_job.invoke("None",False,False,3,15,Buid_Parameters)
# my_job.invoke("c1e9e2489611a6987142ccad72b53be7",False,Buid_Parameters,None,None,5)
my_job.invoke(None,False,Buid_Parameters,None,None,5)
# my_job.enable()
# my_job.disable()

last_build = my_job.get_last_build()
print last_build
print my_job.get_last_buildnumber()
print 'Build Status is {0}'.format(last_build.get_status())
```
执行远程构建
```
python build.py
```
报错：
No valid crumb was included in the request
解决：

安全配置里面（/jenkins/configureSecurity/）反选 防止跨站点请求伪造

## 7. 配置构建后发送邮件
系统管理->系统设置->邮件通知 里设置smtp地址，在高级里设置端口、用户名、密码，然后选择通过发送测试邮件测试配置。如果失败请确保上面的“系统管理员邮件地址”填写用户名一样的地址再重新测试。

## 8 .其他构建相关
### 切换jenkins用户生成密钥
```
su jenkins -s /bin/bash
ssh-keygen -t rsa
```
### 修改数据库配置文件
```
sed -i 's#<property name=\"username\" value=\".*\"/>#<property name=\"username\" value=\"user\"/>#g' src/main/resources/applicationContex.xml

sed -i 's#<property name=\"password\" value=\".*\"/>#<property name=\"password\" value=\"pass\"/>#g' src/main/resources/applicationContext.xml
```

### 修改项目目录所有者为jenkins
```
chown -R jenkins:jenkins /workspace/project
```
### 拷贝项目文件到指定目录
```
cp -rf build/classes/main/ /workspace/project/src/main/webapp/WEB-INF/classes/
```

###让jenkins用户能用sudo执行脚本
$visudo
```
jenkins   ALL=NOPASSWD: /opt/apache-tomcat-8.5.15/bin/restart.sh
```
$ vim restart.sh
```
#!/bin/sh
bin=$(cd `dirname $0`; pwd)
pid=$(ps aux | grep tomcat | grep -v grep | grep -v restart | grep ${bin} | awk '{print $2}')

if [ -n "${pid}" ]; then
  echo "Shutdown..."
  sh ${bin}/shutdown.sh
  sleep 3

pid=$(ps aux | grep tomcat | grep -v grep | grep -v restart | grep ${bin} | awk '{print $2}')
  if [ -n "${pid}" ]; then
    kill -9 ${pid}
    sleep 1
  fi
fi

echo "Startup..."
sh ${bin}/startup.sh
if [ "$1" = "-v" ]; then
  tail -f ${bin}/../logs/catalina.out
fi
```

### 触发构建
hook方式没成功，暂时用poll scm

### 同步文件
```
#!/bin/bash
SOURCE_DIR=/var/lib/jenkins/workspace/${JOB_NAME}
DEST_DIR=/opt/www/xxx
REMOTE_IP=192.168.60.61
/usr/bin/rsync -e "ssh -p2222" -avpgolr --delete-before $SOURCE_DIR $REMOTE_IP:$DEST_DIR
```

###解决jenkins内存溢出的问题

同样修改jenkins的配置文件，修改JAVA_OPTIONS参数
vim /etc/sysconfig/jenkins
找到JENKINS_JAVA_OPTIONS="-Djava.awt.headless=true"
修改成
JENKINS_JAVA_OPTIONS="-Djava.awt.headless=true -Xms256m -Xmx512m -XX:MaxNewSize=256m -XX:MaxPermSize=256m"

> 参考：
[jenkins构建时支持git选择分支](http://blog.csdn.net/u012076316/article/details/52056107)
[jenkins的构建触发中Poll SCM和Build periodically的区别](http://blog.csdn.net/babys/article/details/8921314)
[在jenkins中配置令牌远程触发项目构建](http://blog.csdn.net/stigmergy/article/details/36643233)
[How to configure Git post commit hook](http://stackoverflow.com/questions/12794568/how-to-configure-git-post-commit-hook)
[Jenkinsapi 远程启动jenkins参数化构建(parameterized build)](http://www.scmroad.com/thread-25849-1-1.html)

« 上一篇：北京大兴区学校体育设施免费对外开放具体时间及形式查询 | 下一篇：Dockerfile创建自定义Docker镜像以及CMD与ENTRYPOINT指令的比较»

发表评论登录：