jenkins

Jenkins，原名 Hudson，2011 年改为现在的名字。它是一个开源的实现持续集成的软件工具。

官方网站

https://www.jenkins.io/

01-安装部署

jenkins 服务

gitlab 服务

测试服务器环境

1-gitLab

在ssh下安装

官方安装文档：https://gitlab.cn/install/?version=ce

1 安装依赖

sudo yum install -y curl policycoreutils-python openssh-server perl
sudo systemctl enable sshd
sudo systemctl start sshd

2 配置镜像

curl -fsSL https://packages.gitlab.cn/repository/raw/scripts/setup.sh | /bin/bash

3 开始安装

sudo EXTERNAL_URL="http://192.168.44.103" yum install -y gitlab-jh

除非您在安装过程中指定了自定义密码，否则将随机生成一个密码并存储在 /etc/gitlab/initial_root_password 文件中(出于安全原因，24 小时后，此文件会被第一次 gitlab-ctl reconfigure 自动删除，因此若使用随机密码登录，建议安装成功初始登录成功之后，立即修改初始密码）。使用此密码和用户名 root 登录。

gitlab常用命令

gitlab-ctl start                  # 启动所有 gitlab 组件；
gitlab-ctl stop                   # 停止所有 gitlab 组件；
gitlab-ctl restart                # 重启所有 gitlab 组件；
gitlab-ctl status                 # 查看服务状态；
gitlab-ctl reconfigure            # 启动服务；
vi /etc/gitlab/gitlab.rb         # 修改默认的配置文件；
gitlab-ctl tail                   # 查看日志；

在docker下安装

https://docs.gitlab.cn/jh/install/docker.html

安装所需最小配置

内存至少4G
系统内核至少在3.10以上 uname -r 命令可查看系统内核版本

安装docker

更新yum源

yum update

安装依赖

yum install -y yum-utils device-mapper-persistent-data lvm2

添加镜像

//国外镜像
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
//阿里镜像
https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

查看源中可使用版本

 yum list docker-ce --showduplicates | sort -r

安装指定版本

yum install docker

配置开机启动项

systemctl start docker
systemctl enable docker
docker version

使用容器安装gitlab

1.添加容器

docker run --detach \
  --hostname 192.168.44.103 \
  --publish 443:443 --publish 80:80 \
  --name gitlab \
  --restart always \
  --volume $GITLAB_HOME/config:/etc/gitlab:Z \
  --volume $GITLAB_HOME/logs:/var/log/gitlab:Z \
  --volume $GITLAB_HOME/data:/var/opt/gitlab:Z \
  --shm-size 256m \
  registry.gitlab.cn/omnibus/gitlab-jh:latest

2.启动容器

docker start gitlab

3.查看已存在的容器

docker ps -a

4.进入容器

docker exec -it  gitlab /bin/bash

访问

http://192.168.44.103

当首次运行出现502错误的时候排查两个原因

虚拟机内存至少需要4g
稍微再等等刷新一下可能就好了

管理员账号登录

用户名：root

密码存在下面文件中，登录后需要改密码不然24小时之后会失效

cat /etc/gitlab/initial_root_password

2-jenkins

官方文档介绍非常详细

https://www.jenkins.io

安装需求

机器要求：

256 MB 内存，建议大于 512 MB

10 GB 的硬盘空间（用于 Jenkins 和 Docker 镜像）

需要安装以下软件：

Java 8 ( JRE 或者 JDK 都可以)

Docker （导航到网站顶部的Get Docker链接以访问适合您平台的Docker下载）

安装JDK

1 检索可用包

yum search java|grep jdk

2 安装

yum install java-1.8.0-openjdk

首次启动war包会在/root/.jenkins生成配置文件

待完全启动成功后访问服务器8080端口完成配置

初始化后的密码：

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

4e67bbe261da476abdc63c5b51311646

This may also be found at: /root/.jenkins/secrets/initialAdminPassword

密码文件使用后会自动删除

Maven安装

官网

https://maven.apache.org/

下载后复制到Jenkins所在服务器解压缩即可

3-测试服务器

java 项目，测试环境，保证可以运行 java 程序，根据测试需要添加需要的框架，用例

02-Jenkins + Git + Maven 自动化部署配置

在 jenkins 中安装 maven 插件

1 jenkins上 Git配置

2 jenkins上 Maven配置

3 jenkins上 Pom.xml配置

git安装

yum install -y git

javahome配置(可选)

/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.322.b06-1.el7_9.x86_64


export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.322.b06-1.el7_9.x86_64
export JRE_HOME=$JAVA_HOME/jre
PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin
export JAVA_HOME JRE_HOME CLASS_PATH PATH

jdk
/etc/alternatives/jre_openjdk
source /etc/profile 立即生效

报错找不到jdk？

默认yum安装java的时候会显示安装的是openjdk1.8 实则实际上只安装了jre
yum install -y java-devel

Maven阿里云镜像

修改/usr/local/maven/conf/settings.xml

4 自动发布到测试服务器并自动运行

jenkins 安装相关插件

publish over ssh 配置

1 安装插件

在Configure System菜单里往下来

2 添加一台目标服务器

3 修改配置

超时机制

输出命令时一定要注意不要让窗口卡主，不然Jenkins会认为认为一直没完成

shell的日志输出

nohup java -jar /root/xxoo/demo*.jar >mylog.log 2>&1 &

数据流重定向

数据流重定向就是将某个命令执行后应该要出现在屏幕上的数据传输到其他地方

标准输入（stdin）：代码为0，使用<或<<;
标准输出（stdout）：代码为1，使用>或>>;
标准错误输出（stderr）：代码为2，使用2>或2>>

> 覆盖写
>> 追加写

在 build 之前和之后执行一些操作 pre steps 和 post steps

运行前清理

配置杀死之前运行的进程

#!/bin/bash

#删除历史数据
rm -rf xxoo

appname=$1
#获取传入的参数
echo "arg:$1"


#获取正在运行的jar包pid
pid=`ps -ef | grep $1 | grep 'java -jar' | awk '{printf $2}'`

echo $pid

#如果pid为空，提示一下，否则，执行kill命令
if [ -z $pid ];
#使用-z 做空值判断
        then
                echo "$appname not started"

        else
               kill -9 $pid
                echo "$appname stoping...."

check=`ps -ef | grep -w $pid | grep java`
if [ -z $check ];

        then
                echo "$appname pid:$pid is stop"
        else
                echo "$appname stop failed"

fi


fi

04- gitlab钩子自动构建项目

代码改动自动可以使用gitlab的webhook回调钩子调起Jenkins的启动任务接口

在构建触发器中配置接口和token

不同的浏览器登录时，会需要登录，无法直接触发任务

解决方法,

安装权限相关插件

05- 几种常见的构建触发器

快照依赖构建/Build whenever a SNAPSHOT dependency is built
- 当依赖的快照被构建时执行本job
触发远程构建 (例如,使用脚本)
- 远程调用本job的restapi时执行本job
job依赖构建/Build after other projects are built
- 当依赖的job被构建时执行本job
定时构建/Build periodically
- 使用cron表达式定时构建本job
向GitHub提交代码时触发Jenkins自动构建/GitHub hook trigger for GITScm polling
- Github-WebHook出发时构建本job
定期检查代码变更/Poll SCM
- 使用cron表达式定时检查代码变更，变更后构建本job

06- 定时执行任务 jenkins cron 表达式

Jenkins cron表达式

标准cron

https://crontab.guru

Jenkins cron不是标准的cron表达式

第一个 * 表示每个小时的第几分钟，取值0~59

H * * * *
H：每小时执行一次

第二颗 * 表示小时，取值0~23

* 15 * * * 表示每天下午3点
* 1 * * *  表示每天凌晨1点

第三颗 * 表示一个月的第几天，取值1~31
* 1 5 * *  表示每月5日凌晨1点

第四颗 * 表示第几月，取值1~12
* 15 5 1 *  表示每年几月执行

第五颗 * 表示一周中的第几天，取值0~7，其中0和7代表的都是周日

“/”

表示每隔多长时间，比如 */10 * * * * 表示每隔10分钟

“H”

hash散列值，以job名取值，获取到以job名为入参的唯一值，相同名称值也相同，这个偏移量会和实际时间相加，获得一个真实的运行时间

意义在于：不同的项目在不同的时间运行，即使配置的值是一样的，比如都是15 * * * * ，表示每个小时的第15分钟开始执行任务，那么会造成同一时间内在Jenkins中启动很多job，换成H/15 * * * *,那么在首次启动任务时，会有随机值参与进来，有的会在17分钟启动有的会在19分钟启动，随后的启动时间也是这个值。这样就能错开相同cron值的任务执行了。

H的值也可以设置范围

H * * * *表示一小时内的任意时间

*/10 * * * *每10分钟

H/10 * * * *每10分钟,可能是7,17,27，起始时间hash，步长不变

45 3 * * 1-6 每个周一至周六，凌晨3点45 执行1次

45 3-5 * * 1-6 每个周一至周六，凌晨3点45 ，凌晨4点45，凌晨5点45 各执行1次

H(40-48) 3-5 * * 1-6 在40~48之间取值其他同上

45 3-5/2 * * 1-6 每个周一至周六，凌晨3点45 ，凌晨5点45 各执行1次

45 0-6/2 * * 1-6 0点开始，每间隔2小时执行一次 0:45、2:45、4:45

07- Poll SCM 触发构建

源码变更构建

使用Poll SCM 方式与Build periodically一样

会主动定期检查代码托管服务器上是否有变化，一旦发生变化执行job构建

08- 配置邮箱接受构建通知

邮箱服务器用来发邮件（公司）

使用 qq/ 163 等等邮箱提供的 SMTP 服务发送通知邮件

需要开启 POP3/SMTP 服务

在 jenkins 上配置通知发送邮箱和通知接收邮箱

09- jenkins 集群配置并发构建

集群化构建可以有效提升构建效率，尤其是团队项目比较多或是子项目比较多的时候，可以并发在多台机器上执行构建。

创建三台 vm 虚拟机做为 jenkins 分布式环境，只需在一台机器上安装 jenkins

在jenkins dashboard 如下图所示位置添加 jenkins 节点

更改 job 属性

10- jenkins 流水线（pipeline)

