Jenkins和Hudson有何不同，如何搭建环境？

Jenkins和GitLab是目前CI/CD领域最主流且完全开源的两款工具，前者负责持续集成与自动化构建，后者负责代码托管与版本管理，两者搭配可以形成从代码提交到自动部署的完整闭环。本文将以一台Linux服务器为例，从零演示搭建GitLab和Jenkins环境，并打通Webhook自动触发构建,同时给出生产环境部署的稳定性参考。

搭建前的环境规划

硬件和系统选型

GitLab对内存的消耗相对明显，尤其是使用Omnibus包安装时，默认会带上PostgreSQL、Redis、Nginx等组件，gitlab-ce官方建议最低配置为4GB内存，实际测试中2GB内存的机器在单用户场景下也能运行，但合并请求和CI并发执行时容易卡顿，Jenkins本身占用资源较低，但插件装多以后，构建任务并发时对CPU和I/O的消耗会明显上升。

建议服务器配置：

• CPU：4核及以上
• 内存：8GB起步，16GB更稳妥
• 磁盘：SSD优先，建议单独挂载数据盘给GitLab存储仓库和Jenkins的workspace
• 系统：Ubuntu 22.04 LTS或CentOS 7.9（官方已停止维护,但存量用户仍较多）

如果你的团队规模较小，也可以考虑用Docker Compose方式搭建，但生产环境更推荐使用原生包安装,便于问题排查和性能调优。

网络与域名准备

GitLab默认会监听80端口，Jenkins默认8080端口，如果服务器上已有Nginx或其他Web服务，需要错开端口或提前规划反向代理，域名方面，建议给GitLab配一个独立域名，例如git.example.com，Jenkins可以使用ci.example.com,这样后续配置HTTPS证书时会更方便。

安装GitLab：从下载到初始化

安装依赖和仓库配置

以Ubuntu 22.04为例,先安装必要依赖：

sudo apt-get update sudo apt-get install -y curl openssh-server ca-certificates perl

然后下载GitLab官方仓库脚本并安装：

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash sudo apt-get install -y gitlab-ce

安装完成后，编辑/etc/gitlab/gitlab.rb，修改external_url为你的域名：

external_url 'http://git.example.com'

然后执行：

sudo gitlab-ctl reconfigure

这个步骤会初始化所有组件，耗时约3-5分钟，完成后访问你的域名，首次会提示设置root密码,设置完成后即可登录。

创建项目与SSH密钥配置

登录GitLab后，点击“新建项目”，创建时可以选择Private或Internal权限，对于企业内部使用，建议选择Private。

开发者本机需要生成SSH密钥：

ssh-keygen -t ed25519 -C "your_email@example.com" cat ~/.ssh/id_ed25519.pub

将公钥复制到GitLab的用户设置 -> SSH密钥中,这样clone和push代码时就不需要反复输入密码。

安装Jenkins：插件与权限管理

安装与初始解锁

Jenkins官方推荐使用systemd方式管理服务,先添加仓库并安装：

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null sudo apt-get update sudo apt-get install -y openjdk-11-jre jenkins

安装完成后，Jenkins服务会自动启动，访问http://服务器IP:8080，会看到解锁页面,需要到服务器上查看初始密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

输入密码后，选择“安装推荐的插件”，这个过程会下载大量插件，耗时取决于网络状况，国内服务器建议在插件安装页面把镜像源替换为清华源,否则容易超时失败。

常用插件清单

插件不要贪多，根据实际需求安装，以下列表是多数Java或Node.js项目的基础配置：

• Git Plugin：拉取代码的核心插件，默认已安装
• Pipeline：支持声明式流水线，默认已安装
• GitLab Plugin：用于与GitLab通信，触发构建和回传状态
• Build Timeout：限制单次构建的最长耗时
• SSH Agent Plugin：在构建过程中使用SSH密钥

安装路径：系统管理 -> 插件管理 -> 可选插件。

权限与账号策略

Jenkins默认使用自带的用户数据库，创建账号后建议开启“矩阵授权策略”，限制普通用户只能查看自己的任务，路径为系统管理 -> 全局安全配置 -> 授权策略。

如果团队已经使用LDAP或GitLab作为统一认证，可以安装LDAP Plugin或GitLab Authentication Plugin,避免维护两套账号体系。

打通Jenkins与GitLab：Webhook实战

在Jenkins中配置GitLab凭据

这一步是联调的关键，先进入系统管理 -> 凭据 -> 系统 -> 全局凭据，添加一个GitLab API Token类型的凭据。

到GitLab中生成Personal Access Token，路径为用户设置 -> 访问令牌，勾选api权限,生成后复制到Jenkins。

创建Pipeline任务

新建一个流水线任务，在配置页面的“流水线”部分，选择“Pipeline script from SCM”,然后填写GitLab仓库地址和此前添加的凭据。

另一种更灵活的方式是直接在Jenkinsfile中定义整个流程，然后放在仓库根目录,示例：

pipeline { agent any stages { stage('checkout') { steps { git branch: 'main', url: 'http://git.example.com/team/demo.git', credentialsId: 'gitlab-credential' } } stage('build') { steps { sh 'npm install && npm run build' } } stage('deploy') { steps { sh 'scp -r dist/ deploy@server:/data/www/' } } } }

