Jenkins+Maven+Gitlab+Nexus持续集成环境搭建

 

一、软件及服务介绍

Jenkins：jenkins是实现代码自动化流程上线的工具，Jenkins是一个独立的开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工做，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。前身是Hudson是一个可扩展的持续集成引擎。可用于自动化各类任务，如构建，测试和部署软件。Jenkins能够经过本机系统包Docker安装，甚至能够经过安装Java Runtime Environment的任何机器独立运行

Maven：Maven是一个项目管理和综合工具。Maven提供了开发人员构建一个完整的生命周期框架。开发团队能够自动完成项目的基础工具建设，Maven使用标准的目录结构和默认构建生命周期。在多个开发团队环境时，Maven能够设置按标准在很是短的时间里完成配置工做。因为大部分项目的设置都很简单，而且可重复使用，Maven让开发人员的工做更轻松，同时建立报表，检查，构建和测试自动化设置。

Gitlab：GitLab 是一个用于仓库管理系统的开源项目，使用Git做为代码管理工具，并在此基础上搭建起来的web服务。可经过Web界面进行访问公开的或者私人项目。它拥有与Github相似的功能，可以浏览源代码，管理缺陷和注释。能够管理团队对仓库的访问，它很是易于浏览提交过的版本并提供一个文件历史库。团队成员能够利用内置的简单聊天程序(Wall)进行交流。它还提供一个代码片断收集功能能够轻松实现代码复用。

Nexus：maven的仓库只有两大类：1.本地仓库 2.远程仓库，在远程仓库中又分红了3种：中央仓库、私服、其它公共库。

私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。当Maven须要下载构件的时候，它从私服请求，若是私服上不存在该构件，则从外部的远程仓库下载，缓存在私服上以后，再为Maven的下载请求提供服务。咱们还能够把一些没法从外部仓库下载到的构件上传到私服上

私服的特色：

节省本身的外网带宽：减小重复请求形成的外网带宽消耗

加速Maven构件：若是项目配置了不少外部远程仓库的时候，构建速度就会大大下降

部署第三方构件：有些构件没法从外部仓库得到的时候，咱们能够把这些构件部署到内部仓库(私服)中，供内部maven项目使用

提升稳定性，加强控制：Internet不稳定的时候，maven构建也会变的不稳定，一些私服软件还提供了其余的功能

下降中央仓库的负荷：maven中央仓库被请求的数量是巨大的，配置私服也能够大大下降中央仓库的压力

所以在实际的项目中一般使用私服来间接访问中央仓库，项目一般不直接访问中央仓库

Nexus并非必须的，本次部署使用maven中央仓库，不演示nexus，有需求的时候在搭建，这里的需求主要看开发人员的需求

 

二、环境搭建

环境说明

系统版本     CentOS 7.2 x86_64

软件版本     jdk-8u171-linux-x64

            apache-tomcat-8.0.52

            apache-maven-3.5.4

            jenkins-2.129

            Gitlab-ce-10.8.4（部署在其余机器）

jdk下载地址：http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

tomcat下载地址：https://tomcat.apache.org/download-80.cgi

maven下载地址：http://maven.apache.org/download.cgi

jenkins下载地址：http://mirrors.jenkins-ci.org/war/2.129/

https://mirrors.tuna.tsinghua.edu.cn/jenkins/war/2.129/（清华镜像源）

gitlab的安装部署见前面的博文：

全部软件的安装包在部署前均下载到了本地

[root@jenkins ~]# mkdir /application

[root@jenkins ~]# mkdir -p /service/tools

[root@jenkins ~]# cd /service/tools        

上传所需软件包

[root@jenkins tools]# ls

apache-maven-3.5.4-bin.tar.gz apache-tomcat-8.0.52.tar.gz jdk-8u171-linux-x64.tar.gz jenkins.war

2.1 安装jdk

[root@jenkins tools]# tar xf jdk-8u171-linux-x64.tar.gz -C /application/

[root@jenkins tools]# ln -s /application/jdk1.8.0_171 /application/jdk

[root@jenkins tools]# vim /etc/profile

export JAVA_HOME=/application/jdk

export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

export PATH=$JAVA_HOME/bin:$PATH

[root@jenkins tools]# source /etc/profile

[root@jenkins tools]# java -version

java version "1.8.0_171"

Java(TM) SE Runtime Environment (build 1.8.0_171-b11)

Java HotSpot(TM) 64-Bit Server VM (build 25.171-b11, mixed mode)

2.2 安装tomcat

[root@jenkins tools]# tar xf apache-tomcat-8.0.52.tar.gz -C /application/

[root@jenkins tools]# ln -s /application/apache-tomcat-8.0.52 /application/tomcat

[root@jenkins tools]# ll /application/

总用量 4

drwxr-xr-x 9 root root 149 6月 28 21:03 apache-tomcat-8.0.52

lrwxrwxrwx 1 root root 25 6月 28 20:57 jdk -> /application/jdk1.8.0_171

drwxr-xr-x 8 10 143 4096 3月 29 08:18 jdk1.8.0_171

lrwxrwxrwx 1 root root 33 6月 28 21:03 tomcat -> /application/apache-tomcat-8.0.52

2.3 安装jenkins

Jenkins的安装分为两种方式：rpm包安装和war包安装，war包依赖于tomcat

[root@jenkins tools]# mv jenkins.war /application/tomcat/webapps/

[root@jenkins tools]# ls /application/tomcat/webapps/

docs examples host-manager jenkins.war manager ROOT

[root@jenkins tools]# /application/tomcat/bin/startup.sh

[root@jenkins tools]# netstat -lntup|grep java

tcp6 0 0 :::8009 :::* LISTEN 2356/java

tcp6 0 0 :::8080 :::* LISTEN 2356/java

