在CentOS 7环境下安装和配置GitLab教程

GitLab是一款功能强大的开源代码管理工具，支持Git仓库的管理，并且为团队协作、CI/CD提供了强大的支持。在CentOS 7上安装和配置GitLab，可以满足开发团队内部或者外部的代码托管需求。本文将详细介绍如何在CentOS 7上安装和配置GitLab，包括依赖项安装、仓库配置、防火墙设置等步骤。

一、安装和配置依赖项

1.1 更新系统并安装依赖项

在开始安装GitLab之前，您需要确保系统是最新的，并安装所需的依赖项。通过以下步骤来完成：

• 更新系统：

yum update -y

• 安装 curl、openssh-server 和 postfix：

yum install -y curl openssh-server postfix

curl 用于下载GitLab仓库的安装脚本，openssh-server 提供GitLab与Git客户端的SSH通信功能，postfix 用于发送邮件通知。

1.2 启动并设置SSH和Postfix服务

• 启动 sshd 和 postfix 服务，并设置为开机自启：

systemctl enable sshd
systemctl start sshd
systemctl enable postfix
systemctl start postfix

二、添加GitLab仓库并安装GitLab

2.1 添加GitLab仓库

使用 curl 命令下载GitLab仓库并运行安装脚本：

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash

这个命令会自动配置GitLab的社区版仓库，确保后续可以使用 yum 命令进行安装。

2.2 安装GitLab社区版

在添加仓库之后，您可以通过以下命令安装GitLab社区版：

yum install -y gitlab-ce

此命令将下载并安装GitLab的所有必要组件。

三、配置GitLab

3.1 配置外部URL

GitLab安装完成后，您需要配置GitLab的外部URL，以便正确访问和使用GitLab服务。编辑GitLab的主配置文件 /etc/gitlab/gitlab.rb：

nano /etc/gitlab/gitlab.rb

在文件中找到 external_url 字段，并将其设置为您的服务器域名或IP地址。例如：

external_url 'http://your_domain_or_IP'

3.2 可选配置：邮件服务（SMTP）

如果需要设置SMTP来发送邮件通知，可以在 /etc/gitlab/gitlab.rb 文件中添加或修改邮件配置。以下是一个简单的SMTP配置示例：

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_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

确保保存并关闭文件。

3.3 重新配置GitLab

修改配置文件后，运行以下命令应用更改并完成GitLab的配置：

gitlab-ctl reconfigure

此命令会根据配置文件中的内容初始化GitLab，并启动必要的服务。

四、访问和使用GitLab

4.1 通过浏览器访问GitLab

在浏览器中访问您在 external_url 中配置的地址（例如 http://your_domain_or_IP），首次访问时系统会要求您设置管理员账号的密码。

• 输入管理员密码并登录。
• 之后您可以创建新项目、管理用户、配置仓库等。

五、配置防火墙

如果您的CentOS 7服务器上启用了防火墙，则需要确保允许HTTP、HTTPS和SSH端口的访问，以便外部能够连接到GitLab。

5.1 开放HTTP、HTTPS和SSH端口

使用以下命令开放所需端口：

firewall-cmd --permanent --zone=public --add-service=http
firewall-cmd --permanent --zone=public --add-service=https
firewall-cmd --permanent --zone=public --add-service=ssh
firewall-cmd --reload

• HTTP：GitLab通过80端口提供网页服务。
• HTTPS：如果启用了SSL，GitLab通过443端口提供加密的网页服务。
• SSH：通过22端口提供Git的SSH访问。

5.2 验证防火墙配置

通过以下命令检查防火墙是否正确配置：

firewall-cmd --list-all

确认 http、https 和 ssh 端口均已开放。

六、常用GitLab命令

GitLab提供了一系列管理命令，用于控制GitLab服务和监控其运行状态。

6.1 GitLab服务管理命令

• 重启GitLab：

gitlab-ctl restart

• 查看GitLab服务状态：

gitlab-ctl status

• 停止GitLab：

gitlab-ctl stop

• 启动GitLab：

gitlab-ctl start

6.2 查看日志

• 查看GitLab日志以排查问题：

gitlab-ctl tail

此命令会显示GitLab的实时日志输出。

七、总结

通过本教程，您可以在CentOS 7系统上快速安装并配置GitLab服务。GitLab的安装过程比较简单，配置外部访问URL、防火墙设置以及服务管理命令的使用是确保GitLab正常运行的关键步骤。

GitLab安装配置流程说明表

通过遵循这些步骤，您可以在内网或外网环境中高效地部署GitLab服务，并根据需要进一步优化其配置以适应团队协作和代码管理需求。