jenkins入门指南

原创

ghostwritten 2022-05-30 19:38:22 博主文章分类：jenkins ©著作权

文章标签 jenkins java 运维 git html 文章分类 OpenStack 云计算

©著作权归作者所有：来自51CTO博客作者ghostwritten的原创作品，请联系作者获取转载授权，否则将追究法律责任

文章目录

1. 简介
2. Jenkins安装

2.1 环境准备
2.2 安装jdk
2.3 安装jenkins（本地）

3. Jenkins插件管理
4. Jenkins 目录与文件
5. Jenkins创建freestyle项目
6. 连接gitlab获取仓库代码
7. linux脚本部署httpd服务
8. Git push触发自动构建
9. 升级jenkins
10. Jenkinsfile文件

Jenkins 手册指南

1. 简介

jenkins入门指南_git
jenkins入门指南_运维_02
jenkins入门指南_jenkins_03

jenkins入门指南_git_04

2. Jenkins安装

2.1 环境准备

最小硬件需求：256M、1G磁盘空间，通常根据需要Jenkins服务器至少1G内存，50G+的磁盘空间。
软件需求：由于jenkins是使用java语言编写的，所以需要安装java运行时环境(jdk)

获取安装包
可以从Jenkins官方网站及清华镜像站下载jenkins安装包

jenkins-2.164.3-1.1.noarch.rpm
jdk-8u211-linux-x64.rpm

# cat /etc/redhat-release 
CentOS Linux release 7.5.18c4 (Core)

2.2 安装jdk

先卸系统自带的jdk版本

# rpm -qa | grep jdk
java-1.8.0-openjdk-headless-1.8.0.161-2.b14.el7.x86_64
copy-jdk-configs-3.3-2.el7.noarch
java-1.8.0-openjdk-1.8.0.161-2.b14.el7.x86_64

# rpm -e --nodeps java-1.8.0-openjdk-1.8.0.161-2.b14.el7.x86_64
# rpm -e --nodeps java-1.8.0-openjdk-headless-1.8.0.161-2.b14.el7.x86_64
# rpm -ivh jdk-8u211-linux-x64.rpm
# java -version
java version "1.8.0_211"
Java(TM) SE Runtime Environment (build 1.8.0_211-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.211-b12, mixed mode)

2.3 安装jenkins（本地）

创建jenkins用户组和用户

# groupadd jenkins
# useradd -g jenkins -s /sbin/nologin -m jenkins  -s 不可以登录  -m创建用户home目录

# rpm -ivh jenkins-2.164.3-1.1.noarch.rpm

因为我的是gitlab服务和jenkins部署在一台上
所以我修改了jenkins的默认8080端口为8090

# cat /etc/sysconfig/jenkins | grep JENKINS_PORT
JENKINS_PORT="8090"


启动、配置jenkins
# systemctl start jenkins
# ss -lntp | grep 8090
LISTEN     0      50          :::8090                    :::*                   users:(("java",pid=1858,fd=168))

在web上进行访问http://192.168.137.100:8090

jenkins入门指南_html_05

# cat /var/lib/jenkins/secrets/initialAdminPassword
6445fe48a5f34f06801937fd1fa44668

jenkins入门指南_运维_06

jenkins入门指南_jenkins_07

jenkins入门指南_git_08

要重新启动下jenkins

# systemctl restart jenkins

http://192.168.137.100:8090/login

账号：admin
密码：6445fe48a5f34f06801937fd1fa44668

jenkins入门指南_java_09
jenkins入门指南_运维_10

修改admin的密码
jenkins入门指南_jenkins_11
jenkins入门指南_html_12

3. Jenkins插件管理

Jenkins本身是一个引擎、一个框架，只是提供了很简单功能，其强大的功能都是通过插件来实现的，jenkins有一个庞大的插件生态系统，为jenkins提供丰富的功能扩展。
插件安装的方式：
1、自动插件安装
在jenkins主页面，点击系统管理

jenkins入门指南_运维_13

出现问题：解决“该Jenkins实例似乎已离线”
There were errors checking the update sites: SocketTimeoutException: connect timed out

jenkins入门指南_java_14

解决方法：修改更新地址的https为http

# vim /var/lib/jenkins/hudson.model.UpdateCenter.xml
# systemctl restart jenkins.service 
# cat /var/lib/jenkins/hudson.model.UpdateCenter.xml
xml version='1.1' encoding='UTF-8'?>
<sites>
  <site>
    <id>defaultid>
    <url>http://updates.jenkins.io/update-center.json
  site>
