在 CentOS 8 上搭建 GitLab 与 Jenkins 开发环境
本文详细说明如何在 CentOS 8 系统中安装并配置 GitLab 和 Jenkins,整个过程使用 root 权限执行。系统镜像体积约 8.2GB,建议提前准备。
系统基础配置
安装 CentOS 8 时,软件选择仅勾选 Server 即可,无需附加软件。完成安装后,建议关闭防火墙和 SELinux 以简化配置:
# 关闭 SELinux
vi /etc/selinux/config
# 将 SELINUX=enforcing 改为 SELINUX=disabled
# 关闭 firewalld
systemctl stop firewalld
systemctl disable firewalld
常见问题处理
无法获取 Yum 源数据
如果出现 "为 repo 'appstream' 下载元数据失败" 错误,执行以下命令更换源:
sudo sed -i -e "s|mirrorlist=|#mirrorlist=|g" /etc/yum.repos.d/CentOS-*
sudo sed -i -e "s|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g" /etc/yum.repos.d/CentOS-*
网络连接异常
若网络通但无法 Ping 通外部地址,检查网卡配置:
vim /etc/sysconfig/network-scripts/ifcfg-ens160
# 确保以下参数设置正确
BOOTPROTO=dhcp # 动态 IP 获取
ONBOOT=yes # 开机自动激活网卡
调整后若仍无效,检查 NetworkManager 状态:
# 查看 NM 托管状态
nmcli n
# 若为 disabled,执行以下命令
nmcli n on
# 重启网卡
nmcli c up ens160
# 测试连通性
ping www.baidu.com
GitLab 部署
建议服务器配置 4GB 内存和 4 核 CPU。从以下源获取安装包:
- 官方源:https://packages.gitlab.com/gitlab/gitlab-ce
- 清华镜像:https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el8/
# 安装必要组件
dnf -y install policycoreutils-python-utils
# 将下载的 RPM 包上传至服务器(示例为 14.7.6 版本)
scp gitlab-ce-14.7.6-ce.0.el8.x86_64.rpm root@192.168.1.100:/root
# 安装 RPM 包
rpm -ivh gitlab-ce-14.7.6-ce.0.el8.x86_64.rpm
# 配置外部访问地址
vi /etc/gitlab/gitlab.rb
# 找到第 32 行,修改为 external_url 'http://你的IP地址'
# 初始化 GitLab 实例
gitlab-ctl reconfigure
# 初始管理员账户信息
# 用户名:root
# 密码位于 /etc/gitlab/initial_root_password
# 重启服务
gitlab-ctl restart
浏览器访问配置的 IP 地址即可登录。若出现 502 错误,请耐心等待数分钟让服务完全启动。
Jenkins 部署
从镜像站获取安装包:清华大学开源软件镜像站
# 安装 Java 运行环境
yum -y install java-11-openjdk
# 如果使用手动下载的 RPM 包,通过 scp 上传并安装
yum localinstall jenkins-2.350-1.1.noarch.rpm
# 启动 Jenkins 并设为开机自启
systemctl start jenkins
systemctl enable jenkins
# 首次登录密码位置
cat /var/lib/jenkins/secrets/initialAdminPassword
浏览器访问服务器 IP 的 8080 端口。插件安装建议选择推荐安装,但服务器在国外可能很慢。若安装失败,可手动替换插件:
# 停止服务
systemctl stop jenkins
# 将本地准备好的 plugins 目录复制到服务器
scp -r ./plugins/* root@192.168.1.100:/var/lib/jenkins/plugins
# 重启服务
systemctl start jenkins
这样可跳过插件安装步骤并保留本地已有的插件。