本文章实现最简单全面的 Jenkins + Docker + Spring Boot 一键自动部署项目。步骤齐全,少走坑路。
-
环境:CentOS7 + Git (Gitee)
-
实现步骤:在 Docker 安装 Jenkins,配置 Jenkins 基本信息,利用 Dockerfile 和 Shell 脚本实现项目自动拉取打包并运行。
一、安装docker
安装社区版本 Docker CE
1. 确保 yum 包更新到最新
yum update
2. 卸载旧版本(如果安装过旧版本的话)
yum remove docker docker-common docker-selinux docker-engine
3. 安装需要的软件包
yum install -y yum-utils device-mapper-persistent-data lvm2
4. 设置 yum 源
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
5. 安装 Docker
yum install docker-ce #由于repo中默认只开启stable仓库,故这里安装的是最新稳定版17.12.0
yum install <自己的版本> # 例如:sudo yum install docker-ce-17.12.0.ce
6. 启动并设置开机启动
systemctl start docker
systemctl enable docker
7. 验证安装是否成功
docker version
二、安装 Jenkins
Jenkins 中文官网:https://www.jenkins.io/zh/
1. 安装 Jenkins
Docker 安装一切都是那么简单。注意检查 8080 是否已经占用,如果占用请修改端口。
docker run --name jenkins -u root --rm -d -p 8080:8080 -p 50000:50000 -v /var/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean
如果没改端口号的话,安装完成后访问地址:
http://{部署Jenkins所在服务IP}:8080
此处会有几分钟的等待时间。
2. 初始化 Jenkins
详情见官网教程:https://www.jenkins.io/zh/doc
2.1 解锁 Jenkins
# 进入Jenkins容器
docker exec -it {Jenkins容器名} bash
# 例如 docker exec -it jenkins bash
# 查看密码
cat /var/lib/jenkins/secrets/initialAdminPassword
# 复制密码到输入框里面
2.2 安装插件
选择第一项:安装推荐的插件。
2.3 创建管理员用户
此账户信息一定要记住哦。
三、系统配置
1. 安装需要插件
进入【首页】–【系统管理】–【插件管理】–【可选插件】。搜索以下需要安装的插件,点击安装即可。
-
安装 Maven Integration
-
安装 Publish Over SSH(如果不需要远程推送,不用安装)
-
如果使用 Gitee 码云,安装插件Gitee(自带 Git 不用单独安装)
2. 配置 Maven
进入【首页】–【系统管理】–【全局配置】,拉到页面最下方 maven–maven 安装。
四、创建任务
1. 新建任务
点击【新建任务】,输入任务名称,点击构建一个*风格的软件项目。
2. 源码管理
点击【源码管理】–【Git】,输入仓库地址,添加凭证,选择好凭证即可。
3. 构建触发器
点击【构建触发器】–【构建】–【增加构建步骤】–【调用顶层 Maven 目标】–【「填写配置」】–【保存】。
此处命令只是 install,看是否能生成 jar 包。
clean install -Dmaven.test.skip=true
4. 保存
点击【保存】按钮即可。
五、测试
该功能测试是否能正常打包。
1. 构建
点击构建按钮。
2. 查看日志
点击正在构建的任务,或者点击任务名称进入详情页面,查看控制台输出。看是否能成功打成 jar 包。
该处日志第一次可能下载依赖 jar 包失败,再次点击构建即可成功。
3. 配置JDK版本
4. 查看项目位置
cd /var/jenkins_home/workspace
ll # 即可查看是否存在
六、运行项目
因为项目和 Jenkins 在同一台服务器,所以我们用 Shell 脚本运行项目,原理既是通过 Dockerfile 打包镜像,然后 docker 运行即可。
1. Dockerfile
在 Spring Boot 项目根目录新建一个名为 Dockerfile 的文件,注意没有后缀名。
其内容如下:(大致就是使用 JDK 8,把 jar 包添加到 docker 然后运行 prd 配置文件。详细可以查看其他教程)
FROM jdk:8
VOLUME /tmp
ADD target/zx-order-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8888ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar","--spring.profiles.active=prd"]
2. 修改 Jenkins 任务配置
配置如下:
"-t" 指定新镜像名,"." 表示 Dockfile 在当前路径。
cd /var/jenkins_home/workspace/zx-order-api
docker stop zx-order || true
docker rm zx-order || true
docker rmi zx-order || true
docker build -t zx-order .
docker run -d -p 8888:8888 --name zx-order zx-order:latest
备注:
1. 上图用了 docker logs -f 是为了方便看日志,真实环境不要用,因为会一直等待日志,构建任务会失败;
2. 加 "|| true" 是如果命令执行失败也会继续实行,为了防止第一次没有该镜像报错;
3. 保存:点击保存即可;
4. 构建:查看 Jenkins 控制台输出,输出如下,证明成功;
5. 验证
docker ps # 查看是否有自己的容器
docker logs # 自己的容器名,查看日志是否正确
# 打开浏览器访问项目