無忌過招:手把手教你搭建自己的GitLab庫
- 2019 年 10 月 11 日
- 筆記
01 前言
本文Gitlab的安裝為主機方式, 獲取其他安裝方式請點擊https://git.lug.ustc.edu.cn/help/install/README.md
02 架構
架構概述：
- 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 'http://gitlab.xxxxxx.com' #改域名,修改成你自己的域名,如果你用的https，改成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 參考文檔
https://docs.gitlab.com/ee/development/architecture.html
