CentOS环境下GitLab社区版的部署与深度配置实践
环境准备与依赖安装
在CentOS系统中部署GitLab,需确保服务器物理内存不低于2GB。首先安装基础依赖组件,包括SSH服务、防火墙管理工具、Postfix邮件传输代理以及网络下载工具,并配置防火墙放行HTTP与SSH端口。
获取并安装GitLab核心组件
通过命令行工具下载指定版本的GitLab社区版RPM安装包,并执行本地安装。
# 下载GitLab CE安装包
curl -O https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-10.0.0-ce.0.el7.x86_64.rpm
# 执行RPM包安装
sudo rpm -Uvh --nodeps gitlab-ce-10.0.0-ce.0.el7.x86_64.rpm
重构核心配置文件
编辑GitLab的主配置文件,自定义外部访问URL、运行用户以及内置Nginx和Unicorn的监听参数。请确保所选端口未被系统其他服务占用。
# 定义外部访问URL及端口
external_url 'http://192.168.233.135:8099'
# 配置运行用户与用户组
git_user = 'git'
git_group = 'git'
user['username'] = git_user
user['group'] = git_group
# 配置Unicorn工作进程监听地址与端口
unicorn['listen'] = '127.0.0.1'
unicorn['port'] = 8098
# 配置内置Nginx参数
nginx['enable'] = true
nginx['client_max_body_size'] = '250m'
nginx['redirect_http_to_https'] = false
nginx['listen_addresses'] = ['*', '[::]']
nginx['listen_port'] = 8099
服务初始化与状态验证
配置完成后,重新生成GitLab配置并重启相关服务。当终端输出 "ok: run:" 时,即表示服务启动成功。
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart
重置超级管理员凭证
通过GitLab内置的Rails控制台,可以直接修改root用户的登录密码。
# 进入生产环境Rails控制台
sudo gitlab-rails console -e production
在控制台中执行以下Ruby代码以更新管理员密码:
# 获取管理员实例
admin_account = User.find_by(id: 1)
new_password = 'SecurePass@2023!'
# 设置新密码及确认密码
admin_account.password = new_password
admin_account.password_confirmation = new_password
# 提交更改并验证结果
if admin_account.save!
puts "Password updated successfully."
else
puts "Failed to update password."
end
# 退出控制台
exit
应用中文语言包补丁
针对特定版本进行界面汉化,需获取对应的中文差异补丁并应用至GitLab核心目录。
# 安装Git工具
sudo yum install -y git
# 克隆中文语言包仓库并切换至目标版本分支
git clone https://gitlab.com/xhang/gitlab.git /tmp/gitlab-zh
cd /tmp/gitlab-zh
git checkout v10.0.0-zh
# 生成版本差异补丁文件
git diff v10.0.0 v10.0.0-zh > /tmp/gitlab-zh-patch.diff
# 停止GitLab服务以准备应用补丁
sudo gitlab-ctl stop
# 将补丁应用到GitLab核心Rails目录
sudo patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < /tmp/gitlab-zh-patch.diff
# 重新配置并启动服务
sudo gitlab-ctl reconfigure
sudo gitlab-ctl start
服务重启后,建议等待十余秒再刷新浏览器页面,以避免因服务未完全就绪而返回502错误。