sites>
#

然后刷新页面

jenkins入门指南_运维_15

2、手工安装插件
jenkins入门指南_java_16
https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/ssh/latest/ jenkins入门指南_jenkins_17

下载ssh.hpi后，手动安装ssh插件，进入到插件管理页面
提前下载在win电脑上
Web页面添加插件

jenkins入门指南_运维_18
jenkins入门指南_运维_19
jenkins入门指南_html_20

jenkins入门指南_git_21

安装成功后
jenkins入门指南_jenkins_22

4. Jenkins 目录与文件

Jenkins 常用的目录及文件

学习Jenkin，首先要明白一点，那就是jenkins下一切兼文件，也就是说jenkins没有数据库，所有的数据都是以文件的形式存在，所以要了解jenkins的主要目录及文件，通过命令可以查看到所有的jenkins目录及文件的位置。

# rpm -ql jenkins
/etc/init.d/jenkins
/etc/logrotate.d/jenkins
/etc/sysconfig/jenkins
/usr/lib/jenkins
/usr/lib/jenkins/jenkins.war
/usr/sbin/rcjenkins
/var/cache/jenkins
/var/lib/jenkins
/var/log/jenkins

Jenkins的主配置文件
/etc/sysconfig/jenkins是jenkins的主配置文件：

# cat /etc/sysconfig/jenkins | grep JENKINS_HOME   主目录
JENKINS_HOME="/var/lib/jenkins"
# cat /etc/sysconfig/jenkins | grep JENKINS_USER  jenkins用户
JENKINS_USER="jenkins"
Jenkins默认的用户为jenkins，然后使用sudo进行授权
# cat /etc/sysconfig/jenkins | grep JENKINS_PORT   端口，默认8080
JENKINS_PORT="8090"

主目录：/var/lib/jenkins

主目录下的

jobs目录：存放jobs的配置及每次构建的结果，
plugins目录：jenkins插件目录，存放已经安装的插件，
Worksspace：工作区目录，每次job执行构建时的工作目录，
Users目录：存放与用户相关的配置文件。

Jenkins主程序目录/usr/lib/jenkins/jenkins.war 是jenkins的主程序

Jenkins日志文件目录：/var/log/jenkins/

Jenkins启动文件：/etc/init.d/jenkins

5. Jenkins创建freestyle项目

构建作业是一个持续集成服务器的基本职能，构建freestyle的形式多种多样，可以是编译和单元测试，也可能是打包及部署，或者是其它类似的作业。
在jenkins中，构建作业是很容易建立的，而且可以根据需求安装各种插件，来创建多种形式的构建作业，下面是创建自由式作业
自由式构建作业是最灵活和可配置的选项，并且可以用于任何类型的项目，它的配置相对简单，其中很多配置在选项也可以用在其他构建作业中
在jenkins主页面，点击左侧菜单栏的“新建”或者“New job”
jenkins入门指南_html_23
jenkins入门指南_运维_24

注意：

job名称需要提前规划好，以便于后面的权限管理
创建job后不要轻易更改名称，因为jenkins一切皆文件，很多关于job的文件，都是以该名称命名，当名称被修改后，一般不会删除旧文件，而是会再重新创建一份新的文件。

进入job的配置页面，此时jenkins的主目录下的jobs目录已经生成了以job名称命名的文件夹

# pwd
/var/lib/jenkins/jobs
# ll -h
总用量 0
drwxr-xr-x 3 jenkins jenkins 38 6月   8 13:55 My-Freestyle-job

Job的配置页面，主要是包括通用配置、源码管理、构建触发器、构建环境、构建、构建后操作等几个部分，根据选择的构建类型不同，可能配置项会有一些小的差别。

执行linux命令、脚本实验
先看通用配置选项
jenkins入门指南_html_25

勾选“丢弃旧的构建”，这是必须提前考虑的重要方面，就是如何处理构建历史，构建作业会消耗大量的磁盘空间，尤其是存储的构建产物(比如执行java构建时会生成的JAR、WAR等)
jenkins入门指南_jenkins_26

该选项允许你限制在构建历史记录的作业数。可以设置jenkins只保留最近几次的构建，或者只保留指定数量的构建，此外，jenkins永远不会删除最后一个稳定和成功的构建。

天数：5
最大个数：5
下拉至“构建”部分
添加构建操作
选择“执行shell”

jenkins入门指南_jenkins_27

