01 前言
本文Gitlab的安裝為主機方式, 獲取其他安裝方式請點擊 https://git.lug.ustc.edu.cn/h...
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.