Jenkins学习笔记（一）：Docker安装Jenkins及自动部署Maven项目

Docker安装Jenkins及自动部署Maven项目

安装Jenkins

Jenkins是一个开源软件项目，是基于Java开发的一种持续集成工具，用于监控持续重复的工作，旨在提供一个开放易用的软件平台，使软件的持续集成变成可能。

前期Jenkins检查工作

注：本文章于2019年末发布，与现在Jenkins版本有所不同！！仅参考思路。
根据自己java项目环境选择对应的Jenkins版本，本文章java8，目前最新latest的Jenkins已不支持java8，目前最低需支持java11（Java 11 支持 Java 8 的 API），而Java 11 上运行 Jenkins，其支持将于 2024 年 9 月 30 日或之后结束。有关更多详细信息，请参阅Jenkins官方文档。！所以建议大家直接安装Java17版本的Jenkins，避免不必要的麻烦，旧版本Jenkins可参考DockerHub官网查看对应的Tags。

镜像加速器

Docker添加阿里云镜像加速器，以便于docker在pul拉取l镜像文件、jenkins插件库安装的时候速度快些。

操作：搜索阿里云官网 =》登录账号后搜索“容器镜像服务 ACR” =》在镜像工具即可看到镜像加速器

创建docker文件夹

[root@nginx-1 ~]# sudo mkdir -p /etc/docker

编辑 daemon.json 文件

[root@nginx-1 ~]# vi /etc/docker/daemon.json

设置加速器地址

{ 
   
  "registry-mirrors": ["https://k9e55i4n.mirror.aliyuncs.com"]
}

重新加载和重启docker

[root@nginx-1 ~]# systemctl daemon-reload
[root@nginx-1 ~]# systemctl restart docker

部署Jenkins

#拉取Jenkins官方提供的集成blueocean插件的镜像
docker pull jenkinsci/blueocean

#运行容器
docker run -d --name jenkins -u root -p 14639:8080 -p 50000:50000 --privileged=true  -v /var/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean

参数说明：
-d：守护进程的方式启动容器,不打印正在运行的此容器的Docker日志。（或 -it：交互的方式启动容器,打印容器的启动日志信息，相当执行了一遍 docker logs -f jenkins ）。
-p：将容器的8080端口映射到宿主机的8888端口。
-v：挂载目录(宿主机目录:容器目录);挂载后,修改宿主机的挂载目录将直接影响到容器的目录。
--name：容器的名称。
--privileged：使用该参数，container内的root拥有真正的root权限。
jenkinsci/blueocean：指定镜像名。

docker-compose方式：

version: '3'
services:
  jenkins:
    image: jenkinsci/blueocean    #镜像名称
    container_name: jenkins    #指定容器名
    privileged: true    #使用该参数，container内的root拥有真正的root权限。
    restart: always    #在容器退出时总是重启容器
    user: root    #指定用户 
    network_mode: "host"    #网络模式（默认bridge）
    ports:    #容器的端口映射到宿主机上（“:”前数字为宿主机端口，“:”后数字为容器端口）
      - "14639:8080"    #自定义宿主机端口8080
      - "50000:50000"
    environment:
      TZ: Asia/Shanghai    #指定容器运行所属时区
    volumes:
    - /etc/localtime:/etc/localtime
    - ./jenkins_home:/var/jenkins_home
    - /var/run/docker.sock:/var/run/docker.sock    #Docker守护进程（Docker daemon）默认监听的Unix域套接字（Unix domain socket），容器中的进程可以通过它与Docker守护进程进行通信。简单来说容器使用宿主机docker命令

访问Jenkins

在浏览器上填入 http://<你的ip>:14639

14639端口号：宿主机映射容器8080的端口号（为了避免8080端口冲突）

成功：显示Jenkins的logo，等待一段时间即可。

#查看Jenkins的运行日志，日志中含有管理员初始密码（ctrl+c：退出日志）
docker logs -f --tail=500 jenkins

失败：如果无法访问请检查系统防火墙或开端口。

 #CentOS7关防火墙
 systemctl stop firewalld
 
 #开放端口
 firewall-cmd --zone=public --add-port=14639/tcp --permanent
 firewall-cmd --reload

手动配置Jenkins

Jenkins初始化

出现如下页面，需要我们手动获取Admin初始密码。

#进入容器
docker exec -it jenkins /bin/bash

#查看初始密码
cat /var/jenkins_home/secrets/initialAdminPassword

