使用Docker安装部署Jenkins

本文主要记录如何通过docker安装jenkins，并且通过jenkins部署项目

前置准备：jenkins所在宿主服务器首先安装好jdk、maven

一、配置JDK环境

注意：选择适合自己的JDK，并且注意安装JDK的系统

地址:https://www.oracle.com/java/technologies/downloads/#java8

1、卸载linux系统自带的JDK（建议直接用超级用户，不然卸载的时候可能会报权限不够的error，之后的操作也需要用root权限）

**1.1、切换用户：

su root

**

su root

**1.2、查看自带JDK命令：

rpm -qa | grep jdk

**

rpm-qa|grep jdk

**1.3、卸载自带JDK命令：

rpm -e --nodeps 要卸载的JDK

**

rpm-e--nodeps 要卸载的JDK

2、在usr/local目录下创建java目录，把我们下载好的JDK压缩包上传到 创建好的 java目录下（我放在该目录下了，也可以放在其他目录下）

**创建安装目录：

mkdir java

**

cd /usr/local
mkdir java
cd java

**3、把压缩包解压到当前目录（我们创建的java目录下），解压命令：

tar -zxvf 所要解压的文件名

**

tar -zxvf 所要解压的文件名

**4、编辑profile文件：

vim /etc/profile

**
把光标移到最后一行，键盘按 i，进入编辑模式，然后插入以下内容：（注意自己所建java的路径、jdk的名称）

JAVA_HOME=/usr/local/java/jdk1.8.0_381
CLASSPATH=$JAVA_HOME/lib/
PATH=$PATH:$JAVA_HOME/bin
export PATH JAVA_HOME CLASSPATH

然后按ESC退出编辑模式，‘shift + ：’，输入wq，回车，完成保存并退出

**5、让编辑的文件生效执行：

source /etc/profile

**

**6、最后验证JDK安装是否成功：

java -version

**

[root@aliyun ~]# cd /usr/local/java[root@aliyun java]# ls
jdk-8u381-linux-x64.tar.gz
[root@aliyun java]# tar -zxvf jdk-8u381-linux-x64.tar.gz[root@aliyun java]# vim /etc/profile[root@aliyun java]# source /etc/profile[root@aliyun java]# java -versionjava version "1.8.0_381"
Java(TM) SE Runtime Environment (build 1.8.0_381-b09)
Java HotSpot(TM)64-Bit Server VM (build 25.381-b09, mixed mode)

出现上述显示，则完毕！

二、配置Maven环境

1、准备Maven安装包

打开Maven官网：Maven – Download Apache Maven

我选择是3.9.3版本（选择适合自己的版本），找到后缀名是.tar.gz的文件下载，如图所示：

**1.1、创建安装目录：

mkdir maven

**

cd /usr/local
mkdir maven
cd maven

**1.2、把压缩包解压到当前目录（我们创建的maven目录下），解压命令：

tar -zxvf 所要解压的文件名

**

tar -zxvf 所要解压的文件名

1.3、解压完毕以后，新建一个repository仓库，用于存放Maven下载下来的jar包

mkdir repository

2、配置镜像

编辑settings.xml文件

vi apache-maven-3.9.3/conf/settings.xml

按i键进入编辑模式

1.设置Maven仓库，就是我刚才新建的文件夹

**

<localRepository>/maven/repository</localRepository>

**
2.配置为阿里云镜像地址

**

<mirror>

**
**

<id>nexus-aliyun</id>

**
**

<mirrorOf>central</mirrorOf>

**
**

<name>Nexus aliyun</name>

**
**

<url>https://maven.aliyun.com/repository/public</url>

**
**

</mirror>

**

按Esc键退出编辑模式，输入:wq保存并退出vim编辑器

3、配置环境变量

编辑profile文件

vim /etc/profile

按i键进入编辑模式

添加如下环境变量

exportMAVEN_HOME=/usr/local/maven/apache-maven-3.9.3
exportPATH=$PATH:$MAVEN_HOME/bin

