(自动化部署，CI/CD)多环境多平台安装并使用Jenkins

最新推荐文章于 2025-03-29 10:16:52 发布
最新推荐文章于 2025-03-29 10:16:52 发布
阅读量2.2k 收藏 18
点赞数 35
文章标签： 自动化 ci/cd jenkins 服务器 运维 容器 devops
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_40179653/article/details/143363814
版权

前言

CI/CD是持续化继承和持续化部署的简称。目的是在开发的过程中，尽可能的降低人工成本，来完成部署操作。通过Jenkins自动流水线工作可以省去很多时间，对于程序开发者而言，将部署jar包、修改环境、日志记录等一系列操作集成到Jenkins任务内，省时又省力，本次将以Jenkins为核心进行从0到1的搭建与使用，并提供了Java单体项目与微服务的通用shell脚本供于使用。

环境说明

本文通过两种方式进行演示，第一种是基于Docker完成Jenkins的安装与应用，Docker使用版本为25.0.3；第二种是直接在本机上安装Jenkins（本人主机为Mac，所以使用Mac来安装，Linux基本也是一样的）

基于Docker的Jenkins更多适合训练，因为所有的操作都在容器内、方便后续转移以及迁移。但缺点是Jenkins与宿主机的环境不互通，如在容器打完的jar包只能放在挂载的目录里。而且Java项目需要连接的中间件也非常多、且因为jar包是跑在Jenkins容器内的，所以配置容器间通信又是一个复杂点。（推荐初上手的同学使用，先用docker搭建一个完成的任务进行测试）

而直接部署在本机上更适合生产环境，更加的灵活方便，shell脚本的操作空间更大，并且可以直接访问各种中间件，省去了容器间通信的配置调试时间

安装Jenkins（Docker）

基于Docker安装Jenkins大致分为拉取镜像与脚本编辑

拉取镜像

这里拉取镜像的时候我推荐直接去官网指定版本下载，我一开始通过后缀跟latest下载最新版导致很多插件都下不下来。最后去官网指定了一个版本才行 Jenkins-Docker镜像官网

# 修改前
docker pull jenkins/jenkins:latest
# 修改后(因为我本地开发环境用的是17，所以直接下载了一个内置17的jenkins，当然也可以不指定，后通过jenkins内部下载对应的Java版本，不过还是更推荐前者，而且在内部下载Java也比较麻烦。本文以前者进行！！)
docker pull jenkins/jenkins:2.448-jdk17

编写安装脚本

vim startJenkins.sh

这里简单介绍一下每个参数，其中**-u**需要特别注意！

-d：后台运行

-p：将容器的8080端口映射到宿主机的8081端口上

-u：使用 UID 为 0 的用户身份运行 Jenkins 容器（这里如果不指定-u 后面如果想要通过jenkins操作SHELL脚本会导致没有权限，所以需要使用root的身份运行容器）

一般情况下0为管理员角色，也可以使用id 0来检测是否是root用户

image-20240311155842435

-v：挂载目录，将jenkins的工作目录挂在到宿主机内，这样使用jenkins操作目录时，我们本地也会有相同的反馈

–restart：在容器退出时自动重启容器

–name：配置容器名字

docker run -d \
-p 8081:8080 \
-u 0 \
-v /Users/sora33/docker/jenkins/data:/var/jenkins_home \
--restart=always \
--name jenkins \
jenkins/jenkins:2.448-jdk17

创建完成后，使用chmod -R赋值脚本权限并执行

# 赋值权限
chmod -R 755 startJenkins.sh
# 执行脚本
./startJenkins.sh

输入IP:8081进入Jenkins主页面，首次进入页面会要求我们输入密码

image-20240311162221114

密码会在容器内部打印出来

# docker logs 容器名
docker logs jenkins

将密码复制并进入下一级页面

image-20240311162328443

安装Jenkins（非Docker）

Mac平台：

使用homebrew安装Jenkins，如未安装homebrew请先安装homebrew！！！