复制输出的内容，粘贴到Administrator password。此时进行下一步你会看到此界面，点击 Install suggested plugins

等待安装完毕（如果插件安装失败，可能没配置镜像加速器的原因，走国内仓库下载插件！）：

漫长的等待之后到了下一步，创建admin用户：

到这里，整个初始化Jenkins结束了，接下来是配置环境了……

手动配置maven环境（可选）

我们需要下载一个maven，然后配置自己公司setting.xml，比如私服地址。最后的时候我将对docker命令进行总结。

#进入容器
docker exec -it jenkins /bin/bash

#进入安装位置
cd /usr/local

#下载maven安装包
wget http://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.gz

#解压压缩包
tar -zxvf apache-maven-3.3.9-bin.tar.gz

#删除压缩包
rm apache-maven-3.3.9-bin.tar.gz

#配置maven环境变量
vi /etc/profile
	在文件的最下面添加：
		#set Maven environment
		export MAVEN_HOME=/usr/local/maven
		export PATH=$MAVEN_HOME/bin:$PATH
		
#生效profile文件
source /etc/profile

#检查maven是否配置成功（显示maven home、java home等信息则配置成功）
mvn -v

需要替换容器的setting文件，前提是setting文件已经配置好自己公司的私服地址。
从本机配置好setting文件，再将该文件传输到宿主机（也就是虚拟机）中

#在宿主机中安装lrzsz依赖，lrzsz是上传下载的
yum install lrzsz

#上传文件，rz就是上传;sz就是下载，上传本地setting文件
rz

#默认当前位置是上传目录，可以查看当前目录
pwd

#通过dokcer命令将setting文件上传到Jenkins容器中
docker cp [上传目录]/setting.xml jenkins:/usr/local/apache-maven-3.3.9/conf

至此，maven环境配置完成,然后进入管理Jenkins页面……

Jenkins页面配置

到管理页面……

点击Manage Plugins，安装maven插件……

安装成功后，点击Global Tool Configuration，进行全局配置……

maven的setting提供（如果maven自动安装，此步骤忽略）：
JDK配置（jenkins默认自动带openjdk，可自行查看系统信息=》环境变量=》JAVA_HOME），或可勾选自动安装
Maven配置（之前手动安装的maven目录，否则勾选自动安装即可）
SSH remote hosts（连接远程服务器，执行shell脚本）

a.在Jenkins主界面——>系统管理——>插件管理，安装SSH plugin插件，这个插件使用SSH协议远程执行shell命令。

b.在Jenkins主界面——>系统管理——>系统配置，找到SSH remote hosts，对SSH进行配置让其连接远程服务器。

最后，点击应用并保存！

构建maven项目

新建Item

点击新建Item ，出现如下页面……

进入Item，配置你的任务……

git配置

第3步添加一个git的凭据提供者，填写git的账号和密码，然后Credentials选择刚刚添加的凭据者。
配置Pre Steps（使用shell脚本对已存在的容器进行停止容器，删除容器，删除镜像）

#!/bin/bash
result=$(docker ps| grep "dec-netty") 
if [[ "$result" != "" ]]
then
echo "================docker stop dec-netty================"
docker stop dec-netty
fi
result1=$(docker ps -a | grep "dec-netty") 
if [[ "$result1" != "" ]]
then
echo "================docker rm dec-netty================"
docker rm dec-netty
fi
result2=$(docker images | grep "dec-netty:0.0.1")
if [[ "$result2" != "" ]]
then
echo "================docker rmi dec-netty:0.0.1================"
docker rmi dec-netty:0.0.1
fi

Build Maven（maven构建项目）

#maven命令（通过DockerFile将项目构建成docker镜像）
clean package docker:build

