当前位置: 首页 > news >正文

Jenkins 实现项目的构建和发布

作者:小凯
沉淀、分享、成长,让自己和他人都能有所收获!

本文的宗旨在于通过简单干净实践的方式教会读者,如何在 Docker 中部署 Jenkins,并通过 Jenkins 完成对项目的打包构建并在 Docker 容器中部署。

Jenkins 的主要作用是帮助你,把需要在本地机器完成的 Maven 构建、Docker 镜像发布、云服务器部署等系列动作全部集成在一个服务下。简化你的构建部署操作过程,因为 Jenkins 也被称为 CI&CD(持续集成&持续部署) 工具。提供超过 1000 个插件(Maven、Git、NodeJs)来支持构建、部署、自动化, 满足任何项目的需要。

官网:

英文:https://www.jenkins.io/(opens new window)
中文:https://www.jenkins.io/zh/(opens new window)

一、操作说明
本节给大家介绍 Jenkins 环境的安装,以及以最简单的方式配置使用 Jenkins 完成对 xfg-dev-tech-jenkins (opens new window)案例项目的部署。部署后可以访问 xfg-dev-tech-jenkins (opens new window)项目提供的接口进行功能验证。整个部署操作流程如下;
在这里插入图片描述

  • 左侧竖列为核心配置部署流程,右侧是需要在配置过程中处理的细节。
  • 通过把本地对项目打包部署的过程拆解为一个个模块,配置到 Jenkins 环境中。这就是 Jenkins 的作用。

二、环境配置
1.确保你已经在(云)服务器上配置了 Docker (opens new window)环境,以及安装了 docker-compose。同时最好已经安装了 Portainer (opens new window)管理界面这样更加方便操作。
2.在配置和后续的验证过程中,会需要访问(云)服务的地址加端口。如果你在云服务配置的,记得开放端口;9000 - portainer、9090 - jenkins、8091 - xfg-dev-tech-app 服务

1. Jenkins 部署
1.1 上传文件
在这里插入图片描述

  • 如图;以上配置内容已经放到 xfg-dev-tech-jenkins (opens new window)工程中,如果你是云服务器部署则需要将 dev-ops 部分全部上传到服务器的根目录下。
  • compose-down.sh 是 docker-compose (opens new window)下载文件,只有你安装了 docker-compose 才能执行 docker-compose -f docker-compose-v1.0.yml up -d
  • jdk-down.sh 是 jdk1.8 下载路径,以及解压脚本。如果你在云服务器下载较慢,也可以本地搜索 jdk1.8 下载,并上传到云服务器上解压。注意:本步骤是可选的,如果你的项目不强依赖于 jdk1.8 也可以使用 Jenkins 默认自带的 JDK17。可以通过在安装后的 Jenkins 控制台执行 which java 找到 JDK 路径。
  • maven 下的 settings.xml 配置,默认配置了阿里云镜像文件,方便在 Jenkins 构建项目时,可以快速地拉取下载下来包。

1.2 脚本说明

version: '3.8'
# 执行脚本;docker-compose -f docker-compose-v1.0.yml up -d
services:jenkins:image: jenkins/jenkins:2.439container_name: jenkinsprivileged: trueuser: rootports:- "9090:8080"- "50001:50000"volumes:- ./jenkins_home:/var/jenkins_home # 如果不配置到云服务器路径下,则可以配置 jenkins_home 会创建一个数据卷使用- /var/run/docker.sock:/var/run/docker.sock- /usr/bin/docker:/usr/local/bin/docker- ./maven/conf/settings.xml:/usr/local/maven/conf/settings.xml # 这里只提供了 maven 的 settings.xml 主要用于修改 maven 的镜像地址- ./jdk/jdk1.8.0_202:/usr/local/jdk1.8.0_202 # 提供了 jdk1.8,如果你需要其他版本也可以配置使用。environment:- JAVA_OPTS=-Djenkins.install.runSetupWizard=false # 禁止安装向导「如果需要密码则不要配置」docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPasswordrestart: unless-stoppedvolumes:jenkins_home:

Jenkins Docker 执行安装脚本。

  • ./jenkins_home:/var/jenkins_home 是在云服务器端挂一个映射路径,方便可以重新安装后 Jenkins 依然存在。你也可以配置为 jenkins_home:/var/jenkins_home 这样是自动挂在 volumes jenkins_home 数据卷下。
  • docker 两个 docker 的配置是为了可以在 Jenkins 中使用 Docker 命令,这样才能在 Docker 安装的 Jenkins 容器内,使用 Docker 服务。
  • ./maven/conf/settings.xml:/usr/local/maven/conf/settings.xml 为了在 Jenkins 中使用映射的 Maven 配置。
  • ./jdk/jdk1.8.0_202:/usr/local/jdk1.8.0_202 用于在 Jenkins 中使用 jdk1.8
  • JAVA_OPTS=-Djenkins.install.runSetupWizard=false 这个是一个禁止安装向导,配置为 false 后,则 Jenkins 不会让你设置密码,也不会一开始就安装一堆插件。如果你需要安装向导可以注释掉这个配置。并且当提示你获取密码时,你可以执行;docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword 获取到登录密码。

1.3 执行安装
在这里插入图片描述

[root@lavm-aqhgp9nber dev-ops]# docker-compose -f docker-compose-v1.0.yml up -d
[+] Building 0.0s (0/0)                                                                                                       
[+] Running 1/0Container jenkins  Running 
  • 执行脚本 docker-compose -f docker-compose-v1.0.yml up -d 后,这样执行完毕后,则表明已经安装成功了💐。

2. 插件安装
地址:http://localhost:9090/ (opens new window)- 登录Jenkins
在这里插入图片描述
在这里插入图片描述

  • 1~2步,设置镜像源,设置后重启一下 Jenkins。 镜像源地址:https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 3~4步,下载插件,先下载安装 chinese 汉化插件,方便不太熟悉 Jenkins 的伙伴更好的知道页面都是啥内容。
  • 5步,所有的插件安装完成后,都需要重启才会生效。安装完 chinese 插件,重启在进入到 Jenkins 就是汉化的页面了
  • 除了以上步骤,你还需要同样的方式安装 maven、git、docker 插件。
  • 注意,因为网络问题你可以再做过程中,提示失败。没关系,你可以再搜这个插件,再重新下载。它会把失败的继续下载。

3. 全局工具配置
地址:http://localhost:9090/manage/configureTools/(opens new window)
在这里插入图片描述

  • 用于构建部署的 SpringBoot 应用的环境,都需要在全局工具中配置好。包括;Maven、JDK、Git、Docker。注意这里的环境路径配置,如果配置了是会提示你没有对应的路径文件夹。

4. 添加凭证
地址:http://localhost:9090/manage/credentials/store/system/domain/_/(opens new window)

在这里插入图片描述

  • 配置了Git仓库的连接凭证,才能从Git仓库拉取代码。
  • 如果你还需要操作如 ssh 也需要配置凭证。

三、新建任务
一个任务就是一条构建发布部署项目的操作。

1. 配置任务
在这里插入图片描述

xfg-dev-tech-jenkins

2. 配置Git
在这里插入图片描述

# 你可以 fork 这个项目,到自己的仓库进行使用
https://gitcode.net/KnowledgePlanet/ddd-scene-solution/xfg-dev-tech-content-moderation.git

3. 配置Maven
在这里插入图片描述

  • 在高级中设置 Maven 配置的路径 /usr/local/maven/conf/settings.xml。这样才能走自己配置的阿里云镜像仓库。
clean install -Dmaven.test.skip=true

3. 配置Shell

# 先删除之前的容器和镜像文件
if [ "$(docker ps -a | grep xfg-dev-tech-app)" ]; then
docker stop xfg-dev-tech-app
docker rm xfg-dev-tech-app
fi
if [ "$(docker images -q xfg-dev-tech-app)" ]; then
docker rmi xfg-dev-tech-app
fi# 重新生成
cd /var/jenkins_home/workspace/xfg-dev-tech-jenkins/xfg-dev-tech-app
docker build -t xiaofuge/xfg-dev-tech-app .
docker run -itd -p 8091:8091 --name xfg-dev-tech-app xiaofuge/xfg-dev-tech-app

