CentOS7.x 搭建 GitLab 教程
今天闲来无事,想起之前买了一个阿里云 ECS,一直闲置着没用,一时兴起就想搭个自己的 GitLab 玩玩,GitLab 官网也提供了安装教程,很简单,照着步骤一步步基本没什么问题,可能安装的过程中有一些坑需要自己去解决。
1.安装 GitLab
打开 GitLab 官网 https://www.gitlab.com.cn/installation/#centos-7
根据自己的系统选择,我们选择 CentOS7
首先,安装并配置必要的依赖关系,确保打开防火墙的 SSH 和 HTTP 的访问,如果没有,需要您输入下面命令打开
sudo yum install -y curl policycoreutils-python openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo systemctl reload firewalld
接下来安装 Postfix 发送邮件通知服务,或者如果您想使用其他方式(SMTP)来发送电子邮件,请跳过此步骤,并在安装了 GitLab 之后配置一个外部SMTP服务器。
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
添加 GitLab 包仓库并安装包
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash
接下来,安装 GitLab 包,将 “http://gitlab.example.com” 更改为您想要访问 GitLab 的URL,安装将自动配置并在使用该 URL 来访问 GitLab,HTTPS 需要安装完成后来配置。
温馨提示:此处如果设置为域名访问,如果域名没有备案就会出现无法访问,如果不想备案网站域名,那么此处直接配置为服务器的公网 IP 即可。
因为我配置的是域名,因为我的域名没有备案,所以我访问的时候提示我备案域名,如下图:
配置完成后就开始下载并安装,过程大概会持续一个小时左右,视服务器具体带宽而定。
如果 GitLab 已经安装完成,并且你已经配置了域名想要修改配置变成 ip,按如下步骤执行命令:
vim /etc/gitlab/gitlab.rb
找到 external_url 设置为你的 IP + 端口即可,注意这里设置的端口不能被占用,默认是 8080 端口,如果 8080 已经使用,请自定义其它端口,并在防火墙设置开放相对应的端口。
然后重置并启动 GitLab 执行:
gitlab-ctl reconfigure
gitlab-ctl restart
然后执行:
gitlab-ctl status
查看 GitLab 运行状态是否正常
访问 GitLab 页面:
输入你配置的ip或者域名来访问 GitLab,如果没有什么异常,会出现如下页面
第一次访问会提示修改密码,你需要按提示修改即可,默认账户名是 root
至此,GitLab 的安装就算完啦。
2.配置 postfix 邮件服务
发邮件系统我们用 Postfix,SMTP 系统默认是开启的,我们先设置关闭 SMTP,开启 Postfix
关闭 SMTP:
vim /etc/gitlab/gitlab.rb
找到 #gitlab_rails['smtp_enable'] = true
改为 gitlab_rails['smtp_enable'] = false
修改后执行
gitlab-ctl reconfigure
另一种是关闭 Postfix,设置开启 SMTP,相关教程请参考官网
https://doc.gitlab.cc/omnibus/settings/smtp.html
此处以配置 163 邮箱为例:
gitlab_rails[‘smtp_enable’] = true
gitlab_rails[‘smtp_address’] = “smtp.163.com”
gitlab_rails[‘smtp_port’] = 25
gitlab_rails[‘smtp_user_name’] = “xxx@163.com”
gitlab_rails[‘smtp_password’] = “xxx”
gitlab_rails[‘smtp_domain’] = “163.com”
gitlab_rails[‘smtp_authentication’] = :login
gitlab_rails[‘smtp_enable_starttls_auto’] = true
gitlab_rails[‘gitlab_email_from’] = “xxx@163.com”
user[“git_user_email”] = “xxx@163.com”
登录到 GitLab 并添加一个 GitLab 账户,并添加设置用户的邮箱地址,测试是否可以收到邮件通知,如果创建完成,设置的邮箱收到邮件说明邮件服务没有问题,注意如果没有收到邮件,有时候邮箱会拦截邮件,你在垃圾邮件中看看是否邮件被拦截,如果被拦截,你可以将此邮件添加到白名单中。
3.其他异常情况处理
另外,如果 访问 GitLab 时的速度非常慢,或者报 502 错误,如下图
可能是你的服务器配置太低,GitLab 官方建议装 GitLab 的服务器的配置最低要求为:CPU 2核心 + 4GB可用内存(RAM + Swap)。 如果服务器配置过低,可能导致您访问 GitLab的速度过慢,甚至会出现无响应等状况。
提示 FirewallD is not running
说明防火墙未开启,
执行 systemctl status firewalld
如果出现 Active: inactive (dead)
表示防火墙未开启。
开启防火墙 systemctl start firewalld
再次查看防火墙状态,如果出现 Active: active (running)
表示防火墙开启成功。
欢迎关注我的微信公众号: