centos7系统使用docker-compose安装部署jenkins

NEIL_XU_2024-06-22 19:33

CentOS7系统使用docker-compose安装部署jenkins，并实现前后端自动构建

记录一次工作中部署jenkins的真实经历，总结了相关经验

1.准备环境

1.java

由于最新的jenkins需要jdk11以上才能支持，而系统里的jdk是1.8的，因此等jenkins安装好后使用jenkins容器里自带的jdk17

2.maven

centos7安装maven，步骤：

1.下载 apache-maven-3.6.3-bin.tar.gz

2.解压

3.配置环境变量

vim /etc/profile

4.刷新配置文件

source /etc/profile

5.验证

mvn -v

3.node

centos7 使用nvm 下载16以上版本的node可能会遇到如下的报错

这里直接采用jenkins自动安装node 18

2.准备docker-compose.yml文件

yml 复制代码 
version : '3'
services:
  jenkins:
    user: root
    restart: always
    image: jenkins/jenkins
    container_name: jenkins
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "10240:8080"
      - "10241:50000"

    expose:
      - "8080"
      - "50000"
    volumes:
      - /data/jenkins/jenkins_home/:/var/jenkins_home/
      - /data/nginx/html/:/data/nginx/html/
      - /data/nginx/htmldev/:/data/nginx/htmldev/
      - /var/run/docker.sock:/var/run/docker.sock
      - /usr/bin/docker:/usr/bin/docker
      - /data/maven/apache-maven-3.6.3:/data/maven/apache-maven-3.6.3
      - /root/.ssh:/root/.ssh
  1. /var/jenkins_home/ 这个是容器里默认的jenkins工作目录，需要挂载出来
  2. /data/nginx/html/和/data/nginx/htmldev/ 分别对应后面前端项目pc端、移动端的dist存放目录，配置于nginx中，挂载出来是由于jenkins配置前端构建的时候需要配置nginx目录
  3. maven挂载刚刚安装的maven

3.执行docker-compose

shell 复制代码 
# 跳转到docker-compose.yml文件目录
cd /data/jenkins

ll

#执行
docker-compose up -d

#查看运行状态
docker ps

4.初始化jenkins

  1. 访问 ip:10240 jenkins后台

    查找初始密码

  2. 安装插件

    选择安装推荐的插件，这里如果安装失败，后续再手动切换源，安装必要的插件即可

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

参考：
docker安装jenkins并配置国内插件镜像地址_jenkins国内镜像-CSDN博客
Jenkins必备安装插件 - 知乎 (zhihu.com)

  1. 创建管理员账号

    一直下一步

  1. 切换中文（此时还有部分界面是英文）

​ 安装locale插件即可

参考：
【jenkins】教你jenkins设置为中文_jenkins 中文插件，2024年最新这操作真香_jenkins设置中文-CSDN博客

5.系统配置

  1. 凭据管理

    添加全局凭据

    1. git账号密码（拉取代码）

    2. gitlab token（用于监听git，自动构建）

      安装gitlab插件

      去gitlab生成token，复制

      添加gitlab api token凭证

  2. 全局工具配置

    1. JDK

      使用jenkins容器自带jdk17

    2. maven

      使用本地安装的maven，刚刚已经挂载

    3. nodejs

      安装nodejs插件

      勾选自动安装，node版本选择18

  3. 系统配置

    1. 远程部署配置

      安装远程部署插件

      配置publish over ssh - SSH Servers

      1. 远程部署客户测试环境

      2. 远程部署公司开发环境

    2. gitlab连接配置

6.新建构建任务

1.后端（含备份、回滚）

1.本机部署

举例：构建测试服务器（本地），从git的develop分支拉取代码

  1. 选择自由风格

  2. 设置保留构建历史数量

  3. 配置参数化构建，为了实现回滚

  4. 配置源码管理

  5. 构建环境

  6. 增加构建步骤

    maven

    备份

    shell 复制代码 
    #!/bin/bash 
