Linux系统上Gitlab安装、汉化和邮箱配置笔记

简介

GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的web服务，可通过Web界面进行访问公开的或者私人项目。

环境要求

内存：2G以上

安装步骤

1、配置yum源

vim /etc/yum.repos.d/gitlab-ce.repo

添加以下内容

[gitlab-ce]
name=gitlab-ce
baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6
Repo_gpgcheck=0
Enabled=1
gpgcheck=0

2、更新缓存

sudo yum makecache

3、安装Gitlab社区版

sudo yum intall gitlab-ce        #自动安装最新版
sudo yum install gitlab-ce-x.x.x    #安装指定版本

Gitlab分为社区版(gitlab-ce)和企业版(gitlab-ee),企业版是收费的，所以我这边安装的是社区版

通过上面三步，不出意外的话，gitlab就已经安装完成了，接下来修改以下域名就可以访问了

4、修改域名访问

vim  /etc/gitlab/gitlab.rb

修改external_url值

#在浏览器中通过这个地址就可以访问Gitlab页面了
external_url 'http://192.168.0.100/gitlab'       

更新gitlab配置并启动服务

gitlab-ctl reconfigure 

首次这一步耗时需要几分钟，耐心等待。。。

注意：如果这一步出现卡住的现象（比如十几分钟没有反应了），可以通过以下步骤重新配置：

• 1、按住CTRL+C强制结束；

• 2、运行：sudo systemctl restart gitlab-runsvdir；

• 3、再次执行：sudo gitlab-ctl reconfigure

5、访问Gitlab页面

在浏览器中输入“http://192.168.0.100/gitlab”打开页面：

首次打开需要设置密码，设置完成后即可以登录。

至此，Gitlab的安装已经基本完成，不过这时候打开的页面是英文的，还需要进行汉化，如果不需要汉化的同学可以跳过；

Gitlab汉化步骤：

1、备份

如果你是刚安装完Gitlab，此时汉化，则可以不需要备份，汉化出差了大不了重新再安装一遍；

如果已经有重要数据了，此时汉化，怕汉化失败导致服务瘫痪，从而导致数据丢失，则在汉化前先做备份，

gitlab-rake gitlab:backup:create

备份路径的配置文件路径：/etc/gitlab/gitlab.rb

2、查看Gitlab版本

这一步非常重要，因为版本不同对应不同的汉化版本，一旦版本对应不上，则容易导致Gitlab瘫痪

查看版本方式：

cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
或者
rpm -q gitlab-ce

运行结果：

我安装的版本是11.7.7，下面的步骤需要用到

3、下载中文补丁

git clone https://gitlab.com/xhang/gitlab.git 

这个下载需要看网速，耐心等待。。。

4、解压中文补丁

tar xf gitlab-10-3-stable-zh.tar.bz2

如果没有安装tar，可以通过以下命令安装

yum install -y tar

5、停止Gitlab服务

gitlab-ctl stop

这一步也可以放到第一步执行，汉化补丁打patch之前执行就可以

切换到gitlab汉化补丁所在的目录

cd /root/gitlab

6、patch文件生成

git diff v11.7.7 v11.7.7-zh >../v11.7.7-zh.diff

上面的版本号根据gitlab的版本修改，我的版本是11.7.7 所以上面使用11.7.7

我们可以看一下生成的patch文件

7、gitlab打patch

patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < 11.7.7-zh.diff

如果还没有安装patch，可以先通过下面命令安装

yum install patch

看到Complate字样，则说明汉化成功；

8、重启Gitlab

gitlab-ctl reconfigure
gitlab-ctl start

9、打开Gitlab页面

在浏览器中刷新刚才那个页面（我的是：http://192.168.0.100/gitlab）

可以看到上面有部分内容已经是中文的了，因为我的版本比较新，所以汉化程度还不够完善，
旧的版本汉化应该会好一点，之后我再升级汉化包吧。。。

邮件配置

Gitlab新增用户有两种方式：

• 访问http://192.168.0.100/gitlab直接注册；
• 管理员通过设置页面添加用户，填入用户验证邮箱，用户收到邮件后设置密码；

通过第二种方式添加用户时，就需要配置gitlab的发送邮箱。

分为以下几个步骤：

1、安装postfix

yum -y install postfix

安装完之后，启动postfix

systemctl start postfix

同时设置开机自启动

systemctl enable postfix

查看是否开启成功

systemctl status postfix

看到active (running)则说明启动成功

2、配置gitlab邮箱

vim /etc/gitlab/gitlab.rb

添加以下内容（以企业微信邮箱为例）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com" #smtp设置
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "wu**@m**.com"  # 你自己企业微信邮箱账号
gitlab_rails['smtp_password'] = "*************"    # 企业微信邮箱账号授权码
gitlab_rails['smtp_domain'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = 'wu**@m.com'   # 你自己企业微信邮箱账号

关于smtp和授权码的设置：

1、点开企业微信邮箱，点击上方的“设置”->“客户端设置”，就会看到如下页面

2、smtp就设置：

smtp.exmail.qq.com

3、点击“获取授权密码”，将生成的授权密码填入即可；

3、重启Gitlab

gitlab-ctl reconfigure

4、测试发送邮件

重启成功后，测试一下是否能正常发送邮件

进入gitlab控制台

gitlab-rails console

输入测试邮箱和内容

Notify.test_email('wu**@m**.com', '邮件标题_test', '邮件正文_test').deliver_now

5、gitlab上实际测试

在gitlab上新增一个用户

输入用户名和邮箱

创建完成后观察是否已经收到邮箱

收到邮件说明我们配置成功！！！

总结

到这里Gitlab在Linux系统上的安装和汉化，以及邮箱配置都已经完成了。。。