CI&CD落地实践2-Jenkins环境搭建&常见使用技巧（cat war2）

一、安装Jenkins1.安装方式简介

官方下载地址：HTTPS://jenkins.io/download/
镜像下载地址：http://mirrors.jenkins-ci.org/

Jenkins搭建有多种方式，如果是Windows系统：

可以通过下载jenkins.msi直接双击安装；
也可以下载jenkins.war包放到Tomcat容器中启动；

如果是Linux系统：

可以下载jenkins.war包放到Tomcat容器中启动；
也可以通过docker容器化安装，此种方式较为快捷，前提是需要懂一些docker相关的知识，可参考前面的一篇文章《docker从入门到实战系列4-docker一键快速搭建环境》；

此处我的系统是Linux（CentOS7.9）系统，选用的是Tomcat的安装启动方式，Windows系统大同小异。

2.安装步骤

① 下载并解压Tomcat

我这里用的是apache-tomcat-9.0.43版本，解压后会得到如下目录文件：

② 将Jenkins.war包放到tomcat的webapps目录下

③ 启动tomcat

在启动前需要先赋予sh文件执行权限，然后执行启动：

chmod x *.sh ./startup.sh

④ 访问Jenkins

如果不修改Tomcat配置的话，默认端口就是8080，http://ip:8080/jenkins/

首次访问，需要输入密钥，路径为：/root/.jenkins/secrets/initialAdminPassword

[root@sonic bin]# cat /root/.jenkins/secrets/initialAdminPassword 8b5097b6dd60437a98540184d83bd79b

为了快速初始化，可以跳过插件安装

⑤ 创建管理员用户

也可以以admin作为默认管理员账号

实例配置，如无特殊要求，保持默认

至此，Jenkins算是运行起来了

首页如下：

3.汉化Jenkins

Jenkins默认语言为英文，对于不太熟悉或英文不好的人来说，看起来会有些吃力，我们可以通过汉化插件对其进行汉化。在系统管理-插件管理中搜索安装Localization: Chinese (Simplified)插件：

如果在安装插件过程中出现报错“sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target”，也不必着急，下面会介绍如何解决插件安装报错问题。解决后重新安装此插件即可。

二、Jenkins目录结构1.Jenkins主目录

.xml文件：Jenkins的各项配置文件，config.xml为Jenkins核心配置文件；
jobs目录：存放Jenkins任务文件的目录；
plugins：存放Jenkins插件；

2.修改Jenkins主目录(Linux版)

① 修改系统配置文件：vi /etc/profile，增加如下内容：

export JENKINS_HOME=/home/jenkins export PATH=${PATH}:${JENKINS_HOME}

② 重新加载配置文件：source /etc/profile

③ /home下新建jenkins目录作为Jenkins主目录：mkdir jenkins

④ 复制~/.jenkins下的所有内容到/home/jenkins下

cd ~/.jenkins cp -rf ./* /home/jenkins

⑤ 重启Jenkins，此时Jenkins的主目录已更换

特别注意，一般情况下尽量不要修改Jenkins的主目录

三、Jenkins架构原理

Jenkins是一种典型的Master-Slave主从架构。该架构包括一个Master（主）节点和多个Slave（从）节点。Jenkins的Master-Slave架构提供了可扩展性和灵活性，允许用户添加更多节点来提高Jenkins的处理能力，同时保持构建和管理过程的可靠性。

Master节点：Jenkins的核心是Master节点，包含Jenkins的核心功能和管理界面，并与所有Slave节点通信，调度和分配作业。主要的作业配置信息，如构建工作流程、触发器和构建器、节点和视图信息，以及连接外部系统的应用程序都存储在Jenkins Master节点中。
Agent节点：也称slave节点，是通过Jenkins Agent（代理）连接到Master节点的计算机，它们执行来自Master节点的作业并将结果返回给Master节点。
插件：Jenkins的扩展性大大依赖于其插件模型。插件提供各种功能，如构建工具、自动化测试、通知和部署技术。
视图：Jenkins将作业组织成视图，可以通过主界面中的链接和搜索来访问和浏览视图。视图可以按自定义方式组织作业和节点。
构建：Jenkins的核心功能是构建软件项目。构建在Jenkins中定义为一组操作，包括源代码管理、编译、测试和打包。

在Jenkins的架构中，Master节点是Jenkins的主要组成部分，其能力和可靠性对整个系统的运行状况至关重要。同时，Agent节点向Master节点添加计算能力，允许Jenkins扩展到数百个作业和大量的节点。插件和视图则为Jenkins提供了强大的自定义功能，使其能够让用户适应不同的需求。

四、Jenkins使用技巧及常见问题解决1.解决插件安装报错问题

解决方式有两种：

一种是修改Jenkins默认配置，这种方式比较繁琐，需要修改很多地方的配置，感兴趣的可以自己尝试，可参考《jenkins下载插件报错解决》。
另一种方式是离线安装一个跳过证书验证的插件：skip-certificate-check，此种方式较为简单。

我选用的是这个方式2，具体步骤如下：

① 下载插件

官网地址：http://updates.jenkins-ci.org/download/plugins/skip-certificate-check/

下载地址：http://updates.jenkins-ci.org/download/plugins/skip-certificate-check/1.1/skip-certificate-check.hpi

② 上传插件

到系统管理-插件管理-高级设置-Deploy Plugin中，上传所下载的skip-certificate-check.hpi文件

③ 重启Jenkins

重启后再次安装前面的汉化插件，即可成功安装。系统界面已更新为中文显示：

2.一直停留在页面Please wait while Jenkins is getting ready to work

解决方法：找到hudson.model.UpdateCenter.xml文件，将 url 中的 https://updates.jenkins.io/update-center.json 更改为：http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

【其他插件地址】
http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
http://mirror.xmission.com/jenkins/updates/update-center.json
http://ftp.tsukuba.wide.ad.jp/software/jenkins/updates/current/update-center.json
http://updates.jenkins.io/update-center.json

3.修改Jenkins端口方法

在默认情况下，tomcat的端口是8080，如何需要修改tomcat端口号可以到Tomcat安装目录(或者解压目录)下找到conf文件夹，找到server.xml的文件，将8080端口修改为指定端口即可，8443为HTTPS端口

4.控制台中文出现乱码

在Tomcat安装目录的conf目录中，将logging.properties文件中“java.util.logging.ConsoleHandler.encoding = UTF-8”改为“java.util.logging.ConsoleHandler.encoding = GBK”（Windows控制台默认编码方式为GBK，Linux为UTF-8，所以如果是Windows系统，则需要改成与Windows编码方式一致）