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

Posted 2020-12-29 SSgeek

 

1、软件及服务介绍

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，有需求的时候在搭建，这里的需求主要看开发人员的需求

 

2、环境搭建

环境说明

系统版本     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

 

3、使用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/