在这里插入图片描述

  • 当你熟悉后还可以活学活用,比如这里只是做build 但不做run执行操作。具体的部署可以通过 docker compose 执行部署脚本。
  • 另外如果你有发布镜像的诉求,也可以在这里操作。

四、测试验证
1. 工程准备
工程:https://gitcode.net/KnowledgePlanet/road-map/xfg-dev-tech-jenkins 你可以fork到自己的仓库进行使用,你的账号密码就是 CSDN 的账号密码。

@SpringBootApplication
@RestController()
@RequestMapping("/api/")
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class);}/*** http://localhost:8091/api/test*/@RequestMapping(value = "/test", method = RequestMethod.GET)public ResponseBodyEmitter test(HttpServletResponse response) {response.setContentType("text/event-stream");response.setCharacterEncoding("UTF-8");response.setHeader("Cache-Control", "no-cache");ResponseBodyEmitter emitter = new ResponseBodyEmitter();String[] words = new String[]{"嗨,臭宝。\r\n", "恭喜💐 ", "你的", " Jenkins ", " 部", "署", "测", "试", "成", "功", "了啦🌶!"};new Thread(() -> {for (String word : words) {try {emitter.send(word);Thread.sleep(250);} catch (IOException | InterruptedException e) {throw new RuntimeException(e);}}}).start();return emitter;}}
  • 工程中提供了接口;http://localhost:8091/api/test

2. CI&CD - 构建发布
地址:http://localhost:9090/job/xfg-dev-tech-jenkins/(opens new window)
在这里插入图片描述

  • 点击构建项目,最终会完成构建和部署成功。运行到这代表你全部操作完成了。

3. 验证结果
地址:http://localhost:9000/#!/2/docker/containers(opens new window)
在这里插入图片描述

访问:http://localhost:8091/api/test(opens new window)
在这里插入图片描述

  • 运行到这代表着你已经完整的走完了 Jenkins CI&CD 流程。
http://www.xdnf.cn/news/1149193.html

相关文章:

  • 企业运维实战:Jenkins 依赖 JDK21 与应用需 JDK1.8 共存方案(含流水线配置)
  • 【ExtendScript Toolkit CC】【PR插件开发】获取当前序列的所有剪辑片段名
  • Java 性能调优实战:JVM 参数配置与 GC 日志分析
  • 深度学习-线性神经网络
  • QCC系列显示交互层的自研技术突破与实践
  • 本地大模型部署工具全解析:LM Studio vs. Ollama 及最佳实践指南
  • 81、【OS】【Nuttx】【启动】caller-saved 和 callee-saved 示例:压栈内容
  • Mybatis学习之简介(一)
  • Django接口自动化平台实现(三)
  • 多式联运物流管理系统的设计与实现(原创)
  • picoCTF 2024: [[NoSQL]] Injection - Writeup
  • 【MATLAB例程】Taylor算法用于TOA(到达时间)的三维标签位置解算,可自适应基站数量。附下载链接
  • 一个基于阿里云的C端Java服务的整体项目架构
  • 后缀树:字符串处理的利器
  • 模型轻量化全指南:从剪枝量化到低配置设备部署实战
  • 【Linux】基本指令详解(三) 指令本质、三个查找指令、打包压缩、重要热键、linux体系结构、命令行解释器
  • Go-Redis × 向量检索实战用 HNSW 在 Redis 中索引与查询文本 Embedding(Hash JSON 双版本)
  • 智能光电检测:YOLO+OpenCV联合算法工程实践
  • 【运维】flash attention安装出现错误及编译慢
  • 思维链(CoT)技术全景:原理、实现与前沿应用深度解析
  • windows wsl2-06-docker hello world
  • 1.初始化
  • Windows原生环境配置Claude Code MCP(通过JSON)
  • 【MySQL笔记】视图
  • Spring AI 项目实战(十九):Spring Boot + AI + Vue3 + OSS + DashScope 构建多模态视觉理解平台(附完整源码)
  • mac 配置svn
  • 医疗AI与融合数据库的整合:挑战、架构与未来展望(上)
  • xss-labs1-8题
  • 浏览器渲染原理——计算属性和布局过程常考内容
  • 基于单片机病床呼叫系统/床位呼叫系统