按Esc键退出编辑模式，输入:wq保存并退出vim编辑器

运行以下命令使profile文件生效

source /etc/profile

检查环境配置是否成功

mvn -v

大功告成！

三、Jenkins环境搭建–Docker

#查看你需要安装的版本docker search jenkins
#安装镜像包docker pull jenkins/jenkins   #默认安装最新版本#安装指定版本 指令入下docker pull jenkins/jenkins:xx(版本号)#查看是否安装成功(查看镜像包)docker images

1、使用以下命令下载Jenkins镜像(安装最新版)

docker pull jenkins/jenkins:latest

2、启动并创建Jenkins容器

#启动命令：docker run -u root -d\-p10240:8080 -p10241:50000 \-v /var/jenkins_home/workspace/:/var/jenkins_home/workspace/ \-v /var/run/docker.sock:/var/run/docker.sock \-v /usr/bin/docker:/usr/bin/docker \-v /usr/local/java/jdk1.8.0_381:/usr/local/java \-v /usr/local/maven/apache-maven-3.9.3:/usr/local/maven \-eJAVA_OPTS="-Dorg.apache.commons.jelly.tags.fmt.timeZone='Asia/Shanghai"\--name myjenkins jenkins/jenkins
 
 #解释：-d :后台运行
-p：10240：8080 镜像8080 ：端口映射到宿主机 10240端口
-p：10241：50000 镜像50000 ：端口映射到宿主机 10241端口
-v：/var/jenkins_home/workspace/:/var/jenkins_home/workspace/
/var/jenkins_home/workspace/ 宿主机的Jenkins目录挂载路径 jenkins
/var/jenkins_home/workspace/ 镜像服务器中jenkins的工作目录
-v /usr/bin/docker:/usr/bin/docker  : 挂载docker
-v /usr/local/java/jdk1.8.0_381:/usr/local/java : 挂载映射宿主机jdk
-v /usr/local/maven/apache-maven-3.9.3:/usr/local/maven : 挂载映射宿主机maven
-eJAVA_OPTS="-Dorg.apache.commons.jelly.tags.fmt.timeZone='Asia/Shanghai"\ ：同步时间
--name myjenkins（自定义容器名称） jenkins/jenkins（需要映射容器名称）

如果执行命令发现jenkins没有启动成功，很大概率是因为挂载的目录没有权限，需要授权

chown-R1000:1000 /root/apply/jenkins_mount
chown-R1000:1000 /root/apply/apache-maven-3.8.4 
chown-R1000:1000 /usr/local/jenkins 
chown-R1000:1000 /etc/localtime

jenkins容器启动以后，咱们就需要到阿里云或者是腾讯云中，将端口为10240打开

浏览器访问：你的服务器ip:10240。不出意外，你就能访问到jenkins了。

3、进入容器，查看登录初始化密码，执行命令：

dockerexec-it myjenkins /bin/bash
cat /var/jenkins_home/secrets/initialAdminPassword

选择安装推荐插件

2.3版本安装插件很多失败，我换成了2.415版本

安装完成后创建管理员用户

4、配置Jenkins

4.1、安装三个插件： Publish Over SSH和Maven Integration和GitLab ，点击： 系统管理->插件管理 -> 可选插件中进行输入安装。如下图所示：

4.2、安装好上一步中的几个插件之后，接下来需要在jenkins中配置一下Git和SSH: 点击：系统管理 -> 系统配置 -> 找到Git和SSH

4.3、配置JDK和Maven: 点击：系统管理 -> 全局工具配置 -> 找到JDK和Maven

四、使用Jenkins构建项目

Jenkins中构建项目的类型有很多，常用的有以下三种：

• 自由风格软件项目（FreeStyle Project）（推荐）
• Maven项目（Maven Project）
• 流水线项目（Pipeline Project）（推荐）

