参考文献

使用Yum安装后,默认文件目录

1
2
3
4
5
6
7
8
9
/usr/lib/jenkins/jenkins.war WAR包

/etc/sysconfig/jenkins 配置文件

/var/lib/jenkins/ 默认的JENKINS_HOME目录

/var/log/jenkins/jenkins.log Jenkins日志文件

/etc/init.d/jenkins jenkins启动脚本

  • 配置文件: /etc/sysconfig/jenkins

    • 默认工作空间: JENKINS_HOME="/var/lib/jenkins"

  • 启动目录: /usr/lib/jenkins

  • 修改Java目录

    • 查看Java路径: which java

      1
      2
      [root@holelin jenkins]# which java
      /usr/local/jdk1.8/bin/java

    • 配置:

      1
      [root@holelin jenkins]# vim /etc/rc.d/init.d/jenkins

将jenkins用户加入root组

1
2
3
4
5
gpasswd -a root jenkins
# 修改jenkins配置文件
vim /etc/sysconfig/jenkins
JENKINS_USER="root"
JENKINS_GROUP="root"

完整配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
## Path:        Development/Jenkins
## Description: Jenkins Automation Server
## Type:        string
## Default:     "/var/lib/jenkins"
## ServiceRestart: jenkins
#
# Directory where Jenkins store its configuration and working
# files (checkouts, build reports, artifacts, ...).
#
JENKINS_HOME="/var/lib/jenkins"

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# Java executable to run Jenkins
# When left empty, we'll try to find the suitable Java.
#
JENKINS_JAVA_CMD=""

## Type:        string
## Default:     "jenkins"
## ServiceRestart: jenkins
#
# Unix user account that runs the Jenkins daemon
# Be careful when you change this, as you need to update
# permissions of $JENKINS_HOME and /var/log/jenkins.
#
JENKINS_USER="jenkins"
JENKINS_GROUP="root"
## Type:        string
## Default: "false"
## ServiceRestart: jenkins
#
# Whether to skip potentially long-running chown at the
# $JENKINS_HOME location. Do not enable this, "true", unless
# you know what you're doing. See JENKINS-23273.
#
#JENKINS_INSTALL_SKIP_CHOWN="false"

## Type: string
## Default:     "-Djava.awt.headless=true"
## ServiceRestart: jenkins
#
# Options to pass to java when running Jenkins.
#
JENKINS_JAVA_OPTIONS="-Djava.awt.headless=true"

## Type:        integer(0:65535)
## Default:     8080
## ServiceRestart: jenkins
#
# Port Jenkins is listening on.
# Set to -1 to disable
#
JENKINS_PORT="10086"

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# IP address Jenkins listens on for HTTP requests.
# Default is all interfaces (0.0.0.0).
#
JENKINS_LISTEN_ADDRESS=""

## Type:        integer(0:65535)
## Default:     ""
## ServiceRestart: jenkins
#
# HTTPS port Jenkins is listening on.
# Default is disabled.
#
JENKINS_HTTPS_PORT=""

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# Path to the keystore in JKS format (as created by the JDK 'keytool').
# Default is disabled.
#
JENKINS_HTTPS_KEYSTORE=""

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# Password to access the keystore defined in JENKINS_HTTPS_KEYSTORE.
# Default is disabled.
#
JENKINS_HTTPS_KEYSTORE_PASSWORD=""

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# IP address Jenkins listens on for HTTPS requests.
# Default is disabled.
#
JENKINS_HTTPS_LISTEN_ADDRESS=""

## Type:        integer(0:65535)
## Default:     ""
## ServiceRestart: jenkins
#
# HTTP2 port Jenkins is listening on.
# Default is disabled.
#
# Notice: HTTP2 support may require additional configuration, see Winstone
# documentation for more information.
#
JENKINS_HTTP2_PORT=""

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# IP address Jenkins listens on for HTTP2 requests.
# Default is disabled.
#
# Notice: HTTP2 support may require additional configuration, see Winstone
# documentation for more information.
#
JENKINS_HTTP2_LISTEN_ADDRESS=""

## Type:        integer(1:9)
## Default:     5
## ServiceRestart: jenkins
#
# Debug level for logs -- the higher the value, the more verbose.
# 5 is INFO.
#
JENKINS_DEBUG_LEVEL="5"

## Type:        yesno
## Default:     no
## ServiceRestart: jenkins
#
# Whether to enable access logging or not.
#
JENKINS_ENABLE_ACCESS_LOG="no"

## Type:        integer
## Default:     100
## ServiceRestart: jenkins
#
# Maximum number of HTTP worker threads.
#
JENKINS_HANDLER_MAX="100"

## Type:        integer
## Default:     20
## ServiceRestart: jenkins
#
# Maximum number of idle HTTP worker threads.
#
JENKINS_HANDLER_IDLE="20"

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# Folder for additional jar files to add to the Jetty class loader.
# See Winstone documentation for more information.
# Default is disabled.
#
JENKINS_EXTRA_LIB_FOLDER=""

## Type:        string
## Default:     ""
## ServiceRestart: jenkins
#
# Pass arbitrary arguments to Jenkins.
# Full option list: java -jar jenkins.war --help
#
JENKINS_ARGS=""

使用指定的JDK,修改jenkins启动脚本

img