在Command窗口
输入要执行的命令。每一行一条，可以输入多条
Add build step、添加其它构建
jenkins入门指南_jenkins_28

直接点击保存
jenkins入门指南_运维_29

回到job主页面
点击立即构建
jenkins入门指南_运维_30

点击立即构建，执行job的构建任务，此时的job就是执行一条linux命令
jenkins入门指南_java_31

1：点击工作区，右侧就会列出工作的内容
2：此文件为执行构建时，使用linux命令创建的文件
3：点击这个可以查看本次构建的详细输出

点击Console Output jenkins入门指南_jenkins_32

Job执行时的当前工作目录为jenkins主目录+workspaces+以job名称命名的文件夹，知道这一点对于后面写脚本执行部署任务时非常重要。

6. 连接gitlab获取仓库代码

在gitlab上复制仓库的地址
jenkins入门指南_html_33

选择ssh的方式

git@192.168.137.100:xmlgrg_test/xm.git

然后再jenkins上的My-Freestyle-job的配置页面，下拉到“源码管理”部分
jenkins入门指南_git_34

发现没有
jenkins入门指南_git_35

那我们就去安装一个git的插件
https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/gitlab-plugin/ 没有安装最新的，最新的好像对版本有要求
https://mirrors.tuna.tsinghua.edu.cn/jenkins/plugins/gitlab-plugin/1.5.5/gitlab-plugin.hpi 安装的是1.5.5版本的

然后再去源码管理页面
然后再jenkins上的My-Freestyle-job的配置页面，下拉到“源码管理”部分，勾选git选项
输入git的URL
jenkins入门指南_html_36

发现仓库地址被粘贴后，出现如图错误
显示信息为key认证失败，因为使用的是ssh方式连接仓库，所以需要配置ssh认证，因为jenkins服务启动的用户是jenkins jenkins入门指南_git_37
因为在gitlab上配置的是root用户的公钥，处理这个报错有2个方法。

在jenkins上配置使用root用户的私钥连接gitlab
配置使用root用户启动jenkins 其实就是修改jenkins的配置文件/etc/sysconfig/jenkins中启动用户JENKINS_USER=root，重启jenkins服务

方式1
点击添加认证、选择jenkins
jenkins入门指南_java_38

进入认证添加页面
查看root的ssh私钥

# cat /root/.ssh/id_rsa
-----BEGIN RSA PRIVATE KEY-----
MIIEpAIBAAKCAQEAwva0K+f7IexCRjJknCCZ8hvr1ml6Y4mwOIvNYpNeKXcnlfNA
YnUn+WU4vTDBBMhVjkp3yPpl0l/U1tdvK6mA6g4GKbVpZRDISlQ6rQ==
-----END RSA PRIVATE KEY-----

jenkins入门指南_jenkins_39

点击添加
然后会自动回到源码管理页面
选择认证方式为刚才新建的即可
点击保存

jenkins入门指南_git_40

回到job的主页面，点击“立即构建”，构建完成后，就可以在工作区看到从gitlab仓库拉取的代码了
jenkins入门指南_jenkins_41

在console output可以看到整个控制台的输出内容
jenkins入门指南_jenkins_42

其实在“源码管理”配置部分，可以配置从分支获取代码，也可以配置从标签获取代码、还可以配置从某一次commit获取代码，

分支dev
jenkins入门指南_git_43

保存，点击立即构建

7. linux脚本部署httpd服务

在192.168.137.101服务器上安装httpd服务

# yum install -y httpd
# systemctl start httpd.service 
#  ss -lntp | grep httpd

jenkins入门指南_git_44
测试
jenkins入门指南_java_45
Httpd服务的默认网站放在/var/www/html目录下
创建一个页面

# pwd
/var/www/html
# cat index.html
<h1>
this one
h1>

jenkins入门指南_jenkins_46
配置ssh免密登录
因为要使用脚本将100 gitlab服务器上的程序代码推送到101 httpd服务器上，所以需要配置100到101的ssh免密码登录。

100服务器上，将root用户的公钥复制给远程101服务器

# ssh-copy-id -i /root/.ssh/id_rsa.pub root@192.168.137.101
root@192.168.137.101's password:  输入101的root密码
Now try logging into the machine, with:   "ssh 'root@192.168.137.101'"


# mkdir -pv /jenkins/gj
mkdir: 已创建目录 "/jenkins"
mkdir: 已创建目录 "/jenkins/gj"
# chown -R jenkins.jenkins /jenkins/gj/

