jenkins安装配置，使用Docker发布maven项目全过程记录（1）

使用的CentOS8 系统，其它Linux系统类似

1、jenkins安装

1.1、配置JAVA环境

使用的服务器环境中，安装了Java1.8与Java17，当前jenkins的最低java版本要求java11。系统默认使用的是java1.8，因此需要切换环境。

alternatives --config java

系统弹出提示：

  选项    命令
-----------------------------------------------
*  1           java-1.8.0-openjdk.x86_64 (/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.362.b08-3.el8.x86_64/jre/bin/java)
 + 2           java-17-openjdk.x86_64 (/usr/lib/jvm/java-17-openjdk-17.0.6.0.9-0.3.ea.el8.x86_64/bin/java)

按 Enter 保留当前选项[+]，或者键入选项编号：

在这里，输入2，切换为java-17环境，否则运行jenkins时会报错。

1.2 安装jenkins

# 获取jenkins的安装地址
wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo

# 获取jenkins的公钥
rpm --import https://jenkins-ci.org/redhat/jenkins-ci.org.key

# 安装
yum install jenkins

安装完成后，可以运行测试

# 运行jenkins
systemctl start jenkins

# 设置为自动启动
systemctl enable jenkins

检查jenkins运行状态

# 检查jenkins运行状态，需要注意是否有exit code字样
systemctl status jenkins

设置防火墙

# 开启8080端口
firewall-cmd --permanent --zone=public --add-port=8080/tcp

# 启用防火墙设置
firewall-cmd --reload

浏览器打开jenkins

http://<<you-ip-address>>:8080

此时会要求输入管理员密码

cat /var/lib/jenkins/secrets/initialAdminPassword

系统会输出一个字符串，复制此字符串，输入后，会进入系统插件安装页面，安装推荐的即可。

等待安装完成后，其它可以保持默认配置，进入主页面。

1.3 配置jenkins

1.3.1 安装插件

选择 Manage Jenkins，进入Plugins，选择Availabel Plugins。按需安装如下插件：

Ant
Build Timeout
Command Agent Launcher Plugin
DingTalk    // 如需钉钉相关支持
Docker Pipeline
External Monitor Job Type Plugin
Email Extension Plugin
Generic Webhook Trigger Plugin    // 重要
Git Parameter Plug-In
Gradle Plugin    // 如需Gradle
JavaMail API
JDK Parameter Plugin    // 如需使用特殊的Java参数
LDAP Plugin
Locale plugin
Localization Support Plugin
Matrix Authorization Strategy Plugin
NodeJS Plugin    // 如需NodeJS
PAM Authentication plugin
Pipeline Graph Analysis Plugin
Pipeline: Multibranch with defaults
Pipeline: Stage View Plugin
Publish Over FTP
SSH server    // 如需使用SSH
WMI Windows Agents Plugin
Workspace Cleanup Plugin

安装完成后重启jenkins（可选择自动重启），也可手动输入命令

systemctl restart jenkins.service

1.3.2 安装配置Maven、JDK、Docker

1.3.2.1 Maven配置

首先，把Maven配置为使用国内源

在Default global settings provider处选择Global?settings file on filesystem

配置系统中的路径：/path/to/maven-setting/settings.xml。文件格式如下：

<settings>
  <mirrors>
    <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>aliyun maven</name>
    <url>https://maven.aliyun.com/repository/public </url>
    </mirror>
  </mirrors>
</settings>

其次，可以进行多版本Maven的管理

a）找到Maven installations，选择Add Maven，设置maven名称，用于使用时选择，我的习惯是使用maven+版本号，如：maven3.9.6

b）去掉Install Automatically的选项（经常下载失败），自在手动找到在系统中下载maven，并解压至指定文件夹，把路径写在MAVEN_HOME处，如：/var/lib/jenkins/tools/hudson.tasks.Maven_MavenInstallation/maven3.9.6/apache-maven-3.9.6

保存配置即可。

1.3.2.2 JDK配置

a) 选择JDK installations，选择Add JDK。输入JDK名称，用于使用时选择，我的习惯是使用java+大版本号，如：java17

b) 去掉Install Automatically的选项（经常下载失败），自在手动找到在系统中下载maven，并解压至指定文件夹，把路径写在JAVA_HOME处，如：/var/local/jdk-17.0.10

1.3.2.3 Docker配置

docker的配置相对比较特殊，docker直接需要在系统中进行配置。Jenkins直接使用系统中的默认配置。

至此，Jenkins的安装与配置全部完成。