Centos7.6安装Gitlab教程及注意事项

本文参考Linux（Centos7.6）下安装Gitlab详细教程

作者以 CentOS7.6 虚拟机为例子进行搭建GitLab；
如果使用阿里云服务器的情况下，是不需要配置防火墙的，需要进入阿里云服务器的控制台，找到安全组配置，将对应的端口号进行开放或关闭即可

1、查看Linux系统版本确认gitlab需要使用的安装包类型

使用命令：cat /etc/redhat-release
CentOS Linux release 7.6.1810 (Core)
本系统是CentOS 7，对应官方教程地址：https://about.gitlab.com/install/#centos-7We strongly recommend downloading the Omnibus package installation since it is quicker to install, easier to upgrade, and it contains features to enhance reliability not found in other methods.
We also strongly recommend at least 4GB of free RAM to run GitLab.


2、安装 curl，policycoreutils-python，openssh-server服务

使用命令：

yum install -y curl policycoreutils-python openssh-server


出现以下界面，说明成功

3、将SSH服务设置成开机自启动

systemctl enable sshd


4、启动SSH服务

systemctl start sshd


5、开启防火墙 - 阿里云不需要，去控制台

systemctl start firewalld或者service firewalld start


6、添加http服务到firewalld

允许http服务通过, pemmanent表示永久生效，若不加–permanent系统下次启动后就会失效

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https


7、重启防火墙

（sudo） systemctl reload firewalld


8、接下来，安装Postfix以发送通知邮件，并将postfix服务设置成开机自启动

Linux centos 查看postfix已经安装 rpm -qa |grep postfix,如果安装过，则无需安装。
安装postfix：
命令：sudo yum install postfix
设置postfix自启动
命令：sudo systemctl enable postfix


9、启动Postfix

命令：sudo systemctl start postfix


可能会启动失败：Job for postfix.service failed because the control process exited with error code. See “systemctl status postfix.service” and “journalctl -xe” for details.
这是因为防火墙或者配置文件导致，无法启动的邮件服务，首先关闭防火墙，修改配置文件vim /etc/postfix/main.cf
把inet_interfaces = localhost注释掉，把inet_interfaces = all的注释打开，然后就可以启动了。

可以通过命令：systemctl status postfix查看是否启动成功，下图所示标识启动成功

10、下载镜像

官网链接：https://packages.gitlab.com/gitlab/gitlab-ee/packages/el/7/gitlab-ee-12.5.4-ee.0.el7.x86_64.rpm
使用命令下载镜像：

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


出现下图所示，标识reposity镜像下载成功:

安装镜像：

sudo yum install -y gitlab-ee-12.5.4-ee.0.el7.x86_64


出现下图所示，标识安装成功

11、修改gitlab配置文件指定服务器ip和自定义端口

vim /etc/gitlab/gitlab.rb


使extenal_url指向自己的ip：extenal_url=”http://ip:8888”

12、刷新配置GitLab

gitlab-ctl reconfigure


这个过程有点慢

13、重置并启动GitLab

命令：

gitlab-ctl start


启动成功如下图所示：

14、Gitlab常用命令：

sudo gitlab-ctl start # 启动所有 gitlab 组件；
sudo gitlab-ctl stop # 停止所有 gitlab 组件；
sudo gitlab-ctl restart # 重启所有 gitlab 组件；
sudo gitlab-ctl status # 查看服务状态；
sudo gitlab-ctl reconfigure # 启动服务；
sudo vim /etc/gitlab/gitlab.rb # 修改默认的配置文件；
gitlab-rake gitlab:check SANITIZE=true --trace # 检查gitlab；
sudo gitlab-ctl tail # 查看日志；


15、关于gitlab-ee和gitlab-ce

二者是基于同样的核心代码进行开发，只是gitlab-ee功能更强大，但需要付费使用，有30天试用期。但试用期过后如果不付费，它就跟gitlab-ce功能是完全一样的，只是需要付费的功能无法再继续使用而已，所以这两个版本可以随意选择安装，但如果将来有付费的打算，直接安装gitlab-ee版本是个有远见的选择。当然，即使不付费，gitlab-ee使用上和gitlab-ce没有任何区别，所以接下来的操作我们就以安装gitlab-ee为例进行。
如果安装gitlab-ce目前不需要使用国内镜像，如果是安装gitlab-ee就需要用到国内镜像