流水线既能作为任务的本身，也能作为Jenkinsfile

使用流水线可以让我们的任务从ui手动操作，转换为代码化，像docker的dockerfile一样，从shell命令到配置文件，更适合大型项目，可以让团队其他开发者同时参与进来，同时也可以编辑开发Jenkinswebui不能完成的更复杂的构建逻辑，作为开发者可读性也更好。

5个必备的组成部分

pipeline：整条流水线
agent：指定执行器
stages：所有阶段
stage：某一阶段，可有多个
steps：阶段内的每一步，可执行命令

11- jenkins Blue Ocean UI 插件

全新的流水线控制ui，可重复执行某阶段代码

安装插件

12- 使用 pipeline 自动打包docker 镜像

post

流水线完成后可执行的任务

always 无论流水线或者阶段的完成状态。
changed 只有当流水线或者阶段完成状态与之前不同时。
failure 只有当流水线或者阶段状态为"failure"运行。
success 只有当流水线或者阶段状态为"success"运行。
unstable 只有当流水线或者阶段状态为"unstable"运行。例如：测试失败。
aborted 只有当流水线或者阶段状态为"aborted "运行。例如：手动取消。

agent

可以指定执行节点

label 指定运行job的节点标签

any 不指定，由Jenkins分配

pipeline {
    agent {
        node {
            label "jenkins-02"
        }
        
    }

    stages {
        stage('拉取代码') {
            steps {
          
                sh """
                    sleep 10
                            
                   """

                echo '拉取代码完成'
               
            }

        }
        stage('执行构建') {
            steps {
                echo '执行构建完成'


            }

        }
    }
    
    post {
        
        always {
            
            echo "完成"
            
        }
        
        failure {
            
            echo "失败"
        }
    }
}