tcp6 0 0 127.0.0.1:8005 :::* LISTEN 2356/java

udp6 0 0 :::5353 :::* 2356/java

udp6 0 0 :::33848 :::* 2356/java

[root@jenkins tools]# ls /application/tomcat/webapps/        #启动完成后jenkins的war包被解压为jenkins文件

docs examples host-manager jenkins jenkins.war manager ROOT

浏览器http://10.0.0.8:8080/jenkins访问web界面继续安装

根据提示在日志或者/root/.jenkins/secrets/initialAdminPassword文件中找到密码输入解锁jenkins

若是出现如下错误提示，多数状况是因为网络缘由，能够尝试修改jenkins配置文件

[root@jenkins tools]# vim ~/.jenkins/hudson.model.UpdateCenter.xml

将url地址https://updates.jenkins.io/update-center.json修改成清华镜像源的地址

https://mirror.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，修改后重启tomcat并刷新浏览器

[root@jenkins tools]# /application/tomcat/bin/shutdown.sh

[root@jenkins tools]# /application/tomcat/bin/startup.sh

点击安装推荐的插件，等待插件安装完成，若是插件安装失败，不断尝试点击重试直到全部插件安装完成，这种状况缘由在于网络问题，若是这里的插件安装不成功选择跳过，在后续步骤中会遇到麻烦，须要手动去选择插件安装

插件安装完成设置管理员的帐号密码等信息

登陆jenkins，jenkins安装完成

2.4 安装maven

[root@jenkins tools]# tar xf apache-maven-3.5.4-bin.tar.gz -C /application/

[root@jenkins tools]# ln -s /application/apache-maven-3.5.4 /application/maven

[root@jenkins tools]# vim /etc/profile

export MAVEN_HOME=/application/maven

export PATH=${MAVEN_HOME}/bin:${PATH}

[root@jenkins tools]# source /etc/profile

[root@jenkins tools]# which mvn

/application/maven/bin/mvn

[root@jenkins tools]# mvn -version

Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-18T02:33:14+08:00)

Maven home: /application/maven

Java version: 1.8.0_171, vendor: Oracle Corporation, runtime: /application/jdk1.8.0_171/jre

Default locale: zh_CN, platform encoding: UTF-8

OS name: "linux", version: "3.10.0-327.el7.x86_64", arch: "amd64", family: "unix"

若是使用自建的私服，修改/application/maven/conf/settings.xml配置文件添加mirrors的地址，如添加阿里云的maven仓库地址，这样在后面maven编译的时候就能提升速度

[root@jenkins tools]# vim /application/maven/conf/settings.xml

<mirror>

<id>nexus-aliyun</id>

<mirrorOf>*</mirrorOf>

<name>Nexus aliyun</name>

<url>http://maven.aliyun.com/nexus/content/groups/public</url>

</mirror>

2.5 jenkins配置

系统管理——>管理插件——>可选插件——>过滤

搜索maven插件Maven Integration plugin并等待成功安装，不能安装请重试，或者手动下载插件上传安装

配置jenkins全局工具配置

系统管理——>全局工具配置，配置jdk和maven，配置为本身安装的jdk和maven

 

三、使用jenkins构建项目

演示以最简单的方式构建一个项目

例如从自建的gitlab上构建一个jeesns的项目，新建任务

输入项目描述，设置构建参数

源码管理选择git，须要填写url及选择密钥

Repository URL填写自建的gitlab上的项目地址即：

填写以后以下所示，出现这个提示是因为jenkins所在机器没有与gitlab服务器认证，须要生成密钥并将公钥添加至gitlab上，生成密钥和gitlab上添加密钥能够参照前面部署gitlab的文章

Credentials选项中点击add或者直接在主面板中找到凭据管理并添加凭据，将上面生成的私钥粘贴到这里

回到项目参数配置源码管理界面，下拉选择相应的key，选择源码库浏览器为gitlab并填写http地址（gitlab上找到该地址）及项目名称

对于此项目，整个项目构建并自动上线的步骤为：拉取gitlab上面的java项目代码——>改配置文件——>导入数据库——>使用maven插件编译java项目——> 执行脚本（推送新编译好的war包文件到tomcat服务器，这里使用jenkins本机服务器）

上述步骤要根据具体项目的实现构建步骤而定，固然很大一部分也是开发人员所决定的，对于这个项目的部署步骤能够参考官方项目地址https://gitee.com/zchuanzhao/jeesns

 

所以，须要选择并输入在项目构建以前须要执行的脚本（命令），该项目要实现自动上线还须要作的是修改项目的配置文件中的数据库用户名及密码，导入数据库文件（导入前须要创库受权），脚本中的路径须要在jenkins相应路径中找到得出

sed -i 's#jdbc.user=root#jdbc.user=jeesns#g' /root/.jenkins/workspace/jeesns/jeesns-web/src/main/resources/jeesns.properties

sed -i 's#jdbc.password=root#jdbc.password=123456#g' /root/.jenkins/workspace/jeesns/jeesns-web/src/main/resources/jeesns.properties

/usr/bin/mysql -ujeesns -p123456 jeesns </root/.jenkins/workspace/jeesns/jeesns-web/database/jeesns.sql

填写项目构建参数（与开发人员有关），基础参数为clean package

填写项目构建以后的脚本（命令）

cp /root/.jenkins/workspace/jeesns/jeesns-web/target/jeesns-web.war /application/tomcat/webapps

上述步骤及参数为jekins自动编译并上线一个项目的基础配置，根据项目环境须要能够进行进一步配置，如今要作的就是点击保存，并当即构建项目

查看控制台输出，等待构建完成

构建完成后便可访问网站，项目自动上线

更多jekins的知识能够参考https://www.w3cschool.cn/jenkins/