16、修改gitlab_gitlab-ee.repo文件

把repo_gpgcheck属性为0，以及baseurl属性为清华大学的开源镜像站地址：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ee/yum/el7

修改完成后再刷新yum源：

yum clean all
yum yum makecache


注意事项以及该文件关键 键的介绍：

1. gitlab_gitlab-ee和gitlab_gitlab-ee-source对应的地址都要换
2. name是仓库的名字
3. baseurl字段是仓库的url，也就是仓库具体的访问路径，就是通过这个选项告知yum，仓库在哪。这里可以指明多个url，如果写了多个url，yum将遵循failovermethod字段进行使用
4. enabled字段指明了该url是否启用，0为不启用，默认为1
5. gpgcheck字段指明了是否检查rpm包的签名信息、完整性信息，0为不启用，1为启用 （注意：如果启用这个字段，也就是为1时，如果没有gpgkey时，检查很可能无法通过。我们可以在命令行中使用–
   nogpgcheck选项禁止检查gpg）
6. repo_gpgcheck指明了是否检查元数据信息文件的签名信息与完整性，0为不启用，1为启用
7. gpgkey=url指明了密钥文件的url路径，有了这个密钥才能检查各种完整信息。
8. 由于gpgkey对应的地址需要FQ所以gpgcheck也需要设置为0，如果你服务器不需要FQ可以不用使用默认值1。
9. https://mirrors.tuna.tsinghua.edu.cn是国内清华大学开源镜像站，避免yum install可能会因为网络原因导致失败。

17、安装过程可能出现问题和修复方法：

问题1：1502 Whoops, GitLab is taking too much time to respond

解决方案：
修改默认端口：需要放开/etc/gitlab/gitlab.rb文件里面nginx[‘listen_port’]和unicorn[‘port’]注释并设置端口，两个端口不能相同.具体原因笔者暂时也搞不懂，没用过nginx。

nginx[&＃39;listen_port&＃39;] = 1001
unicorn[&＃39;port&＃39;] = 1002
可能是端口占用问题，unicorn


刷新gitlab配置和启动

gitlab-ctl reconfigure
gitlab-ctl restart


问题2：出现ruby_block[supervise_redis_sleep] action run停留很久

在卸载gitlab然后再次安装执行 gitlab-ctlreconfigure的时候往往会出现：ruby_block[supervise_redis_sleep] action run，会一直卡无法往下进行！

解决方案：
1、按住CTRL+C强制结束；
2、运行：sudo systemctl restart gitlab-runsvdir；
3、再次执行：sudo gitlab-ctl reconfigure


18、修改gitlab的配置文件：/etc/gitlab/gitlab.rb

gitlab_rails[&＃39;smtp_enable&＃39;] = truegitlab_rails[&＃39;smtp_address&＃39;] = "smtp.qq.com"gitlab_rails[&＃39;smtp_port&＃39;] = 465gitlab_rails[&＃39;smtp_user_name&＃39;] = "******@qq.com"gitlab_rails[&＃39;smtp_password&＃39;] = "授权码"gitlab_rails[&＃39;smtp_domain&＃39;] = "smtp.qq.com"gitlab_rails[&＃39;smtp_authentication&＃39;] = "login"gitlab_rails[&＃39;smtp_enable_starttls_auto&＃39;] = truegitlab_rails[&＃39;smtp_tls&＃39;] = truegitlab_rails[&＃39;gitlab_email_from&＃39;] = &＃39;******@qq.com&＃39;重启生效：gitlab-ctl reconfigure执行 gitlab-rails console进入控制台。 然后在控制台提示符后输入下面的命令 发送一封测试邮件：Notify.test_email(&＃39;收件人邮箱&＃39;, &＃39;邮件标题&＃39;, &＃39;邮件正文&＃39;).deliver_now


19、进入Gitlab控制台

输入

gitlab-rails console production


进入gitlab控制台，只有进入到控制台之后，才可以输入gitlab的查询语句，才会被解析
查找用户信息：

user = User.where(id:1).first


重置密码：输入

user.password=&＃39;密码&＃39;


密码位置填写您新的密码即可。然后再输入user.save!保存用户对象

20、Centos 7 下Gitlab 自启动设置

禁止 Gitlab 开机自启动：

systemctl disable gitlab-runsvdir.service


启用 Gitlab 开机自启动：

systemctl enable gitlab-runsvdir.service


配上搭建成功的图