项目中的pom文件的大致内容：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
 
    <parent>
        <groupId>com.deceen</groupId>
        <artifactId>netty-parent</artifactId>
        <version>2.0.8.RELEASE</version>
        <!-- lookup parent from repository --> <!--<relativePath/>-->
    </parent>
 
    <artifactId>dec-netty</artifactId>
    <version>0.0.1</version>
    <name>dec-netty</name>
    <packaging>jar</packaging>
    <description>Netty即时通讯</description>
 
    <dependencies>
 
        <!-- web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
 
        <!-- Netty --> <dependency> <groupId>io.netty</groupId> <artifactId>netty-all</artifactId> <version>4.1.31.Final</version> </dependency>
 
        <!-- fastjson --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.59</version> </dependency>
 
        <!-- lang3 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> </dependency>
 
    </dependencies>
 
    <build>
        <finalName>app</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <!--这块一定要配置否则打jar的时候会说找不到主类--> <configuration> <fork>true</fork> <mainClass>com.DecNettyApplication</mainClass> </configuration> <executions> <execution> <goals> <goal>repackage</goal> </goals> </execution> </executions>
            </plugin>
            
            ## ===============重要配置如下 ↓ ===============
            <!-- Docker maven plugin --> <plugin> <groupId>com.spotify</groupId> <artifactId>docker-maven-plugin</artifactId> <version>1.0.0</version> <configuration> <!--镜像名，这里用工程名--> <imageName>${project.artifactId}:${project.version}</imageName> <!--DockerFile文件所在目录--> <dockerDirectory>src/main/docker</dockerDirectory> <!--构建镜像的配置信息--> <resources> <resource> <targetPath>/</targetPath> <directory>${project.build.directory}</directory> <include>${project.build.finalName}.jar</include> </resource> </resources> <!-- docker配置，允许远程访问 --> <dckerHost>http://61.185.75.**:1689</dockerHost> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>8</source> <target>8</target> </configuration> </plugin> <!-- Docker maven plugin -->
        </plugins>
    </build>
 
</project>

1、pom文件中的 dckerHost 是什么，怎么填写？
答：配置服务器开启远程访问docker，可通过DockerFile打成镜像放在服务器上，在宿主机中进行开启设置。
Docker直接开启端口访问是不安全的，别人只要连上之后就可以任意操作，建议必须开启Docker的TLS认证方法。（本文简化流程，暂不提供，可参考 Docker开启TLS 文章）
# 修改docker配置，允许远程访问
vi /lib/systemd/system/docker.service
# 其中ExecStart=后，斜杠（\）前，添加配置：
	-H tcp://0.0.0.0:1689 -H unix:///var/run/docker.sock
# 修改后如下：
ExecStart=/usr/bin/dockerd -H fd:// \
				-H tcp://0.0.0.0:1689 \
				-H unix:///var/run/docker.sock \
				--containerd=/run/containerd/containerd.sock
