GitLab 安装指南：在线连接安装、离线安装教程、中文语言包与卸载步骤详解

安装gitlab（联网&离线）

一、 联网下载

已配置yum源直接跳到第四步

1. 备份Linux默认的软件源配置文件（/etc/yum.repos.d/CentOS-Base.repo）

mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup

2. 设置yum源（1. 更换默认yum源，Linux默认的yum源下载软件速度很慢）

在 /etc/yum.repos.d 目录下新建 XXX.repo 文件并保存。内容如下：

name=Gitlab CE Repository
baseurl= 镜像站url
 gpgcheck=0
enabled=1

3. 生成yum缓存

yum clean all  清除缓存
yum makecache  生成缓存

4. 更新软件包

yum update -y

5. 环境配置（环境依赖包安装[影响gitlab的某些功能使用]和防火墙配置）

A 安装sshd

yum install -y curl policycoreutils-python openssh-server

启用并启动 sshd：（enable 开机自动启动）

systemctl enable sshd
systemctl start sshd

B 配置防火墙：采用命令开启防火墙

systemctl enable firewalld  #开机自动启动防火墙
systemctl start firewalld    #开启防火墙
firewall-cmd --permanent --add-service=http
systemctl reload firewalld

C 安装postfix

GitLab 需要使用 postfix 来发送邮件。
安装：

yum install -y postfix

打开 /etc/postfix/main.cf 文件，在第 119 行附近找到 inet_protocols = all，将 all 改为 ipv4 并按 Ctrl + S 保存：

inet_protocols = ipv4

启用并启动 postfix：

systemctl enable postfix 
systemctl start postfix

6. 安装 GitLab：

yum install -y gitlab-ce

7. 修改配置文件

修改配置文件gitlab.rb（宿主机上的路径为：/home/dgd/gitlab/config/gitlab.rb）里面的参数，建议在后面直接添加，不然修改或者查看很麻烦

1） 修改URL地址及ssh端口

配置http协议所使用的访问地址

external_url 'http://10.33.123.54'*写域名，就是用域名访问

配置ssh协议所使用的访问地址和端口 #设置拉取代码采取的地址和端口

gitlab_rails['gitlab_ssh_host'] = '10.33.123.54'
gitlab_rails['gitlab_shell_ssh_port'] = 10085

2） 修改邮件配置

gitlab_rails['smtp_enable'] = true
 gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
#说明用的邮箱是QQ企业邮箱
 gitlab_rails['smtp_port'] = 465 #采用465端口，登录发信邮箱查看设置
 gitlab_rails['smtp_user_name'] = "ying@digital.com.cn"
 gitlab_rails['smtp_password'] = "**********" #邮箱的密码或者授权码
 gitlab_rails['smtp_domain'] = "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'] = 'ying@digital.com.cn'

3） 初始化 GitLab

特别重要！不然gitlab不能运行
使用如下命令初始化 GitLab，生成配置文件：

sudo gitlab-ctl reconfigure

8. 启动gitlab

gitlab-ctl restart

9. 测试发信是否正常

gitlab-rails console （测试邮件服务是否正常）
Notify.test_email("XXX@XXX.XX","title","gitlab").deliver_now
# 如果发信失败，根据错误码百度

二、 离线下载

本情况是基于服务器已配置本地源，具备使用yum命令安装某些依赖包的条件，安装gitlab采用安装gitlab rpm包的方法

1. 配置本地源

2. 环境配置，详看联网安装的步骤5

3. 下载需求版本的rpm包，并传送到服务器

gitlab rpm下载地址：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6/

4. 安装gitlab

cd rpm存放目录
rpm -ivh 包名.rpm

5. gitlab预配置：域名，邮件配置详看联网安装的步骤7

6. 启动gitlab：gitlab-ctl start

汉化gitlab

1. 暂停gitlab

gitlab-ctl stop

2. 查看gitlab版本

cat /opt/gitlab/embedded/service/gitlab-rails/VERSION 
10.3.3

3. 下载中文补丁包

【重要】需要下载和gitlab同样版本的中文补丁包，不然可能会导致gitlab瘫痪，下载zh结尾（中文）
下载地址：https://gitlab.com/xhang/gitlab

【重要】拉到最下面，查找tag，找到和GitLab一模一样的版本的汉化包
1）直接下载
wget 地址 [-o 指定下载名]
地址获取：选择下载后，复制其地址

2）本地下载补丁包后传送到服务器
3）用git clone获取最新版的（这个不建议，版本不一定符合）
git clone https://gitlab.com/xhang/gitlab.git

4. 解压

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

查看汉化包的版本

cat gitlab-10-3-stable-zh/VERSION 
10.3.3

5. 【重要】先备份，避免汉化失败后gitlab瘫痪

cp -r /opt/gitlab/embedded/service/gitlab-rails{,.ori}
等于
cp -r /opt/gitlab/embedded/service/gitlab-rails /opt/gitlab/embedded/service/gitlab-rails.ori

6. 复制并覆盖

[\]cp -rf gitlab-10-3-stable-zh/* /opt/gitlab/embedded/service/gitlab-rails/

反斜杠说明遇到同名文件强制覆盖
复制可能出现如下提示，可以不用理会

7. 重新配置gitlab：这点很重要！！！

gitlab-ctl reconfigure  

8. 重启gitlab：

gitlab-ctl restart

完全卸载gitlab

https://yq.aliyun.com/articles/114619

注意点：

1. 安装gitlab后需要执行：sudo gitlab-ctl reconfigure
2. 每次对gitlab进行配置修改都需要执行：sudo gitlab-ctl reconfigure
3. 修改yum源需要重新生成缓存：yum makecache

参考资料：

1. 搭建GitLab并汉化：https://www.jianshu.com/p/2400d9e57fd1
2. 汉化包下载地址：https://gitlab.com/xhang/gitlab
3. Centos7 离线安装gitlab：https://www.jianshu.com/p/82ecd29a1b3e
4. gitlab rpm下载地址：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6/
5. CentOS服务器上搭建Gitlab安装步骤、中文汉化详细步骤、日常管理以及异常故障排查https://www.cnblogs.com/fanjingfeng/p/6665597.html
6. gitlab升级、备份、迁移/恢复：https://www.cnblogs.com/straycats/p/7637373.html