case $Status  in
  deploy)
    echo "Status:$Status"
    path="${WORKSPACE}/csms-admin/bak/${BUILD_NUMBER}"      #创建每次要备份的目录
    if [ -d $path ];
    then
        echo "The files is already  exists "
    else
        mkdir -p  $path
    fi
    \cp -f ${WORKSPACE}/csms-admin/target/*.jar $path        #将打包好的jar包备份到相应目录,覆盖已存在的目标
    echo "bak ------------ Completing!"
    ;;
  rollback)
      echo "Status:$Status"
      echo "Version:$Version"
      echo "BUILD_NUMBER:$BUILD_NUMBER"
      v=$Version
      if [ $Version -eq 0 ]; then
        v=$(($BUILD_NUMBER - 2))  # 如果 $Version 是 0，则赋值为 $BUILD_NUMBER - 2
      fi
      echo "回滚到版本--v:${v}"
      cd ${WORKSPACE}/csms-admin/bak/${v}            #进入备份目录
      \cp -f *.jar ${WORKSPACE}/csms-admin/target/       #将备份拷贝到程序打包目录中，并覆盖之前的jar包
      ;;
  *)
  exit
      ;;
esac

    构建新docker镜像并启动

    shell 复制代码 
    cd ${WORKSPACE}
docker stop csms-admin || true
docker rm csms-admin || true
docker rmi csms-admin || true
docker build --build-arg profileActive=test --build-arg port=8889 -t csms-admin .
docker run -d -p 192.168.100.53:8889:8889 --name csms-admin csms-admin

    保留10个版本，删除以前的备份

    shell 复制代码 
    #!/bin/bash
#rm_file>14day
ReservedNum=10                      #保留文件数量
rm_file_dir=${WORKSPACE}/csms-admin/bak  #需要删除文件的路径

cd $rm_file_dir    #进入文件夹
RootDir=$(pwd) #当前文件路径
FileNum=$(ls -l | grep '^d' | wc -l)    #查找文件夹数量
OldFile=$(ls -rt | head -1)         #找出最早文件夹
if [ $RootDir == $rm_file_dir ];then   #判断所在目录是否正确
    echo $RootDir                             
    echo $rm_file_dir
    while (($FileNum>$ReservedNum))  #文件数超过设置变量才执行
    do
    echo "Delete File:"$RootDir'/'$OldFile   #打印要删除的文件名称
    rm -rf $RootDir'/'$OldFile                       #删除文件
    let "FileNum--"                                      #变量自减操作
    OldFile=$(ls -rt | head -1)         #更新dmp最早文件
    done
else
    echo "error file path "                         #所在目录不对打印出路径错误
fi

  7. 构建触发器

    配置gitlab监听，自动构建

    打开gitlab

    将

    分别粘贴到gitlab-设置-集成

  8. 测试

    git push自动触发jenkins构建

    查看控制台

    查看docker容器运行状态

    shell 复制代码 
    docker ps

    后端启动成功

2.远程部署

举例：构建开发服务器（另一台服务器），采用在本机打包、备份，然后通过ssh连接远程开发服务器，传送jar包并执行的方式

  1. 复制一个构建任务

  2. 修改所有的profile环境，注释docker步骤

  3. git触发器配置

    （同上）

  4. 增加Send files or execute commands over SSH 步骤

    shell 复制代码 
    #!/bin/bash

JAR_HOME='/data/jenkins/jenkins_home/workspace/csms-dev-develop/csms-admin/target'
WEB_HOME='/data/csms/csms-admin'

#停止原来的服务
ps -ef | grep csms-admin | grep -v grep | awk '{print $2}' | xargs kill -9

#替换原来的jar包
cd ${JAR_HOME}
mv csms-admin-dev.jar csms-admin.jar
cp -f csms-admin.jar ${WEB_HOME}

#重启服务
cd ${WEB_HOME}
nohup sh startup.sh &

    startup.sh

    sh 复制代码 
    #!/bin/bash
#1，获取myjar的进程号
PID=$(ps -ef|grep csms-admin| grep -v grep | awk '{print $2}')
#2，启动myjar的函数
start(){
        nohup /data/java/jdk1.8.0_321/bin/java -Dspring.profiles.active=dev -jar -Xms1024m -Xms2048m csms-admin.jar &
}
#3，判断1中获取的PID是否存在，即判断myjar有没有启动
 if [ -z "$PID" ]
then
#4，日志
    echo "Start the csms-admin directly "
#5,myjar之前没有启动的话,这里直接调用start函数
    start
else
#6,myjar之前启动过且进程依然存活，则kill掉，然后调用start函数
    echo "kill the existing csms-admin process firstly."
    kill -9 $PID
    echo " $PID has been killed"
    start
fi

2.前端

由于nginx部署在开发服务器（非jenkins所在服务器），所以前端部署都为远程部署

1.PC端远程部署

  1. 自由风格

    同上

  2. 丢弃旧的构建

    同上

  3. 源码管理

    同上

  4. 构建触发器

    同上

  5. 构建环境

  6. 构建步骤

    shell 复制代码 
    npm install
rm -rf ${WORKSPACE}/dist
npm run build:dev
#本机部署则去掉下面的ssh步骤，这里加上下面的语句
#rm -rf /data/csms/csms-web/html
#mkdir -p /data/csms/csms-web/html
#cp -rf ${WORKSPACE}/dist /data/csms/csms-web/html

  7. 增加Send files or execute commands over SSH 步骤

    shell 复制代码 
    #!/bin/bash

DIST_HOME='/data/jenkins/jenkins_home/workspace/csms-vue-test-dev-pc'
HTML_HOME='/data/csms/csms-web/test/html'

#覆盖原来的dist
cp -rf ${DIST_HOME}/dist/* ${HTML_HOME}/dist
2.移动端远程部署

  1. 构建步骤

  2. ssh

    shell 复制代码 
    #!/bin/bash

DIST_HOME='/data/jenkins/jenkins_home/workspace/csms-vue-test-dev'
HTML_HOME='/data/csms/csms-app/test/html'

#覆盖原来的dist
cp -rf ${DIST_HOME}/mobiled_dist/* ${HTML_HOME}/mobiled_dist

  3. 其他步骤同PC

7.在jenkins上编写maven的setting文件

有的时候需要临时改下maven的setting文件，或者想编写多份setting文件给不同的构建任务去使用，可以在jenkins上直接进行配置

  1. 添加配置文件

参考：
PS：这里没有这个选项的，需要下载插件Jenkins 配置文件管理插件 Config File Provider_jenkins config file provider-CSDN博客

  1. 全局配置

  2. 到构建任务里配置

8.后端项目Dockerfile示例

本文的后端项目对应的Dockerfile，可参考使用，一般放在项目的根目录下

dockerfile 复制代码 
# 基础镜像
FROM openjdk:8-jre

# 维护者信息
MAINTAINER asus

ENV LANG=zh_CN.UTF8
ENV LC_ALL=zh_CN.UTF8

# 设置容器时区为当前时区
RUN /bin/cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \&& echo 'Asia/Shanghai' >/etc/timezone

# /tmp 目录作为容器数据卷目录，SpringBoot内嵌Tomcat容器默认使用/tmp作为工作目录，任何向 /tmp 中写入的信息不会记录进容器存储层
# 在宿主机的/var/lib/docker目录下创建一个临时文件并把它链接到容器中的/tmp目录
VOLUME /tmp

# 复制主机文件至镜像内，复制的目录需放置在 Dockerfile 文件同级目录下
ADD csms-admin/target/csms-admin-*.jar csms.jar

# 动态参数
ARG profileActive=dev
ENV profileActive ${profileActive}

ARG port=8881
ENV port ${port}

# 容器启动执行命令
ENTRYPOINT ["java", "-Xms256M","-Xmx1224M","-Xmn256M","-Xss256K","-Duser.timezone=GMT+8", "-Djava.security.egd=file:/dev/./urandom", "-Dspring.profiles.active=${profileActive}", "-jar", "/csms.jar"]

# 声明容器提供服务端口
EXPOSE ${port}

PS：上面展示的自动构建是每次都删除原来的镜像和容器，重新构建镜像，其实也可以Dockerfile里不ADD jar包，然后将容器里放jar包的目录在 run 这个镜像容器的时候挂载出来，这样只需要构建一次镜像，创建一次容器，后面jar包更新了，只需要重启容器即可。

9.Jenkins新增用户并根据项目分配权限

参考：

jenkins增加用户,并配置权限,保姆式教学_jenkins创建用户并添加权限-CSDN博客

Jenkins---jenkins新增用户且配置权限-CSDN博客

10.踩坑记录

1.由于lombok版本过低导致Maven编译失败

在构建任务中，jdk指定的是jenkins里自带的jdk17，项目中maven编译指定的jdk是1.8，这里是下图报错的根本原因，但是之前其他构建任务也是这样配置的，还是正常编译，最终在网上查询相关博客，改了lombok版本才得以解决

参考：项目install的时候报错"module jdk.compiler does not "opens com.sun.tools.javac.processing" to unnamed modul

修改lombok版本为最新版本（能支持jdk17）

相关推荐
昭阳~6 分钟前
Kubernetes 高级调度特性
云原生·容器·kubernetes
Otaku love travel34 分钟前
实施运维文档
运维·windows·python
basketball6161 小时前
Linux C 管道文件操作
linux·运维·c语言
浩浩测试一下1 小时前
Windows 与 Linux 内核安全及 Metasploit/LinEnum 在渗透测试中的综合应用
linux·运维·windows·web安全·网络安全·系统安全·安全架构
将心ONE2 小时前
使用 lstrip() 和 rstrip() 方法
运维·服务器
G_whang3 小时前
centos7 安装jenkins
运维·jenkins
Jiangnan_Cai3 小时前
Linux 系统 docker 部署 Dify
linux·docker·大模型·dify
LuckyLay3 小时前
使用 Docker 搭建 Rust Web 应用开发环境——AI教你学Docker
前端·docker·rust
言之。3 小时前
借助ssh实现web服务的安全验证
运维·安全·ssh
Two_brushes.4 小时前
【linux网络】深入理解 TCP/UDP：从基础端口号到可靠传输机制全解析
linux·运维·服务器
热门推荐
01【无标题】02集群聊天服务器---MySQL数据库的建立03Coze扣子平台完整体验和实践（附国内和国际版对比）04Java类变量（静态变量）05KGG转MP3工具|非KGM文件|解密音频06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07使用Ruby接入实时行情API教程08Java学习第十五部分——MyBatis09DeepSeek各版本说明与优缺点分析10绿色建筑新态势：楼宇自控助力能效提升，推动成本优化新路径