我的docker随笔37：使用gitlab和jenkins实现CICD

2021-08-28 00:00 docker 1.3k 字次

本文涉及一种利用容器部署 gitlab 和 jenkins 服务实现持续集成（CICD）的方法，其目的是为了在实际工作中使用代码托管及自动化操作。

一、引言

因工作需要，需部署 gitlab 和 jenkins 服务器进行 CICD 测试，换个高大上的名称，叫“组织革新”。本文记录个人的实践，但不涉及部署的具体步骤。

二、技术小结

不同工程，配置不同，本文使用 C++ 工程为例进行实验。
在配置 jenkins 时，建议经常使用页面下方的“应用”，随时保存设置好的参数，以防不测。

三、gitlab和jenkins联调

3.1 概述

实现CICD分几个阶段：使用 gitlab 托管代码，使用 jenkins 进行编译、打包以及发布。两个服务器各有项目对应，同时要进行必要的配置。不同项目，配置方式不尽相同。本节的配置原则上按顺序进行，因此会到 gitlab 和 jenkins 之间来回切换，故先行说明。

3.2 前置条件

3.2.1 允许本地网络请求

使用 root 用户登录 gitlab 服务器，在管理员配置选项选择网络(Setting)**页面，在外发请求（Outbound requests）中，选择“允许Webhook和服务对本地网络的请求(Allow requests to the local network from web hooks and services)**”，保存。如图1所示。

进行该设置的目的是因为本文的 gitlab 和 jenkins 服务均在同一物理服务器上使用 docker 部署。如果不设置，则在 gitlab 中设置 webhooks 时会提示Url is blocked: Requests to the local network are not allowed。

说明：如果jenkins和gitlab不在同一服务器，则不需要进行此设置。

3.2.2 关闭 CSFR

进入 jenkins 容器，找到/usr/local/bin/jenkins.sh文件，找到 exec java 行，在-Duser.home="$JENKINS_HOME"后添加 -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true，完整的一行语句如下：

1	exec java -Duser.home="$JENKINS_HOME" -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true "${java_opts_array[@]}" -jar ${JENKINS_WAR} "${jenkins_opts_array[@]}" "$@

说明：在笔者定制的 jenkins 镜像中已经进行该修改了。

进行该设置，是因为高版本 Jenkins 无法在界面关闭跨站请求伪造保护（CSRF），因为在 gitlab 进行 webhooks 时会认证失败。提示：

1	Hook executed successfully but returned HTTP 403

关闭之后，再次进行 CSFR 页面，提示：

1	This configuration is unavailable because the System property hudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION is set to true.

说明修改成功。

对于物理机部署的 jenkins，则在 /etc/sysconfig/jenkins 文件中找到 JENKINS_JAVA_OPTIONS，设置如下：

JENKINS_JAVA_OPTIONS=”-Djava.awt.headless=true -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true”