CentOS中GitLab配置步骤是什么

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 查看实时日志，定位问题更高效