搭建Gitlab+maven+jenkins持续集成环境

有什么用?

为什么需要持续集成呢？

1.因为在开发的过程中，用于阶段性地构建出产品。
这样可以更加清楚地审视产品的不足之处。
2.由于在某些情况下，例如有紧急bug的时候，研发的版本更新可能很频繁，
部署持续集成环境，可以减少每次部署所花费的时间。

化整为零：

1.这套组合可以分成源码管理、编译构建、远程部署
2.源码管理常见的有gitlab、SVN
3.编译构建是针对编译型语言的。
此处针对Java语言使用Maven、针对IOS则是使用其他编译工具。
4.远程部署由jenkins提供。

实验拓扑

主机名	主机地址	角色
node1	192.168.31.201	Gitlab-8.17.3
node2	192.168.31.202	Maven-3.3.9、Jenkins-2.49、Git-2.12.0、JDK1.8
node4	192.168.31.204	tomcat9

安装Gitlab

Gitlab的作用：作为源码管理的角色。
Gitlab实际上是整合了nginx、git等多种软件提供了一个可视化的界面。
包含git命令的基本功能，但相比于git命令更加简单易用。

1.信任 GitLab 的 GPG 公钥:

[root@bc ~]# curl https://packages.gitlab.com/gpg.key 2> /dev/null | sudo apt-key add - &>/dev/null

2.配置一个清华大学的yum源

[root@bc ~]# vim /etc/yum.repos.d/gitlab-ce.repo
  [gitlab-ce]
  name=gitlab-ce
  baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7
  repo_gpgcheck=0
  gpgcheck=0
  enabled=1
  gpgkey=https://packages.gitlab.com/gpg.key

不得不说，清华大学的源速度很快，感觉节约了好多生命。

3.安装gitlab和必要的依赖

[root@bc ~]# yum makecache
[root@bc ~]# yum install gitlab-ce
[root@bc ~]# yum install curl policycoreutils openssh-server openssh-clients
[root@bc ~]# systemctl enable sshd
[root@bc ~]# systemctl start sshd
[root@bc ~]# yum install postfix
[root@bc ~]# systemctl enable postfix
[root@bc ~]# systemctl start postfix

4.初始化gitlab

[root@bc ~]# gitlab-ctl reconfigure

5.找到应该访问的地址

[root@bc .ssh]# vim /etc/gitlab/gitlab.rb
  external_url 'http://node1.bc.com'

注意：
如果直接访问192.168.31.201，只能访问到一个空的nginx访问页面。
所以，最好能够使用域名解析来访问本地的gitlab网站。

或者修改host文件：

C:\Windows\System32\drivers\etc\hosts
  192.168.31.201 node1 node1.bc.com bc.com

正常访问页面：

使用域名访问

错误访问的页面：

直接访问ip地址会这样！

安装maven

Maven的作用：Maven负责java语言的编译和打包。
换个角度来说，Maven相当于Java中的make命令。
同类型的工具有Ant，但是Ant不提供解决依赖关系的功能

官方地址：

http://maven.apache.org/

1.获取安装包：还是清华的镜像。

[root@node2 ~]# wget http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz

2.解压tar包

[root@node2 ~]# tar apache-maven-3.3.9-bin.tar.gz -C /bin/apache-maven-3.3.9/ 
[root@node2 ~]# ln -sv /bin/apache-maven-3.3.9/ /bin/maven

3.定义变量，输出执行路径

[root@node2 ~]# vim /etc/profile.d/maven.sh
  export M2_HOME=/bin/maven
  export MAVEN_HOME=/bin/maven
  PATH=$M2_HOME/bin:$PATH
[root@node2 ~]# source /etc/profile.d/maven.sh

4.测试能否正常运行

[root@node2 ~]# mvn -v
  Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47+08:00)
  Maven home: /bin/maven
  Java version: 1.8.0_111, vendor: Oracle Corporation
  Java home: /usr/java/jdk1.8.0_111/jre
  Default locale: en_US, platform encoding: UTF-8
  OS name: "linux", version: "3.10.0-229.el7.x86_64", arch: "amd64", family: "unix"

安装jenkins

JENKINS的功能：
1.通过git命令从Gitlab中拉取源码
2.让maven进行编译并打包
3.把打好的包发送到目标主机
4.执行部署脚本。

1.获取安装包

#安装方式有多种，包括rpm、war包启动、dockerfile。此处为war包。
[root@node2 ~]# wget http://mirrors.jenkins.io/war/latest/jenkins.war