# 修改后刷新配置，重启服务
systemctl daemon-reload
systemctl restart docker
2、pom文件中的dockerDirectory目录下有什么内容？
答：docker的Dockerfile文件，通过Dockerfile将maven项目构建成docker镜像，文件名字是固定的，Dockerfile不能修改。
　
Dockerfile内容如下：
FROM java:8
MAINTAINER luzc
COPY app.jar /
ENTRYPOINT ["java","-jar","app.jar"]
3、构建任务时，日志报错[FATAL] Non-resolvable parent POM for com.deceen:dec-netty:0.0.1: Could not find artifact com.deceen:netty-parent:pom:2.0.8.RELEASE in bintray (http://dl.bintray.com/andimarek/graphql-java) and ‘parent.relativePath’ points at no local POM @ line 5, column 13
答：将pom文件中的parent节点中的relativePath注释掉即可。

配置Post Steps（运行容器）

#运行容器
docker run -d --name dec-netty -p 12025:8080 dec-netty:0.0.1
echo '================ 运行容器日志信息 ================'
#打印容器的运行日志
docker logs -f dec-netty

最后，点击应用并保存！

构建任务

点击第2步的构建列队中的任务，查看任务的日志信息……

显示Finished: SUCCESS，则说明Jenkins自动构建成功！！！
Success

自动构建

前面都是通过Jenkins手动进行项目部署，Jenkins强大的原因是自动帮你持续部署项目，当项目push到git上时，Jenkins就会去git上拉取代码进行构建。下面我将介绍git两种方法进行自动构建。

Gitblit

编辑jenkins.groovy文件
在git目录/data/groovy/jenkins.groovy

注意：保存后，需要重启Gitblit服务。

这里的Gitblit的版本是1.8.0，所以配置Jenkins地址有所不同。

Gitblit配置钩子（hooks）
进入Gitblit中的项目目录，点击编辑

接下来点击 receive
最后在pre-receive 脚本中将jenkins移入Selected选择栏中，然后点击保存！
配置jenkins的任务

最后点击应用并保存！你就可以push代码时，jenkins就会自动帮你构建项目了。

Gitblit的Jenkins groovy插件会调用Jenkins的钩子来按需建立这种方式。

GitLab

GitLab中使用webhook向jenkins通知，当有代码push后将通知jenkins进行构建。

在Jenkins中找到通知地址
进入Jenkins设置允许匿名访问jenkins，这样GitLab才要成功通知Jenkins
在gitlab中设置允许请求本地网络服务
设置钩子地址，即jenkins中的项目地址
钩子添加成功

命令总结

Docker命令

#查看某个镜像版本信息
docker search 镜像
#拉取镜像
docker pull 镜像
#列出已有镜像
docker images
#导出镜像
docker save REPOSITORY:TAG/镜像ID > /镜像路径/镜像.tar.gz
举例：docker save centos7:latest > /root/centos7.tar.gz
#导入镜像
docker load < /镜像路径/镜像.tar.gz
举例：docker load < /root/centos7.tar.gz
#移除镜像
docker rmi REPOSITORY:TAG/镜像ID
#运行容器方法一（守护进程）
docker run -d --name 容器取名 -p 宿主机端口:容器端口 --privileged=true REPOSITORY:TAG/镜像ID
#运行容器方法二（交互）
docker run -it --name 容器取名 -p 宿主机端口:容器端口 --privileged=true REPOSITORY:TAG/镜像ID /bin/bash
#查看容器正在启动情况
docker ps
#查看容器所有启动情况
docker ps -a
#进入容器
docker exec -it 容器名 /bin/bash
#退出容器
exit
#复制文件到容器中
docker cp /文件路径/文件 容器名:/存储路径
举例：docker cp /usr/local/setting.xml jenkins:/usr/local/apache-maven-3.3.9/conf
#启动容器
docker start 容器名/容器ID
#暂停容器
docker stop 容器名/容器ID
#移除容器
docker rm 容器名/容器ID
#一键启动、移除、暂停所有容器
docker start  `docker ps -qa`
docker rm `docker ps -qa`
docker stop `docker ps -qa`
#批量删除tag为"<none>"镜像
docker rmi $(docker images | egrep '<none>' | awk '{print $3}')
#挂载 /opt/etc 前需要将目录下的文件复制到宿主机下，将 /opt/emqx/etc 目录下的文件复制到宿主机下
docker run --rm emqx/emqx:5.2.1 sh -c 'cd /opt/emqx && tar -c etc' | tar -C $PWD -x
#执行容器内部命令，检查nginx配置文件
docker exec -it nginx:latest nginx -t

#查询容器日志
docker logs -f -t --tail=500 容器名
#查看运行容器的挂载详细信息（-A：后面指定显示行数）
docker inspect 容器名 |grep Mounts -A 20
#dokcer开机自启某个容器
docker update --restart=always 容器名
#前提Docker服务开机自启
sudo systemctl enable docker.service

其他命令

#创建文件
mkdir 文件名
#复制粘切文件
mv 原文件目录 目标文件目标 
#删除文件
rm 删除文件目录
#删除文件夹
rm -rf 删除文件夹目录

#查看防火墙状态
systemctl status firewalld
#暂停防火墙状态
systemctl stop firewalld
#启动防火墙状态
systemctl start firewalld
#永久关闭防火墙（关机重启才会生效）
systemctl disable firewalld
#开放端口号
firewall-cmd --zone=public --add-port=端口号/tcp --permanent
firewall-cmd --reload
#移除端口号
firewall-cmd --zone=public --remove-port=端口号/tcp --permanen
#查看所有开放端口列表
firewall-cmd --zone=public --list-ports

#查看某应用进程
ps -ef | grep 应用名
#查看某端口
netstat -lnp|grep 端口名

#查找所有yum包
yum list all
#根据关键字查询
yum list all|grep 关键字
#安装基本依赖，wget 网页下载 lrzsz上传下载 bash-completion tab补全 vim 编辑器
yum install wget lrzsz bash-completion vim -y

#设置服务开机启动
chkconfig 服务名 on 

#查找文件 /:从根目录开始找
find / -name 文件名   

#安装zip解压
yum install unzip -y
#解压zip包
unzip 包名.zip

#查看内存占用情况
free -g
#查看硬盘内存
df -h

今天的文章Jenkins学习笔记（一）：Docker安装Jenkins及自动部署Maven项目分享到此就结束了，感谢您的阅读。

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请发送邮件至举报，一经查实，本站将立刻删除。
如需转载请保留出处：https://bianchenghao.cn/84216.html