# 安装jenkins
brew install jenkins
# 注意，mac端安装完成后最后去/opt/homebrew/Cellar/jenkins/2.448/bin目录下看一下jenkins的环境变量是否正确！这里注意替换版本号！该目录下有jenkins
sudo vim jenkins

如果JAVA_HOME不是如图完整的路径而是@@HOMEBREW……什么的请使用下面命令重新安装

brew reinstall jenkins

image-20240313095649414

之后去/opt/homebrew/Cellar/jenkins/2.448目录下修改局域网连接与端口号，默认只允许本机连接，改为0.0.0.0所有人可连接，下面端口号默认是8080，这里我改为了8081

image-20240313095949249

修改完成后，我们需要重启Jenkins

brew services restart jenkins

Linux平台：

Linux平台本人暂时未实践，不过只要成功安装Jenkins就没问题，区别在于文件的存放路径位置的不同，配置本质是一样的

sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/jenkins.repo
sudo rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key
sudo yum install jenkins

这里放出Linux下的Jenkins默认目录

/usr/lib/jenkins/：jenkins安装目录

/etc/sysconfig/jenkins：Jenkins配置文件目录

/var/lib/jenkins/：工作目录

/var/log/jenkins/jenkins.log：日志等

Jenkins配置

输入127.0.0.1:8081进入Jenkins主页面，按照提示去对应目录拿到密码，下面我们需要安装常用的插件

安装插件

进入到该页面后，我们选择安装推荐的插件

PS：这里每个人的网络环境都不同，所以有可能导致一些插件无法正确下载下来

可以尝试改为清华大学的下载站，具体方法是进入刚刚我们挂载的工作目录内，也就是刚刚启动脚本-v所指定的目录，找到 hudson.model.UpdateCenter.xml文件。将里面的url改为https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

非Docker端可以先不配置镜像，一会直接通过页面配置

image-20240311162849418

image-20240311162519763

创建用户

这个账号相当于管理员账户，创建完成后后面URL一般也不需要改动

image-20240311163706839

下面是配置Java与Maven，我们需要用到tools和plugins这两个模块

image-20240311163854811

配置Maven

首先点击plugins，继续点击Available plugins，输入maven，下载Maven Integration，安装完成后我们

image-20240311164026093

接着我们回到管理页面点击tools

Docker版配置

如果是Docker安装的话，我们直接在Jenkins容器内新装一个maven。翻到最底下找到Maven，新增Maven，输入Maven的名字和版本，选择版本最好跟本地一致，然后点击保存

image-20240311164542834

Linux与Mac配置

一般mac与linux本机都已经安装完成maven了，如果没有安装请自行安装；安装完成后配置一下别名和路径即可

image-20240313100833460

之后翻到最顶上，配置一下使用的maven配置文件，路径为setting.xml的地址，这样就可以使用本地的仓库

image-20240313100928792

配置Java

Docker版配置

在同一个页面找到JDK安装部分，因为我下载的jenkins内置jdk17，所以直接进入jenkins容器内查看Java所在的目录

进入容器可以使用：docker exec -it c7c（容器id前3位） bash

image-20240311165659880

配置别名，将路径输入，取消自动安装安装，点击保存

image-20240311165748076

Linux与Mac配置

在同一个页面找到JDK安装部分，与maven一样，我们本机大概率是已经安装好Java的，同样只需配置一下别名和路径

image-20240313101056470

页面上配置Jenkins下载源

除了通过该文件，我们也可以在插件管理中直接配置

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

image-20240313134732638

Jenkins使用

Maven项目自动化构建

  1. 在主页面点击新建任务，选择构建一个maven项目，输入任务名称image-20240312091326780

  2. 下面我们输入这个任务的描述、最好选择丢弃旧的构建，在下面选择对应的策略，这里我选择的是只保留最近的3次构建，方便发生意外后直接回滚

image-20240312091601261

  1. 下面我们来配置项目的Git地址，首先需要添加一个Git用户

    image-20240312091844841