卸载Jenkins

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 仅删除 Jenkins 的主程序文件（二进制、脚本等），但保留其配置文件和数据（如 /etc/jenkins、/var/lib/jenkins 等
sudo apt-get remove jenkins

# 在删除 Jenkins 的同时，自动移除不再被其他软件依赖的依赖项
# 注意可能影响其他服务
# 例如，如果 Jenkins 的某个依赖项（如 openjdk-11-jdk）被其他服务（如 Tomcat、Spring Boot 应用）使用，而该依赖项未被其他软件显式依赖，它会被删除，导致其他服务无法运行
# 可使用sudo apt-get remove --auto-remove --simulate jenkins 模拟看一下涉及哪些包
sudo apt-get remove --auto-remove jenkins

# 删除 Jenkins 的主程序文件和配置文件（如 /etc/jenkins、日志文件等
sudo apt-get purge jenkins

# 删除 Jenkins 的主程序、配置文件，并自动移除不再需要的依赖项
# 风险最高。与 --auto-remove 的逻辑相同，可能删除其他服务依赖的组件
# 可使用sudo apt-get purge --auto-remove --simulate jenkins 模拟看一下涉及哪些包
sudo apt-get purge --auto-remove jenkins

插件Publish Over SSH使用

使用步骤

  1. 安装Publish Over SSH插件
  2. 配置Linux系统的SSH服务免密登录
  3. 在Jenkins系统设置中添加SSH Server
  4. 在具体项目中配置

配置说明

公共配置
  • Passphrase:密码(key的密码，如果你设置了)
  • Path to key:key文件(私钥)的路径
    • 注: Jenkins服务器所在服务器私钥文件路径
  • Key:将私钥复制到这个框中
    • 注: Jenkins服务器所在服务器私钥文件内容
  • Disable exec:禁止运行命令
私有配置
  • SSH Server Name:标识的名字(随便你取什么)
  • Hostname:需要连接ssh的主机名或ip地址(建议ip)
  • Username:用户名
  • Remote Directory:远程目录
  • Use password authentication, or use a different key:可以替换公共配置(选中展开的就是公共配置的东西，这样做扩展性很好)
私有配置的高级:
  • Port:端口(默认22)
  • Timeout (ms):超时时间(毫秒)默认即可
  • Disable exec:禁止运行命令
  • Test Configuration:测试连接
项目配置

  • 启用步骤: 构建后操作→Add post-build action→Send build artifacts over SSH

  • SSH Server Name:选个一个你在系统设置里配置的配置的名字

  • Transfer Set Source files:需要上传的文件(注意:相对于工作区的路径.看后面的配置可以填写多个，默认用,分隔)

  • Remove prefix:移除目录(只能指定Transfer Set Source files中的目录)

  • Remote directory:远程目录(根据你的需求填写吧，因为我这儿是测试,所以偷懒没有填写.默认会继承系统配置)

  • Exec command:把你要执行的命令写在里面

  • 高级:

    • Exclude files:排除的文件
    • Pattern separator:分隔符(配置Transfer Set Source files的分隔符.如果你这儿更改了，上面的内容也需要更改)
    • No default excludes:禁止默认的排除规则
    • Make empty dirs:此选项会更改插件的默认行为.默认行为是匹配该文件是否存在，如果存在则创建目录存放.选中此选项会直接创建一个目录存放文件，即使是空目录.
    • Flatten files:只上传文件，不创建目录
    • Remote directory is a date format:远程目录建立带日期的文件夹(需要在Remote directory中配置日期格式)，具体格式参考下表:
    Remote directory Directories created
    'qa-approved/'yyyyMMddHHmmss qa-approved/20101107154555
    'builds/'yyyy/MM/dd/'build-${BUILD_NUMBER}' builds/2010/11/07/build-456 (if the build was number 456)
    yyyy_MM/'build'-EEE-d-HHmmss 2010_11/build-Sun-7-154555
    yyyy-MM-dd_HH-mm-ss 2010-11-07_15-45-55

    • Exec timeout (ms):运行脚步的超时时间(毫秒)

    • Exec in pty:模拟一个终端执行脚步

    • Add Transfer Set:增加一个配置

具体操作

环境说明
1
2
3
两台服务器: 
* 192.168.10.1  Jenkins所在服务器
* 192.168.10.2  应用服务器
安装插件
  • 系统管理→管理插件→可选插件→Artifact Uploaders→Publish Over SSH
生成秘钥

  • 在Jenkins服务器上生成秘钥

    1
    ssh-keygen -m PEM -t rsa -b 4096

    • 说明: 此处建议使用指定rsa秘钥类型来生成秘钥,其他类型的秘钥,可以插件无法识别导致,无法连接应用服务器.

    • 秘钥若不指定路径,默认在当前用户目录下的.ssh/路径下

  • 在应用服务器上的.ssh/authorized_keys文件中添加Jenkins服务器的公钥,即文件路径为.ssh/id_rsa.pub的内容

  • 添加完成后,可以在Jenkins服务器上使用命令ssh username@应用服务器的IP尝试连接一下,看一下是否能连接上.

    • 若能连接上,说明配置正确;
    • 若不能连接上,在检查配置无误后,可以尝试重启SSH服务systemctl restart sshd
配置插件

  • 登录Jenkins管理页面,进入系统设置

    img

    img

  • 根据配置说明填写对应的信息,填写完成后,点击"Test Configuration",若出现"Success"说明配置成功

    img