安装

Omnibus package installation

这是 Gitlab 官网推荐的安装方式。官网文档链接位于Gitlab Installation。不过,现在直接去官网默认给出的是企业版,即 gitlab-ee 的安装方式(付费的),而个人版其实用 gitlab-ce 就够了。gitlab-ce 安装方式如下

安装并配置依赖

1
sudo apt-get install -y curl openssh-server ca-certificates 

然后安装 Postfix 来启动邮件提醒功能。(如果你使用了第三方的邮件服务,可以跳过这一步并且参照配置外部 SMTP 服务器)。

1
sudo apt-get install -y postfix

在接下来的配置过程中,选择'Internet Site'选项。使用你的服务器的域名来作为'mail name'。如果还有后续的选项,输入 Enter 直至安装完成。

安装 Gitlab-EE

添加 Gitlab Package 仓库:

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

注意这里安装的是 CE 版本,故是 gitlab-ce,企业版对应的是 gitlab-ee

接下来安装 Gitlab:

1
sudo EXTERNAL_URL="http://gitlab.example.com" apt-get install gitlab-ce 

这里的 EXTERNAL_URL 是你的 Gitlab 服务要使用的域名。如果你只使用 http,或者后续要使用已有的 Nginx,可以在这里使用 http。如果使用 https,gitlab 会调用Let's encrtpy的服务为你的网站添加 ssl 证书。

登录 Gitlab

进入你在安装阶段的域名,你会被重定向到密码重置界面。在这个页面你要设置管理员账户的密码,然后回到登录界面。在这个登录界面,使用root用户名和上一步设置的密码登录。

使用已有的 Nginx

这个章节我们参考官方文档给出使用已有的 Nginx 的方法。

禁用 Gitlab 自带的 Nginx

编辑/etc/gitlab/gitlab.rb文件,设置

1
nginx['enable'] = false

设置外部服务器的用户

这一步是为了保证外部服务器用户能够访问 gitlab。使用 Nginx 时,可以通过/etc/nginx/nginx.conf文件查看到 nginx 用户。一般情况下这个用户名是www-data。修改/etc/gitlab/gitlab.rb

1
web_server['external_users'] = ['www-data']

然后使用sudo gitlab-ctl reconfigure来使得更改生效。

Trusted proxies

如果你的反向代理服务器和 gitlab 不是在同一台机器上,那么你还需要设置 Trusted proxies。

1
gitlab_rails['trusted_proxies'] = ['192.168.1.0/24', '192.168.2.1', '2001:0db8::/32']

Nginx 示例配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# gitlab socket 文件地址
upstream gitlab {
# 7.x 版本在此位置
# server unix:/var/opt/gitlab/gitlab-rails/tmp/sockets/gitlab.socket;
# 8.0 位置
server unix:/var/opt/gitlab/gitlab-rails/sockets/gitlab.socket;
}

server {
listen *:80;

server_name gitlab.example.com; # 请修改为你的域名

server_tokens off; # don't show the version number, a security best practice
root /opt/gitlab/embedded/service/gitlab-rails/public;

# Increase this if you want to upload large attachments
# Or if you want to accept large git objects over http
client_max_body_size 250m;

# individual nginx logs for this gitlab vhost
access_log /var/log/gitlab/nginx/gitlab_access.log;
error_log /var/log/gitlab/nginx/gitlab_error.log;

location / {
# serve static files from defined root folder;.
# @gitlab is a named location for the upstream fallback, see below
try_files $uri $uri/index.html $uri.html @gitlab;
}

# if a file, which is not found in the root folder is requested,
# then the proxy pass the request to the upsteam (gitlab unicorn)
location @gitlab {
# If you use https make sure you disable gzip compression
# to be safe against BREACH attack

proxy_read_timeout 300; # Some requests take more than 30 seconds.
proxy_connect_timeout 300; # Some requests take more than 30 seconds.
proxy_redirect off;

proxy_set_header X-Forwarded-Proto https;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Frame-Options SAMEORIGIN;

proxy_pass http://gitlab;
}

# Enable gzip compression as per rails guide: http://guides.rubyonrails.org/asset_pipeline.html#gzip-compression
# WARNING: If you are using relative urls do remove the block below
# See config/application.rb under "Relative url support" for the list of
# other files that need to be changed for relative url support
location ~ ^/(assets)/ {
root /opt/gitlab/embedded/service/gitlab-rails/public;
# gzip_static on; # to serve pre-gzipped version
expires max;
add_header Cache-Control public;
}

# error_page 502 /502.html;
}

迁移

备份

迁移首先要做的是备份。在git 学习------> Gitlab 如何进行备份恢复与迁移?这篇文章中详细讲述了备份的问题。我们这里介绍的是最为直接和简单的步骤。如果要更加详细的信息请阅读这篇参考。

备份使用如下命令:

1
gitlab-rake gitlab:backup:create

备份会生成在/var/opt/gitlab/backups目录下。名称类似于1502357536_2017_08_10_9.4.3_gitlab_backup.tar。下面这些配置信息,没有包含在 backup 文件里面。需要手动迁移。

  • /etc/gitlab/gitlab.rb 配置文件须备份
  • /var/opt/gitlab/nginx/conf nginx 配置文件
  • /etc/postfix/main.cfpostfix 邮件配置备份
备份命令的执行

在目标机器上安装 gitlab

迁移过程中要求源机器和目标机器上安装的 gitlab 版本是相同的。如果不同,其实最好的做法是先将源机器上的 gitlab 升级到最新的版本。然后再生成备份。

如何查看Gitlab版本

上传备份

使用scp命令将备份文件上传到目标机器的/var/opt/gitlab/backups

如果 scp 上传目标文件文件夹的权限不够,可以先上传到自己的 home 目录下,然后 ssh 登录到服务器使用 sudo 进行移动。

应用备份文件

首先为了避免潜在的权限问题,将备份文件的权限设置为 777

1
chmod 777 1502357536_2017_08_10_9.4.3_gitlab_backup.tar 

然后停止 gitlab 的相关数据连接服务

1
2
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq

然后用下面的命令读取备份:

1
gitlab-rake gitlab:backup:restore BACKUP=1502357536_2017_08_10_9.4.3

在后续出现的所有询问中输入 yes,等待执行完毕,即完成了迁移过程,接下来再次启动 gitlab

1
sudo gitlab-ctl start

删除

下面的删除过程在 Ubuntu 16 上得到验证:

移除 gitlab 服务

1
sudo gitlab-ctl uninstall

清楚 Gitlab 产生的数据

1
sudo gitlab-ctl cleanse

删除 Gitlab 生成的系统账户

1
sudo gitlab-ctl remove-accounts

删除 gitlab

1
sudo dpkg -P gitlab-ce

其他文件的删除

除了上述操作,Gitlab 使用的其他文件夹还需要手动删除,包括:

  • /opt/gitlab: 包含了 Gitlab 的应用代码和依赖
  • /var/opt/gitlab: 包含了应用的数据和配置信息(gitlab-ctl reconfigure 的写入内容)
  • /etc/gitlab: omnibus gitlab 的配置信息。这里的文件是唯一允许你手动编辑的部分
  • /var/log/gitlab: 日志文件

在你完成了开始的四个步骤后,这里的四个文件夹可以安全地手动删除。