以GitHub举例，像这样添加一个用户，用户名和密码就是你登陆GitHub的账号和密码

image-20240312092050180

继续输入我们的Git地址以及所需要构建的分支

image-20240312094410900

  1. 下面是构建的参数，这里的意思为执行clean package，清除再打包，跳过test阶段

    image-20240312095013918

  2. 最后需要配置构建完成后的操作，一般是通过执行shell脚本，将刚刚构建完成的项目跑起来并记录日志

image-20240312133619142

  1. 脚本完成后我们点击保存并进行手动构建，尝试执行一次

boot项目通用shell脚本

boot脚本需要配置如下5个地方，通过序号对应

1：LOG_DIR与LOG_FILE，前者为日志所需要存储的路径，后者为日志文件名

3：将buildSoraProject改为jenkins的任务名称，这里我的任务名称即为buildSoraProject

4：配置jar包的名字，如果不知道jar包的名字，可以通过进入容器内该路径查看，或者直接在pom文件的build标签内提前指定好

image-20240312134300799

6：配置buildId，只要唯一即可，一般为任务名称

7：目前只配置了字符集与时间，可以根据需求自己追加，例如常用的-Dspring.profiles.active=test

shell脚本：

#!/bin/bash

# 1.定义日志目录和日志文件的路径
LOG_DIR="$JENKINS_HOME/projectLog/buildSoraProject"
LOG_FILE="$LOG_DIR/sora_project_log.log"

# 2.确保日志目录存在，如果不存在则创建
mkdir -p $LOG_DIR

# 3.进入 Jenkins 的 workspace 目录下的 buildSoraProject/target 文件夹
cd $JENKINS_HOME/workspace/buildSoraProject/target

# 4.配置 jar包名称 sora33-0.0.1-SNAPSHOT.jar
JAR_FILE=sora33-project.jar

# 5.尝试停止已运行的 JAR 文件进程
PID=$(ps -ef | grep $JAR_FILE | awk '{print $2}')
if [ ! -z "$PID" ]; then
  echo "Stopping existing Java process: $PID"
  kill -9 $PID
fi

# 6.分配打包id
BUILD_ID=buildSoraProject

# 7.执行 jar 包 将日志输出到之前定义的日志文件中 如果时间异常再追加GMT+8，第一次可以先注释
nohup java -Dfile.encoding=UTF-8 \
		-Duser.timezone=GMT+08 \
     -jar $JAR_FILE > $LOG_FILE 2>&1 &

echo "Application is running, and logs are being written to $LOG_FILE"

cloud项目通用shell脚本

cloud脚本需要配置如下4个地方，通过序号对应

1：LOG_DIR_BASE 配置日志的路径，这里我放在Jenkins的工作目录下的projectLog文件夹里

2：打包id，这里请务必将打包id与任务名称对应上，因为Jenkins会把该任务的结果输出在任务名称下的文件夹里

3：服务列表定义，这里需要配置项目所有的启动类，如下图是我的项目结构，可以参考shell脚本的格式对应你自己的项目结构

image-20240313112208745

6：配置Java模块的启动命令，目前只配置了字符集与时间，可以根据需求自己追加，例如常用的-Dspring.profiles.active=test

#!/bin/bash

# 1.定义日志目录的基本路径
LOG_DIR_BASE="$JENKINS_HOME/projectLog"

# 2. 打包id
BUILD_ID=sora

# 3.服务列表定义
SERVICES=("sora-gateway" "sora-auth" "sora-modules/sora-user/user-server" "sora-modules/sora-system/system-server" "sora-modules/sora-system/spider-server")

# 4.停止所有服务
for SERVICE in ${SERVICES[@]}; do
  JAR_FILE=$(find $JENKINS_HOME/workspace/$BUILD_ID/$SERVICE/target -name "*.jar" -print -quit) # 假设每个服务目录下只有一个jar包
  if [[ ! -z "$JAR_FILE" ]]; then
    PID=$(ps -ef | grep $JAR_FILE | grep -v grep | awk '{print $2}')
    if [[ ! -z "$PID" ]]; then
      echo "Stopping $SERVICE (PID: $PID)"
      kill -9 $PID
    fi
  fi