编写部署脚本(deploy.sh)

# cat /data/deploy.sh
#!/bin/bash
#目标服务器IP地址
host=$1
#job名称
job_name=$2
#包名
name=web-$(date +%F)-$(($RANDOM+10000))
#打包
cd /var/lib/jenkins/workspace/${job_name}&& tar czf /jenkins/gj/${name}.tar.gz ./*
#发送包到目标服务器
ssh -t ${host} "cd /var/www/ && mkdir ${name}"
scp /jenkins/gj/${name}.tar.gz $host:/var/www/${name}
#解包
ssh -t  ${host} "cd /var/www/${name} && tar xf ${name}.tar.gz && rm -f ${name}.tar.gz"
#使用软连接方式部署服务
ssh -t ${host} "cd /var/www && rm -rf html && ln -s /var/www/${name} /var/www/html"

赋予jenkins用户执行deploy.sh权限

# chown  jenkins.jenkins /data/deploy.sh

重启jenkins

# systemctl restart jenkins.service

Jenkins配置构建
在My -Freestyle -job配置页面
还是选择执行shell

sh /data/deploy.sh 192.168.137.101 ${JOB_NAME}

最后点击保存
jenkins入门指南_git_47

在job页面、点击立即构建
由于权限的问题，我没有解决
所以、配置使用root用户启动jenkins 其实就是修改jenkins的配置文件/etc/sysconfig/jenkins中启动用户JENKINS_USER=root，重启jenkins服务

点击立即构建
jenkins入门指南_html_48

构建成功后
在httpd服务器上查看
相应的目录下已经有项目里的数据了
jenkins入门指南_运维_49

8. Git push触发自动构建

在上面的job中，已经成功实现了将gitlab中monitor仓库的代码部署到httpd服务中，但是每次部署还需要手动去点击“立即构建”，下面将实现当gitlab收到push请求后，就触发jenkins构建，将仓库的变化部署到httpd服务中。

Jenkins job配置构建触发器
回到My-Freestyle-job的配置页面，下拉到构建触发器部分
jenkins入门指南_运维_50

最后点击保存
jenkins入门指南_java_51

Gitlab仓库配置webhooks 进入gitlab中monitor仓库的设置页面
jenkins入门指南_jenkins_52

点击Integrations、进入集成配置页面
jenkins入门指南_jenkins_53

进入集成配置页面、复制jenkins触发器的配置页面url及Token信息

http://192.168.137.100:8090/project/My-Freestyle-job
862c1ea8d1e70436351d4b32e9091742

jenkins入门指南_git_54

点击Add webhook 按钮
因为我是gitlab和jenkins在同一个服务器上所有会报错

Url is blocked: Requests to localhost are not allowed

在主区域设置允许本地连接即可
jenkins入门指南_jenkins_55

添加成功
jenkins入门指南_html_56

克隆仓库到101本地
jenkins入门指南_html_57

更改a文件，push至gitlab

# cd xm/
[root@localhost xm]# ll
总用量 0
-rw-r--r-- 1 root root 0 6月  15 13:57 a
-rw-r--r-- 1 root root 0 6月  15 13:57 b
-rw-r--r-- 1 root root 0 6月  15 13:57 c
[root@localhost xm]# vim a
[root@localhost xm]# cat a
this a 0615
[root@localhost xm]# git add .
[root@localhost xm]# git commit -m "one test 0615 101"
[root@localhost xm]# git checkout -b nnn  因为有设置master保护
切换到一个新分支 'nnn'
[root@localhost xm]# git push -u origin nnn
枚举对象: 5, 完成.
对象计数中: 100% (5/5), 完成.
使用 4 个线程进行压缩
压缩对象中: 100% (2/2), 完成.
写入对象中: 100% (3/3), 276 bytes | 276.00 KiB/s, 完成.
总共 3 （差异 0），复用 0 （差异 0）
remote: 
remote: To create a merge request for nnn, visit:
remote:   http://192.168.137.100/xmlgrg_test/xm/merge_requests/new?merge_request%5Bsource_branch%5D=nnn
remote: 
To 192.168.137.100:xmlgrg_test/xm.git
 * [new branch]      nnn -> nnn
分支 'nnn' 设置为跟踪来自 'origin' 的远程分支 'nnn'。

然后在jenkins上查看，构建已经完成了
jenkins入门指南_java_58

jenkins入门指南_运维_59

jenkins入门指南_运维_60

检测httpd服务下的文件也已经同步更新了
jenkins入门指南_git_61

9. 升级jenkins

https://mirrors.tuna.tsinghua.edu.cn/jenkins/war/latest/ 下载新版Jenkins.war文件，替换旧版本war文件，重启即可。
Jenkins.war文件的位置一般为/usr/lib/jenkins/Jenkins.war。
jenkins入门指南_运维_62

# cd /usr/lib/jenkins
# systemctl  stop jenkins
# mv jenkins.war jenkins.war-bak
# rz
# systemctl  start jenkins

jenkins入门指南_运维_63

10. Jenkinsfile文件

jenkins入门指南_java_64

jenkins入门指南_运维_65

jenkins入门指南_java_66

jenkins入门指南_git_67

node {
    stage("Pull Code"){
        echo "获取代码"
        git branch: 'master', url: 'git@192.168.137.100:xmlgrg_test/javaone.git'
    }
    stage("打包"){        
            sh "tar czf frontend-${BUILD_NUMBER}.tar.gz ./* --exclude=./git --exclude=Jenkinsfile"        
    }
    stage('deploy'){
        
            sh 'scp frontend-${BUILD_NUMBER}.tar.gz 192.168.137.101:/var/www/html'
            sh 'ssh 192.168.137.101 "cd /var/www/html && tar zxxf frontend-${BUILD_NUMBER}.tar.gz  && rm -rf  frontend-*"'
    }
    stage('Unit Test'){
        echo "Unit Test"
        sh 'curl http://192.168.137.101'
    }
}

jenkins入门指南_jenkins_68

jenkins入门指南_运维_69

jenkins入门指南_java_70

jenkins入门指南_运维_71

jenkins入门指南_运维_72
进一步改良命令

pipeline {
    agent any 
    stages {

        stage('Build') { 
        
            steps {
                echo "获取代码"
                git branch: 'master', url: 'git@192.168.137.100:xmlgrg_test/javaone.git'
    
            }
        }
        stage('Test') { 
            steps {
                sh "tar czf frontend-${BUILD_NUMBER}.tar.gz ./* --exclude=./git --exclude=Jenkinsfile"
            }
        }
        stage('Deploy') { 
            steps {
                sh 'scp frontend-${BUILD_NUMBER}.tar.gz 192.168.137.101:/var/www'
                sh 'ssh 192.168.137.101 "rm -rf /var/www/html && cd /var/www && mkdir /var/www/html && tar -zxf frontend-${BUILD_NUMBER}.tar.gz -C /var/www/html && rm -rf /var/www/frontend-${BUILD_NUMBER}.tar.gz "'
            }
        }
         stage('Unit Test') { 
            steps {
                echo "Unit Test"
                sh 'curl http://192.168.137.101'
            }
        }    
    }    
}

测试Git push 就会更新101服务器上的html文件
jenkins入门指南_jenkins_73
修改jenkinsfile

#!/usr/bin/env groovy Jenkinsfile
pipeline {
    agent any 
    stages {

        stage('Build') { 
        
            steps {
                echo "获取代码"
                git branch: 'master', url: 'git@192.168.137.100:xmlgrg_test/javaone.git'
    
            }
        }
        stage('Test') { 
            steps {
                sh "tar czf frontend-${BUILD_NUMBER}.tar.gz ./* --exclude=./git --exclude=Jenkinsfile"
            }
        }
        stage('Deploy') { 
            steps {
                sh 'scp frontend-${BUILD_NUMBER}.tar.gz 192.168.137.101:/var/www'
                sh 'ssh 192.168.137.101 "rm -rf /var/www/html && cd /var/www && mkdir /var/www/html && tar -zxf frontend-${BUILD_NUMBER}.tar.gz -C /var/www/html && rm -rf /var/www/frontend-${BUILD_NUMBER}.tar.gz "'
            }
        }
         stage('Unit Test') { 
            steps {
                echo "Unit Test"
                sh 'curl http://192.168.137.101'
            }
        }

    }
    
}

jenkins入门指南_html_74
设置scm 方法在上面
设置Git push触发自动构建方法在上面
结果如图

jenkins入门指南_jenkins_75
jenkins入门指南_jenkins_76

上一篇：Helm Values.yaml

下一篇：helm 自动滚动部署

提问和评论都可以，用心的回复会被更多人看到评论

发布评论

相关文章

官方博客	全部文章	热门标签	班级博客
了解我们	网站地图	意见反馈

鸿蒙开发者社区	51CTO学堂
51CTO	软考资讯