無忌過招:手把手教你搭建自己的GitLab庫

01 前言

本文Gitlab的安裝為主機方式, 獲取其他安裝方式請點擊 git.lug.ustc.edu.cn/help/instal…

02 架構

cdn.xitu.io/2019/9/18/16d422f6510c4190?imageView2/0/w/1280/h/960/format/webp/ignore-error/1">

架構概述：

• Unicorn: Handles requests for the web interface and API, 一般gitlab站點，多數是因為這個服務有問題導致的
• Sidekiq: Background jobs processor
• Redis: Caching service
• PostgreSQL: Database

03 安裝

1. 設置repo

[gitlab-ce] 
name=Gitlab CE Repository 
baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/ 
gpgcheck=0 
enabled=1 
EOF

2. 安裝GitLab

$ yum makecache 
$ yum install gitlab-ce

3. 修改配置

配置文件/etc/gitlab/gitlab.rb注: 你可根據注釋修改配置文件，一般修改如下
external_url ' gitlab.xxxxxx.com' #改域名,修改成你自己的域名,如果你用的https，改成 gitlab.xxxxxx.com

4. 啟動服務

$ gitlab-ctl reconfigure  ## 使配置生效 
$ gitlab-ctl status  ## 確認服務狀態

04 如何備份

1. 設置備份目錄

先打開/etc/gitlab/gitlab.rb配置文件，查看一個和備份相關的配置項：
gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
該項定義了默認備份出文件的路徑，可以通過修改該配置，并執行 gitlab-ctl reconfigure 或者 gitlab-ctl restart 重啟服務生效。

2. 執行備份

備份執行一條命令就搞定：/opt/gitlab/bin/gitlab-rake gitlab:backup:create ，也可以加到crontab中定時執行：

0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

可以到 /var/opt/gitlab/backups找到備份包，解壓查看，會發現備份的還是比較全面的，數據庫、repositories、build、upload等分類還是比較清晰的。

3. 備份參數注釋

每天執行備份，肯定有目錄被爆滿的風險，我們可以立馬想到的可以通過find 查找一定的時間前的文件，配合rm進行刪除。不過不需要這么麻煩，gitlab-ce自身集成的有自動刪除配置。
同樣打開/etc/gitlab/gitlab.rb配置文件，可以找到如下配置：
gitlab_rails['backup_keep_time'] = 604800這里是設置備份保留7天（7360024=604800），秒為單位，如果想增大或減小，可以直接在該處配置，并通過gitlab-ctl restart 重啟服務生效。

05 GitLab遷移或數據恢復

1. 恢復前需要先停掉數據連接服務：

gitlab-ctl stop unicorn 
gitlab-ctl stop sidekiq

如果是臺空主機，沒有任何操作，理論上不停這兩個服務也可以。停這兩個服務是為了保證數據一致性。

2. 遷移數據

如果你沒修改過默認備份目錄的話，將老服務器/var/opt/gitlab/backups目錄下的備份文件拷貝到新服務器上的/var/opt/gitlab/backups

[root@localhost gitlab]# scp 1530773117_2018_07_05_gitlab_backup.tar 10.0.3.111:/var/opt/gitlab/backups/   
## 600權限是無權恢復的。--- 這里改成了777 
[root@localhost backups]# pwd 
/var/opt/gitlab/backups 
[root@localhost backups]# chmod 777 1530773117_2018_07_05_gitlab_backup.tar 
[root@localhost backups]# ll 
total 17328900 
-rwxrwxrwx 1 git git 17744793600 Jul  5 14:47 1530773117_2018_07_05_gitlab_backup.tar

3. 執行數據恢復

執行下面的命令進行恢復：后面再輸入兩次yes就完成恢復了。

gitlab-rake gitlab:backup:restore BACKUP=1530773117_2018_07_05_gitlab_backup.tar

PS:根據版本不同恢復時可能有點小區別

06 附錄1 常用命令

# 默認的log主目錄為 /var/log/gitlab/  
# 檢查redis的日志 
sudo gitlab-ctl tail redis 
# 檢查postgresql的日志 
sudo gitlab-ctl tail postgresql 
# 檢查gitlab-workhorse的日志 
sudo gitlab-ctl tail gitlab-workhorse  
# 檢查logrotate的日志 
sudo gitlab-ctl tail logrotate 
# 檢查nginx的日志 
sudo gitlab-ctl tail nginx  
# 檢查sidekiq的日志 
sudo gitlab-ctl tail sidekiq  
# 檢查unicorn的日志 
sudo gitlab-ctl tail unicorn sudo gitlab-ctl status  //檢查所依賴的服務是否運行 
sudo gitlab-ctl tail //檢查gitlab所依賴的服務是否在運行時出錯 
sudo gitlab-rake gitlab:check //檢查的配置是否正確，如果有錯誤，請根據提示解決它

07 FAQ

錯誤1

error: proxyRoundTripper: GET "/" failed with: "dial unix /var/opt/gitlab/gitlab-rails/sockets/gitlab.socket: connect: no such file or directory"

原因：unicorn 沒有正常啟動
解決：查看unicorn的日志， /var/log/gitlab/unicorn/*.log, 一般為端口沖突或是權限問題。依賴相應的日志，希望你可以很好的解決，enjoy it.

08 參考文檔

docs.gitlab.com/ee/developm…