实际上每种类型的构建都可以完成一样的构建过程与结果，只是在操作方式、灵活度等方面有所区别，在实际开发中可以根据自己的需求和习惯来选择。从灵活度上来说，流水线类型是最高的。

1、Pipeline流水线项目构建（推荐）

简单来说，Pipeline就是一套运行在 Jenkins 上的工作流框架，将原来独立运行于单个或者多个节点的任务连接起来，实现单个任务难以完成的复杂流程编排和可视化的工作。

Pipeline支持两种语法：声明式（Declarative）和脚本式（Scripted Pipeline）语法。

注意：需要安装Pipeline插件

1.1、声明式项目构建

• stages：代表整个流水线的所有执行阶段，通常stages只有1个，里面包含多个stage。
• stage：代表流水线中的某个阶段，可能出现n个。一般分为拉取代码、编译构建、部署等阶段。
• steps：代表一个阶段内需要执行的逻辑。steps里面是shell脚本，git拉取代码、ssh远程发布等任意内容。

这里，我们编写一个简单声明式的Pipeline，来感受一下整个构建过程：

pipeline {
 agent any
 stages {
   stage('拉取代码'){
    steps {echo'拉取代码'}}
   stage('编译构建'){
    steps {echo'编译构建'}}
   stage('项目部署'){
    steps {echo'项目部署'}}}}

开始构建，并输出构建结果

1.2、脚本式项目构建

• Node ：节点，一个 Node 就是一个 Jenkins 节点，Master 或者 Agent，是执行 Step 的具体运行环境。
• Stage ：阶段，一个 Pipeline 可以划分为若干个 Stage，每个 Stage 代表一组操作，比如：Build、Test、Deploy，Stage 是一个逻辑分组的概念。
• Step ：步骤，Step 是最基本的操作单元，可以是打印一句话，也可以是构建一个 Docker 镜像，由各类 Jenkins 插件提供，比如命令：sh ‘make’，就相当于我们平时 shell 终端中执行 make 命令一样。

编写一个简单的脚本式Pipeline：

node{
   def mvnHome
   stage('Preparation'){echo'拉取代码'}
   stage('Build'){echo'编译构建'}
   stage('Results'){echo'项目部署'}}

开始构建，并输出构建结果

1.3、使用脚本构建项目

如果不会写流水线脚本，选择流水线语法可以自动生成Pipeline语法

点击【流水线语法】进入新页面

选择想要生成的流水线脚本，填写对应配置然后生成

Git拉取代码流水线语句：

连接服务器执行语句：

最终的流水线脚本：

pipeline {
    agent any

    tools {
        maven "maven3.9.3"
        jdk "jdk1.8"}

    stages {
        stage('拉取代码'){
            steps {git credentialsId: '4ef30b0b-a335-4a6e-bfbe-151d59676f44', url: 'http://42.236.74.152:8050/fumingxing/cmcc-tenant.git'}}
    stage('编译打包'){
            steps {sh'''echo "开始构建"
                mvn clean install-Dmaven.test.skip=true
                echo"构建结束"'''
            }}
        
        stage("服务传输、启动"){
             steps {
               sshPublisher(publishers: [sshPublisherDesc(configName: 'mySSH', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''#第一步是进入到服务器中生成好的jar包的目录下cd /var/jenkins_home/workspace/mytest/ruoyi-admin/target

#第二步是根据jar包的名字获取运行的pid，并且将该进程杀死ps-ef|grep ruoyi-admin.jar   |grep-vgrep|awk\'{printf $2}\'  |xargskill-9#最后一步就是将这个jar后台启动了，并且将日志输出到out.log中。nohupjava-Xms128m-Xmx128m-Xss1024k-XX:MaxNewSize=64M -XX:MaxPermSize=64M -jar ruoyi-admin.jar >out.log 2>&1&''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: '', remoteDirectorySDF: false, removePrefix: 'ruoyi-admin/target', sourceFiles: 'ruoyi-admin/target/ruoyi-admin.jar')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])}}}}