CentOS中GitLab配置步骤是什么
小樊
41
2025-12-07 13:58:10
CentOS 中 GitLab 配置步骤
一 环境准备与安装
- 更新系统并安装依赖:sudo yum update -y && sudo yum install -y curl policycoreutils-python openssh-server perl
- 启动并开机自启 SSH:sudo systemctl enable --now sshd
- 放行防火墙端口:sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
- 添加 GitLab 仓库:curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
- 安装 GitLab(CE 社区版):sudo EXTERNAL_URL=“http://your-domain-or-ip” yum install -y gitlab-ce
(以上步骤完成基础运行环境与软件包安装)
二 核心配置与生效
- 编辑主配置文件:sudo vi /etc/gitlab/gitlab.rb
- 设置访问地址:external_url ‘http://your-domain-or-ip’(如 http://10.20.0.116 或 http://gitlab.example.com)
- 使配置生效:sudo gitlab-ctl reconfigure
- 常用运维命令:
- 启动/停止/重启:sudo gitlab-ctl start|stop|restart
- 查看状态:sudo gitlab-ctl status
- 查看日志:sudo gitlab-ctl tail(或 tail nginx/gitlab_access.log / gitlab_error.log)
(修改 gitlab.rb 后必须执行 reconfigure 才会应用到各组件)
三 邮件通知配置(可选)
- 在 /etc/gitlab/gitlab.rb 中启用并填写 SMTP(示例使用 STARTTLS 端口 587):
- gitlab_rails[‘smtp_enable’] = true
- gitlab_rails[‘smtp_address’] = “smtp.example.com”
- gitlab_rails[‘smtp_port’] = 587
- gitlab_rails[‘smtp_user_name’] = “your-email@example.com”
- gitlab_rails[‘smtp_password’] = “your-password”
- gitlab_rails[‘smtp_authentication’] = “login”
- gitlab_rails[‘smtp_enable_starttls_auto’] = true
- gitlab_rails[‘smtp_tls’] = true
- gitlab_rails[‘gitlab_email_from’] = ‘your-email@example.com’
- gitlab_rails[‘smtp_domain’] = “example.com”
- 使配置生效:sudo gitlab-ctl reconfigure
(完成后可在管理后台测试邮件发送)
四 访问与初始化
- 在浏览器访问:http://your-domain-or-ip
- 首次访问按页面提示设置管理员账户(用户名通常为 root)的密码,随后即可登录使用
(如需使用域名,请确保 DNS 解析已指向服务器 IP)
五 常见问题与扩展
- 版本选择:安装命令中的 gitlab-ce 为社区版;如需企业版,将 ce 替换为 ee(EXTERNAL_URL 不变)
- 防火墙要点:确保放行 80/443;如使用云服务器,还需在云平台安全组放行对应端口
- Runner 与 CI(可选):安装 Runner 并注册到实例,用于执行 CI/CD 任务
- 安装:curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
- 注册:sudo gitlab-runner register --url https://YOUR_GITLAB_URL/ --registration-token YOUR_TOKEN
- 日志排查:组件异常可用 sudo gitlab-ctl tail 查看实时日志,定位问题更高效