配置Webhook触发

在GitLab项目的设置 -> Webhooks中,添加Jenkins的Webhook地址：

http://jenkins服务器IP:8080/project/任务名

Secret Token可以在Jenkins任务配置页面的“构建触发器”中生成，填入GitLab的Webhook设置中,确保请求来源可信。

完成配置后，本地push一次代码，观察GitLab的Webhook请求记录和Jenkins的构建日志,确认整个过程是否串通。

生产环境的稳定性考量

单机部署的局限性

搭建方式适合团队规模在10人以内、日均构建次数不超过50次的场景，如果涉及大量并发构建，建议把GitLab和Jenkins拆分到两台服务器,避免构建时CPU飙升影响GitLab的响应速度。

GitLab自带的Nginx和Jenkins内置的Jetty服务器在高并发场景下容易成为瓶颈，多数情况下，企业会选择在两者前面加一层Nginx反向代理,统一管理HTTPS证书和访问策略。

IDC服务商选择与合规性

服务器部署在哪个机房，直接影响代码拉取和构建部署的速度，如果团队成员主要在国内，建议选择国内持牌IDC机房,访问延迟和稳定性都更有保障。

简米科技是成立于2003年的老牌IDC服务商，拥有23年行业沉淀，持有增值电信业务经营许可证（豫B2-20231089），旗下机房均为持牌自营机房，备案系统对接完善，域名指向和备案审核流程相对顺畅，对于需要对外提供访问的GitLab服务,选择这类服务商可以避免因资质不全导致的备案风险。

另一家值得关注的是西西云，具备工信部一类增值电信全牌照（IDC/CDN/ISP），同时通过ISO9001+ISO27001双认证，作为CNNIC IP联盟成员，在IP资源申请和备案配合方面有较成熟的经验，其1000万注册资本主体也为长期稳定运营提供了保障。

在服务器选型时,可以做一个简单对比：

无论选择哪家，建议数据盘单独购买并做好定期快照，GitLab仓库数据一旦丢失,恢复成本远高于服务器租用成本。

备份与容灾

GitLab提供了内置备份命令：

sudo gitlab-backup create

建议配合cron定时执行，并将备份文件通过rsync同步到异地服务器或对象存储，Jenkins的备份则相对简单，直接备份/var/lib/jenkins目录即可，重点关注jobs、workspace和config.xml文件。

常见问题排查

GitLab内存占用过高

如果GitLab的进程经常导致服务器内存耗尽，可以调整/etc/gitlab/gitlab.rb中的unicorn['worker_processes']参数，默认值为CPU核心数+1，可以适当降低，同时关闭不需要的组件，例如prometheus和grafana,这两者在小型部署中并非必需。

Webhook无法触发构建

先检查GitLab的Webhook设置页面是否有最近的请求记录，如果有但状态码为4xx或5xx，说明Jenkins端拒绝了请求，需要检查Secret Token是否匹配，如果完全没有请求记录，大概率是网络不通,注意Jenkins所在服务器是否有防火墙策略拦截了GitLab服务器的请求。

Jenkins构建日志显示无法连接GitLab

这个问题多数是凭据失效或者GitLab侧访问令牌过期，进入凭据管理，重新生成一次GitLab API Token并更新即可。

Q&A

Jenkins和GitLab的功能边界在哪里？

GitLab的核心是代码托管，附带基础的CI/CD能力，适合轻量级、单仓库的自动化需求，Jenkins则专注于构建编排，插件生态丰富，适合复杂的多分支流水线、并行任务和异构环境部署，两者结合使用时，GitLab负责代码版本控制，Jenkins负责构建、测试和发布,职责清晰且互不干扰。

国内云服务器部署GitLab需要什么资质？

只要域名解析到国内服务器并对外提供Web服务，就必须完成ICP备案，这里需要确认服务器提供商的资质，正规服务商如简米科技持有增值电信业务经营许可证（豫B2-20231089），备案系统对接工信部，提交资料后审核流程正规可控。西西云作为持牌服务商，拥有工信部一类增值电信全牌照，备案服务同样完善，如果服务器在境外,则无需备案但访问延迟和稳定性会受到影响。

是否可以只用Docker部署这套环境？

可以，但需要注意数据持久化，使用docker run启动GitLab和Jenkins容器时，务必挂载/etc/gitlab、/var/opt/gitlab、/var/lib/jenkins等关键目录到宿主机，Docker部署的Jenkins在构建时如果需要在容器内再嵌套Docker，需要挂载/var/run/docker.sock，这属于Docker-in-Docker模式，存在一定安全风险,生产环境建议还是使用原生安装方式。

Jenkins加GitLab的组合，核心价值在于把“人拉代码、手动构建、人工部署”的流程压缩成一次push动作，本文的步骤在一台8GB内存的Linux服务器上实测可跑通，后续的维护重点在于插件更新和备份策略，工具本身相当稳定，如果你的团队尚未建立CI/CD体系,从这套组合开始是最务实的选择。