2.启动方式

#方法1：直接使用jvm启动
[root@node2 ~]# java -jar jenkins.war

#方法2：把war包放置到tomcat的应用目录并启动，让其自动解压
[root@node2 ~]# cp jenkins.war /usr/local/tomcat/webapps/
[root@node2 ~]# startup.sh

如果下载lts版提示找不到cloudbees-folder，下载weekly版的
stackOverFlow说初始化jenkins的时候提示找不到cloudbees-folder是bug

编译安装新版的git

提示：Maven、Git、JDK都是安装到jenkins服务器。
在往后的设置中，需要在jenkins中指定他们的路径。

1.获取源码包

[root@node2 ~]# wget https://www.kernel.org/pub/software/scm/git/git-2.12.0.tar.gz
`注意：为了能让jenkins能正常从gitlab中拉取源码，需要编译1.9以上的版本。`

2.git构建时，需要的环境

[root@node2 ~]# yum groupinstall "Development Tool"
[root@node2 ~]# yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker openssh-clients
`除了正常的编译环境之外，编译git的时候还要额外安装各种devel包。否则会构建失败。`

3.编译并安装，同时输出执行路径到环境变量中：

[root@node2 ~]# make prefix=/usr/local/git all 
[root@node2 ~]# make prefix=/usr/local/git install 
[root@node2 ~]# echo "export PATH=$PATH:/usr/local/git/bin" >> /etc/bashrc
[root@node2 ~]# source /etc/bashrc

4.验证能否正常运行：

[root@node2 ~]# git --version

五、在jenkins上完成配置

1.指定Maven、Git、JDK的安装路径

整合工具

指定JDK和Git路径

指定Maven路径

2.为Jenkins安装配件：

jenkins-安装插件

需要安装的插件：

Gitlab Plugin
#安装之后才可以在系统配置中指定gitlab的IP地址
Git Plugin 
Git Client Plugin 
#用于jenkins在gitlab中拉取源码
Publish Over SSH 
#用于通过ssh部署应用
Maven Integration plugin
#用于新建maven项目

注意 : 安装了插件之后，在全局配置才能详细配置。

3.为刚才安装的插件，配置选项（留意图片下的注释）

Jenkins全局设定

配置Gitlab的地址，红字表示需要Gitlab的账号密码，但是这个可以在新建项目的时候指定。

Publish_over_SSH插件，可以使用Path to key指定jenkins主机的私钥路径，也可以如上。 注意：部署应用的主机需要jenkins主机的公钥，可以ssh-copy-id命令复制过去。

配置部署应用的主机的IP地址

在jenkins上新建项目

注意：安装了Maven Integration plugin才可以创建maven项目

刚才红字提示Gitlab的账号密码在这里可以配置

这一步很重要！！！ 它包括了两个步骤： 1.发送编译好的war包到目标主机，此处为tomcat。 2.在发送war包之后，执行自己写的脚本，部署新的应用到服务器上。

上传代码到gitlab

1.配置主机SSH_KEY公钥到gitlab上

用于无密码直接把代码git push到gitlab上

2.初始化本地git目录、并添加远程仓库

[root@node2 javaCode]# git init
[root@node2 javaCode]# git remote add origin [email protected]:root/HelloWorld-public.git

3.上传代码

[root@node2 javaCode]# git add .
[root@node2 javaCode]# git commit -m "2nd Commit"
[root@node2 javaCode]# git push origin master

4.本地的目录结构

#注意pom.xml文件要放在根目录下，maven编译的时候会自动读取。
[root@node2 javaCode]# tree 
.
├── pom.xml
└── src
    ├── Greeter.java
    └── HelloWorld.java

构建项目

进入新建的项目中

注意事项：

1.进入之前创建的项目中，点立即构建可以通过maven进行编译。
2.编译结束后在工作区中，可以找到编译好的jar包。
3.左下角形如#8的链接是构建过程中的输出，可以协助排错。

查看输出的最后：

SSH: Disconnecting configuration [tomcat] ...
ERROR: Exception when publishing, exception message [Exec timed out or was interrupted after 120,002 ms]
Build step 'Send files or execute commands over SSH' changed build result to UNSTABLE
Finished: UNSTABLE

结合图例并查看输出，可以知道： 1.黄色为编译成功。 2.部署脚本出了点意外，所以是黄色不稳定。

构建成功，部署成功之后，图例是蓝色的。 云朵是用来统计构建成功和构建失败的比例。