done

# 5.启动所有服务
for SERVICE in ${SERVICES[@]}; do
  JAR_FILE=$(find $JENKINS_HOME/workspace/$BUILD_ID/$SERVICE/target -name "*.jar" -print -quit) # 假设每个服务目录下只有一个jar包
  if [[ ! -z "$JAR_FILE" ]]; then
    # 为每个服务创建一个专门的日志目录
    LOG_DIR="$LOG_DIR_BASE/$(basename $SERVICE)"
    mkdir -p $LOG_DIR
    LOG_FILE="$LOG_DIR/$(basename $SERVICE)_log.log"
    
    # 6.Java启动命令行配置 
  nohup java -Dfile.encoding=UTF-8 -Duser.timezone=GMT+08 \
    -jar $JAR_FILE > $LOG_FILE 2>&1 &
    
    echo "$SERVICE is running, logs are being written to $LOG_FILE"
  else
    echo "Jar file for $SERVICE not found."
  fi
done

配置Aliyun的maven镜像源（Docker版）

PS：非Docker安装如果没有配置aliyun仓库地址，把下面的仓库地址加入到maven的conf目录下的settings的mirrors标签内即可。

因为Docker的maven还没配置aliyun仓库地址，并且是第一次使用maven，会在jenkins_home下生成一个tools文件夹，我们可以到挂载的data文件夹下查看，这里我们需要在maven内加入aliyun的仓库地址，具体路径为你挂载的路径/tools/hudson.tasks.Maven_MavenInstallation/Maven-3.9.1/conf

修改settings.xml文件夹，将aliyun的仓库地址配置到mirrors标签内

<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>

结果测试

Docker

以boot项目举例，打包完成后我们可以在挂载目录中看到项目的日志输出，那我们要如何访问到项目呢？

image-20240313132900782

因为我们启动jenkins容器时只指定了Jenkins的端口并没有把Jenkins内部的项目端口暴露出来，所以我们需要删除Jenkins容器，再次创建，这次加上我们的项目端口，注意因为我们删除的只是容器，挂载的data文件夹并没有删除，所以Jenkins的数据缓存还会留在我们宿主机上，当我们再次安装Jenkins时，历史数据都还在，所以千万注意不要删除挂载的目录！！

# 删除容器
docker rm -rf 容器id/容器名

修改我们的安装脚本，这次多暴露一个项目的端口1234

docker run -d \
-p 8081:8080 \
-p 1234:1234 \
-u 0 \
-v /Users/sora33/docker/jenkins/data:/var/jenkins_home \
--restart=always \
--name jenkins \
jenkins/jenkins:2.448-jdk17

# 再次启动安装脚本
./startJenkins.sh

通过查看1234端口，可以发现是docker在占用

image-20240313132628391

调用接口也可以正常返回

image-20240313132645759

非Docker

如果我们直接在宿主机部署项目，那么我们直接访问接口就可以。

直接放个日志图，项目启动成功并且接口也成功访问到

image-20240313133515417

结束语

Jenkins的初步用法到这里就结束了，当然Jenkins也还有非常多的用法，大家也可以摸索一下，如果在搭建过程中遇到问题也欢迎留言，如果觉得有用可以分享给他人～

更多知识请移步个人博客：33sora.com