可以使用片段生成器生成相关的流水线

pipeline中执行自动化构建

下面pipeline 文件中 stage("clean test server") 和 stage("发送jar包到测试服务器") 是使用片段生成器生成的 pipline步骤。

pipeline {
    agent any

    tools {
        
        maven "maven3"
        
    }
    stages {
        stage("拉取代码") {
            steps {
                
                
                git branch: 'main', credentialsId: 'gitlab', url: 'http://192.168.44.103/root/java-project.git'
                echo '拉取成功'
            }
        }

        stage("执行构建") {
            steps {
                
            //    sh "mvn --version"
                sh """ 
                cd demo-1
                
                mvn clean package
                """
                
                echo '构建完成'
            }

        }
        
        
        stage("clean test server"){
            
            steps{
                
sshPublisher(publishers: [sshPublisherDesc(configName: 'testserver', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''rm -rf *

docker stop demo
docker rm demo
docker rmi demo
''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: '', remoteDirectorySDF: false, removePrefix: '', sourceFiles: '/root')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
            }
        }
        
        
        
        
        
        stage("发送jar包到测试服务器") {
            steps {
                
                sshPublisher(publishers: [sshPublisherDesc(configName: 'testserver', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: '/jarfile', remoteDirectorySDF: false, removePrefix: 'demo-1/target', sourceFiles: '**/demo*.jar'), sshTransfer(cleanRemote: false, excludes: '', execCommand: '''docker build -t demo .
docker run -d -p 8080:8080 --name demo demo''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: '/', remoteDirectorySDF: false, removePrefix: 'demo-1/docker', sourceFiles: 'demo-1/docker/dockerfile')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
                
                
                echo 'jar send over!'
            }

        }

    }
}

13- 多分支流水线

声明式流水线

好处

更像是在Jenkins web ui中的操作
可读性比较高
可以使用blue ocean自动生成
支持语法检查

坏处

代码逻辑能力比脚本式弱，不能完成特别复杂的任务

脚本式流水线

好处

更少的代码和弱规范要求
更灵活的自定义代码操作
不受约束，可以构建特别复杂的工作流和流水线

坏处

读写对编程要求比较高
比声明式流水线代码更复杂

posted @ 2026-10-03 19:45 Ref-brief 阅读(5) 评论(1) 收藏举报

刷新页面返回顶部

Ref-brief

jenkins

jenkins

01-安装部署

1-gitLab

在ssh下安装

在docker下安装

2-jenkins

3-测试服务器

02-Jenkins + Git + Maven 自动化部署配置

1 jenkins上 Git配置

2 jenkins上 Maven配置

3 jenkins上 Pom.xml配置

4 自动发布到测试服务器并自动运行

04- gitlab钩子自动构建项目

05- 几种常见的构建触发器

06- 定时执行任务 jenkins cron 表达式

07- Poll SCM 触发构建

08- 配置邮箱接受构建通知

09- jenkins 集群配置并发构建

10- jenkins 流水线（pipeline)

11- jenkins Blue Ocean UI 插件

12- 使用 pipeline 自动打包docker 镜像

13- 多分支流水线

公告