在跟網路中心的老師溝通成立映象站的相關事宜的時候，意外地接下來搭建一套校內的 Git 服務的任務。

@怡紅公子曾經搭建過一套類似的服務，但由於伺服器端沒有開啟 VT 虛擬化導致不能安裝 64 位的作業系統，再加上 Gitlab 不提供 32 位的安裝包，所以長期以來怡紅公子一直都是自行編譯並配置 Gitlab 。考慮到後續維護的方便，我們決定趁著這個機會使用另一臺支援安裝 64 位作業系統的伺服器，一勞永逸地解決這個問題。

我們的伺服器環境是 CentOS 7.2 64bit，以下所有操作均以此為基準。

Gitlab 安裝

安裝和配置依賴

如果需要安裝 Postfix 來發送郵件，則需要在安裝過程中選擇 Internet Site

除此以外，下列命令將會在防火牆中開啟 HTTP(80) 和 SSH(22) 對應埠。

sudo yum install curl policycoreutils openssh-server openssh-clients
sudo systemctl enable sshd
sudo systemctl start sshd
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
sudo firewall-cmd --permanent --add
 
-service=http
sudo systemctl reload firewalld

新增 Gitlab 源並安裝

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

這個指令碼會在源中新增 Gitlab-CE ，並自動執行 yum makecache，然後安裝 gitlab-ce。由於源在國外，可能速度較慢，也可以手動新增來自 清華tuna 的源： https://mirrors.tuna.tsinghua.edu.cn/help/gitlab-ce/

配置並啟動 Gitlab

此時已經可以啟動服務了：

sudo gitlab-ctl reconfigure

進行一長串複雜的啟動流程之後， gitlab 就已經可以通過 localhost進行訪問了。

Gitlab 配置

修改域名

預設的配置檔案儲存在 /etc/gitlab/gitlab.rb，執行：

sudo vim /etc/gitlab/gitlab.rb

開啟檔案，並修改：

external_url 'http://your.domain'

再次執行

sudo gitlab-ctl reconfigure

即可。

有一定概率出現 502 錯誤，重新整理瀏覽器或者再次更新配置即可。

Gitlab 漢化

由於服務物件是廣大師生，為了降低新手上手的難度，所有進行漢化也是非常有必要的。好在國內有人已經進行了這方面的工作，我們只需要共享其成果即可（歡迎向 原專案提交高質量翻譯）。

首先確認版本：

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

並確認當前漢化版本的 VERSION 是否相同，當前最新的漢化版本為 8.6 。

如果安裝版本小於當前漢化版本，請先升級。如果安裝版本大於當前漢化版本，請在本專案中提交新的 issue。

如果版本相同，首先在本地 clone 倉庫。

# GitLab.com 倉庫
git clone https://gitlab.com/larryli/gitlab.git

# 或 Coding.net 映象
git clone https://git.coding.net/larryli/gitlab.git

根據我的測試， Coding.net 的映象不完整，clone 之後無法 checkout

然後比較漢化分支和原分支，匯出 patch 用的 diff 檔案。

# 8.1 版本的漢化補丁
git diff origin/8-6-stable..8-6-zh > ../8.6.diff

然後上傳 8.6.diff檔案到伺服器。

# 停止 gitlab
sudo gitlab-ctl stop
sudo patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < 8.6.diff

確定沒有 .rej 檔案，重啟 GitLab 即可。

sudo gitlab-ctl start

如果漢化中出現問題，請重新安裝 GitLab（ 注意備份資料）。

Gitlab 運維

管理

# 啟動所有 gitlab 元件：
sudo gitlab-ctl start

# 停止所有 gitlab 元件：
sudo gitlab-ctl stop

# 重啟所有 gitlab 元件：
sudo gitlab-ctl restart

備份

備份GitLab repositories and GitLab metadata

在 crontab 中加入如下命令：

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

恢復

首先進入備份 gitlab 的目錄，這個目錄是配置檔案中的 gitlab_rails['backup_path']，預設為 /var/opt/gitlab/backups。

然後停止 unicorn 和 sidekiq ，保證資料庫沒有新的連線，不會有寫資料情況。

sudo gitlab-ctl stop unicorn
# ok: down: unicorn: 0s, normally up
sudo gitlab-ctl stop sidekiq
# ok: down: sidekiq: 0s, normally up

然後恢復資料，1406691018為備份檔案的時間戳

gitlab-rake gitlab:backup:restore BACKUP=1406691018