Sora33
关注
（CICD）自动化构建打包、部署(Jenkins + maven+ gitlab+tomcat)
weixin_50382197的博客
05-21 6266
在本文档中，我们将概述持续集成，持续交付和持续部署的概念，以及GitLab CI / CD的介绍。软件开发的连续方法基于自动执行脚本，以最大限度地减少在开发应用程序时引入错误的可能性。从新代码的开发到部署，它们需要较少的人为干预甚至根本不需要干预。它涉及在每次小迭代中不断构建，测试和部署代码更改，从而减少基于有缺陷或失败的先前版本开发新代码的机会。这种方法有三种主要方法，每种方法都根据最适合您的策略进行应用。Devops持续集成。
【CI/CD】容器自动化构建部署
weixin_52418790的博客
07-25 1781
GitLab CI/CD、GitHub Actions、Gitea Actions等自动化执行某些操作（打包测试、部署、数据库版本控制的验证等），设置触发时机，每次PR时都会触发，便于提前暴露问题，提高效率等
GitLab CI/CD实现项目自动化部署
new9232的博客
07-07 4396
GitLab CI/CD 是 GitLab 中集成的一套用于软件开发的持续集成、持续交付和持续部署工具。这套系统允许开发团队自动化软件交付流程，从代码变更的检测、构建、测试到最终部署到生产环境的整个过程。
使用jenkins进行自动化部署
qq_43807473的博客
07-16 3633
Jenkins是一个开源的持续集成（CI）和持续交付（CD）工具，主要用于自动化软件开发的各个阶段，包括构建、测试、部署等。Jenkins基于Java开发，支持与多种版本控制系统（如Git、SVN）、构建工具（如Maven、Ant、Gradle）和软件配置管理工具的集成。它提供了一个友好的操作界面，允许开发者通过Web界面进行配置和管理，支持自动化构建和测试过程，能够监控外部任务的运行。Jenkins也支持持续集成和持续交付的理念，有助于提高软件开发的效率和减少人工错误。
Jenkins教程(自动化部署)
weixin_39655220的博客
03-28 1810
因为开发部门同时维护多个版本，多个版本的发布，测试需要大量人力，所以要有一个专业的持续集成工具来管理持续重复的工作。个人理解，说白了就是把代码测试、打包、发布等工作交给一些工具来自动完成。这样可以提高效率，减少失误，开发人员只需要关心开发和提交代码到。
作为前端 leader，我是如何快速搭建CICD自动化部署的
xiangzhihong8的专栏
07-05 2789
假设你入职了一家小公司，既没有内部自研的 DevOps 平台，也没有专业的运维。需要你自己去搭建多环境 CI/CD 自动化部署，你会怎么做？你可能需要综合考虑成本、服务器选择、CI/CD易用度、可扩展等方面，对于不怎么熟悉 CI/CD 相关的小伙伴来说有点难以选择。这里先给大家介绍两个可以免费使用的 CICD 平台：阿里云效 和 Github Actions。通过给一个 vitepress 静态站点 和一个 koa.js + mongodb 接口服务搭建多环境、多版本自动化部署，来熟悉具体使用方法。
CI/CD—Jenkins配置一次完整的jar自动化发布流程
dghfttgv的博客
03-10 1300
要创建自动化发布，需要准备一台测试服务器提前安装好java运行所需的环境，JDK版本最好和Windows开发机器上的版本一致，在Jenkins上配置将构建好的jar上传到测试服务器上，测试服务器自动启动构建好的jar，这些步骤只需要在Jenkins完成相关的配置即可。
分享一个CI/CD的自动部署想法
Zachary的博客
03-04 936
这里是Z哥的个人公众号每周五11：45 按时送达当然了，也会时不时加个餐～我的第「221」篇原创敬上大家好，我是Z哥。最近工作中正好在设计一个方案，以支持 CD 环节的第一个部署节点可以完...
GitLab CI/CD 自动化部署
weixin_43239411的博客
03-28 1042
示例基于 FastAPI 应用部署到服务器，并集成 HTTPS 负载均衡环境。：确保服务器已安装 Docker 并允许远程管理。自动化部署的完整配置方案，涵盖。推送镜像到 Registry。在 GitLab 仓库设置。，配置 SSH 密钥认证和。SSH 连接服务器更新容器。构建 Docker 镜像。GitLab 代码仓库。
使用jenkins自动化部署项目
羊羊羊
12-23 519
jenkins安装并运行 jenkins安装运行参照jenkins官方网站 系统管理 全局工具配置 JDK 点击新增JDK按钮，取消勾选自动安装，输入JDK别名(别名随便起)和JAVA_HOME，如下图 Maven 点击新增Maven按钮，取消勾选自动安装，输入Name和MAVEN_HOME(Maven安装目录)，如下图 Git 点击新增Git按钮，取消勾选自动安装，输入Name和Path t...
Jenkins自动化部署
Kodak
07-31 7064
Linux超详细安装部署Jenkins
自动化部署
06-06
大中小微企业自动化部署工具，可以持续发布，支持大规模生产环境部署，如有问题（如果出现已过期）可访问此链接 http://www.yunjubian.com/autoDeploy.html 联系我们免费升级
Jenkins与Gitlab自动化部署CI/CD
04-20
在DevOps的众多实践之中，CI/CD（持续集成/持续部署和持续交付）是核心组成部分，而Jenkins与Gitlab的自动化部署则是实现CI/CD的关键技术。 首先，DevOps的核心在于构建一个能够快速响应市场变化的组织结构。它要求...
持续集成/持续部署CI/CD实战：Jenkins与GitLab CI
最新发布
shejizuopin的博客
03-29 524
持续集成（CI）开发人员频繁地将代码集成到主干分支。每次集成都触发自动化构建和测试，以尽早发现和修复错误。持续部署（CD）在CI的基础上，自动将通过测试的代码部署到生产环境，使软件能够快速交付给用户。Jenkins开源的自动化服务器，广泛用于实现CI/CD。支持多种操作系统和平台，拥有丰富的插件生态系统。GitLab CIGitLab内置的CI/CD工具，提供了从代码管理到部署的一体化解决方案。与GitLab无缝集成，支持代码管理、问题跟踪和CI/CD。
使用 Jenkins 实现持续集成和持续部署（CI/CD）
linux
07-21 1364
在现代软件开发中，持续集成（Continuous Integration, CI）和持续部署（Continuous Deployment, CD）是关键的实践，能够显著提高团队的效率和代码交付的质量。本文将详细介绍如何利用 Jenkins 工具来实现完整的 CI/CD 流水线，帮助开发团队实现自动化的构建、测试和部署过程。什么是 Jenkins？Jenkins 是一个开源的持续集成和持续部署工具，具有广泛的插件支持和灵活的配置选项，适用于各种不同的软件项目和环境。安装 Jenkins。
微服务CI/CD实践（五）Jenkins & Docker 自动化构建部署Java微服务
lbmydream的博客
09-06 1927
pipeline {agent anystages {stage('获取代码') {steps {checkout([]]])stage('替换') {steps {stage('打包') {steps {steps {$(dockerpipeline {agent anystage('获取代码') {steps {
CI/CD之Jenkins用于Linux系统的部署方式汇总
Young_深情不及里子的博客
08-25 1180
在当今快节奏的软件开发世界中，持续集成（Continuous Integration, CI）与持续交付（Continuous Delivery, CD）已成为确保软件质量和加速交付周期的关键实践。CI/CD不仅仅是一种技术实现，更是一种文化转变，它要求开发团队不断迭代、持续测试，并自动化整个软件交付流程。本文将深入探讨CI/CD的定义、核心原则，并对当前广泛应用于CI/CD的部署工具Jenkins及其常见的部署方式进行总结。
GITLAB CI/CD 自动化部署
weixin_41565755的博客
10-19 554
1、概念
"Jenkins与Gitlab实现自动化部署CI/CD，加速DevOps实践
Jenkins与Gitlab自动化部署CI/CD（持续集成/持续部署）是DevOps（开发人员和运维人员协同工作、自动化软件交付流程和工具的一种文化和运动）中的重要组成部分。通过结合使用Jenkins和Gitlab，开发团队能够实现更高效...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值