Jenkins 安装及常见错误解决方案

野性酷女 2024-03-26 23:21 175阅读 0赞

### 一、安装 ###

本文安装环境是在 Linux CentOS 镜像下 7.7 版本安装的 Jenkins

#### 1.下载 Jenkins ####

sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
        sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
        yum install jenkins

#### 2.配置 Jenkins ####

vim /etc/sysconfig/jenkins
       #监听端口
       JENKINS_PORT="88"
       默认 Jenkins 的端口号是 8080，8080 端口会在安装 Apache 的时候会出现端口冲突，还有安装 GitLab 的时候也会出现端口冲突的问题，后续文章会介绍如何安装 GitLab

#### 3.配置 root 权限(重要) ####

博主试过使用 jenkins 用户进行访问会在 /var/log/jenkins/jenkins.log 下看到无权限的 error

为了不因为权限出现各种问题，这里直接使用 root

vim /etc/sysconfig/jenkins
    
       #修改配置
       $JENKINS_USER="root"

##### 修改目录权限 #####

chown -R root:root /var/lib/jenkins
         chown -R root:root /var/cache/jenkins
         chown -R root:root /var/log/jenkins

重启

service jenkins restart
        ps -ef | grep jenkins

启动时会出现如下错误：

错误1：Restarting jenkins (via systemctl): Job for jenkins.service failed because the control process exited with error code.

解决方案如下：

增加 jdk 的配置，填写本地的 jdk 安装目录，查询本地的 jdk 所在目录：which java (Linux jdk 安装教程会在后续文章给出)

vim /etc/rc.d/init.d/jenkins

[![alt][]][alt 1]

[![alt][]][alt 1]  [![alt][alt 2]

![alt 2][]][alt_alt 2_ _alt 2]

错误2：Restarting jenkins (via systemctl): Warning: jenkins.service changed on disk. Run 'systemctl daemon-reload' to reload units.

解决方案：执行命令 systemctl daemon-reload

再次启动即可成功： 重启命令>service jenkins restart

#### 4.访问 web 页面进行配置 ####

[![alt][alt 3]

![alt 3][]][alt_alt 3_ _alt 3]

解锁 Jenkins

[![alt][alt 4]][alt_alt 4]

[![alt 4][]][alt_alt 4]

执行命令查看秘钥：

cat /var/lib/jenkins/secrets/initialAdminPassword

插件安装选择推荐插件，插件安装完成以后将会创建管理员账户

点击保存完成，就可以使用 Jenkins 了.

**错误一**

使用 Jenkins 过程时会出现错误如下：

HTTP ERROR 403 No valid crumb was included in the

解决方案如下：

在 /etc/sysconfig/jenkins 文件下，找到 JENKINS\_JAVA\_OPTIONS

JENKINS\_JAVA\_OPTIONS="-Djava.awt.headless=true -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE\_CSRF\_PROTECTION=true"

**错误二：**

Jenkins 首次启动卡在启动界面：

解决方案如下：

在 /var/lib/jenkins/hudson.model.UpdateCenter.xml 文件下，你需要修改下配置文件，因为你所在网络被限制了。  
需要你进入 jenkins 的工作目录，打开 hudson.model.UpdateCenter.xml  
把 http://updates.jenkins-ci.org/update-center.json 改成 http://mirror.xmission.com/jenkins/updates/update-center.json

**错误三：**

错误二如果还是没有解决的话，尝试修改 /var/lib/jenkins/updates/default.json 中修改第一行的访问网址：

http://www.google.com/ 改为 http://www.baidu.com/

错误四：

Jenkins 配置域名后报 from accessing a cross-origin frame 可能是出现了 Jenkins 的跨域问题,同时也为了防止是 Nginx 那边的错误,Nginx 和 Jenkins 同时都配置跨域：

[![alt][alt 5]][alt_alt 5]

[![alt 5][]][alt_alt 5]  [![alt][alt 6]

![alt 6][]][alt_alt 6_ _alt 6]

#静态资源直接访问 Nginx
    location / {
        add_header Access-Control-Allow-Origin *;
        add_header Access-Control-Allow-Headers "Origin, X-Requested-With, Content-Type, Accept";
        add_header Access-Control-Allow-Methods "GET, POST, OPTIONS";
        proxy_pass          http://localhost:8080;
        proxy_read_timeout  90s;
    }

如果上面的配置无法解决错误的话,可能是下面的错误问题出现了
    Jenkins 原因分析：X-Frame-Options惹得祸
    X-Frame-Options HTTP 响应头是用来给浏览器指示允许一个页面可否在 <frame>, <iframe> 或者 <object> 中展现的标记。
    网站可以使用此功能，来确保自己网站的内容没有被嵌到别人的网站中去，也从而避免了点击劫持 (clickjacking) 的攻击。
    
    使用 X-Frame-OptionsEDIT
    X-Frame-Options 有三个值:
    
    DENY
    表示该页面不允许在 frame 中展示，即便是在相同域名的页面中嵌套也不允许。
    SAMEORIGIN
    表示该页面可以在相同域名页面的 frame 中展示。
    ALLOW-FROM uri
    表示该页面可以在指定来源的 frame 中展示。
    换一句话说，如果设置为 DENY，不光在别人的网站 frame 嵌入时会无法加载，在同域名页面中同样会无法加载。
    另一方面，如果设置为 SAMEORIGIN，那么页面就可以在同域名页面的 frame 中嵌套。

先在 Jenkins 中安装 X-Frame-OptionsEDIT 插件,然后重新启动,修改如下配置即可:

[![alt][alt 7]

![alt 7][]][alt_alt 7_ _alt 7]  [![alt][alt 8]

![alt 8][]][alt_alt 8_ _alt 8]

### 二、卸载 ###

卸载 yum 方式安装的 Jenkins (默认安装主目录是在 /var/lib/jenkins/)

service jenkins stop

yum clean all

yum \-y remove jenkins

find / \-iname jenkins | xargs \-n 1000 rm \-rf

#### *相关* ####

[alt]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/11/6066f0ee55124344adc9f7b5c24c71d6.png
[alt 1]: https://i0.wp.com/www.vnjohn.com/wp-content/uploads/2020/09/install_jdk-1024x457-1.png
[alt 2]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/install_jdk.png?resize=1261%2C563
[alt_alt 2_ _alt 2]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/install_jdk.png
[alt 3]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/unlock_jenkins.png?resize=1236%2C584
[alt_alt 3_ _alt 3]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/unlock_jenkins.png
[alt 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/11/74ae3aba785948888c5b9376f21101f6.png?resize=1024%2C484
[alt_alt 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/11/74ae3aba785948888c5b9376f21101f6.png
[alt 5]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/nginx-p.png?resize=1241%2C888
[alt_alt 5]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/nginx-p.png
[alt 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/11/9578bd55709b4558a120ba2e9a08f1bb.png
[alt_alt 6_ _alt 6]: https://i0.wp.com/www.vnjohn.com/wp-content/uploads/2020/09/nginx-p.png
[alt 7]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/jenkins_plugin.png?resize=1850%2C510
[alt_alt 7_ _alt 7]: https://i0.wp.com/www.vnjohn.info/wp-content/uploads/2020/09/jenkins_plugin.png
[alt 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/11/c2b65460853045fc973b17d1f9b722ba.png
[alt_alt 8_ _alt 8]: https://i0.wp.com/www.vnjohn.com/wp-content/uploads/2020/09/jenkins_plugin.png