背景

由於我們早期使用 phabricator 進行程式碼管理，但是在使用的過程當中發現和社群的 github 使用方式有些不同，所以為了讓大夥都習慣 github 社群相同的使用風格，所以我們換成了 gitlab 作為公司內部的程式碼管理系統；並且其強大的 CI/CD 的方式為後續的持續整合工作打下基礎。

注意

Gitlab 分為 社群版 (gitlab-ce) 與 企業版 (gitlab-ee)，社群版免費，企業版收費，兩個版本的區別參考官方文件：gitlab-ce VS gitlab-ee；官方網站安裝文件預設是針對 gitlab-ee 進行說明的，為了避免不必要的麻煩請直接安裝 gitlab-ce

新版本方式 : 此文件針對大於 Gitlab 10.5 版本進行說明的，小於此版本的參考其它文件。

開始安裝

由於官方的方式下載軟體包太慢，並且我們是專門購買的一臺機器安裝 gitlab 使用，再加上本人覺得直接下載軟體包 *.deb 手動安裝方便一些，所以我直接在清華大學開源軟體源下載的包進行安裝的。

注意：我這裡的作業系統版本是 Ubuntu 16.04 ，最後的那位部落格使用的是 Centos 方式安裝的，最好對照自己的作業系統方式進行部落格參考。

下載安裝

以下通過手動方式安裝的，如果希望通過新增軟體源的方式新增方便後續的自動更新，可以參考:

下載包檔案

wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubuntu/pool/xenial/main/g/gitlab-ce/gitlab-ce_10.7.2-ce.0_amd64.deb

開始安裝

dpkg -i gitlab-ce_10.7.2-ce.0_amd64.deb

基礎配置

開啟 /etc/gitlab/gitlab.rb 檔案進行基礎設定，所有的核心設定均在這個檔案中。

設定外部地址

## GitLab URL
##! URL on which GitLab will be reachable.
 

##! For more details on configuring external_url see:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
external_url 'https://gitlab.xxx.com'

注意：如果沒有設定以下 https 方式，則需要把地址前面換成 http。

設定 HTTPS 方式

如果想要以上的 https 方式正常生效使用，則需要把 letsencrypt 自動生成證書的配置開啟，這樣在執行重新讓配置生效命令 (gitlab-ctl reconfigure) 的時候會自動給域名生成免費的證書並自動在 gitlab 自帶的 nginx 中加上相關的跳轉配置，都是全自動的，非常方便。

注意：進行生成證書的時候請預先把域名解析設定完畢，否則會執行配置生效命令失敗。

################################################################################
# Let's Encrypt integration
################################################################################
 letsencrypt['enable'] = true
 letsencrypt['contact_emails'] = ['[email protected]'] # This should be an array of email addresses to add as contacts

郵件配置

很多部落格及大多數的情況都推薦使用 postfix 模組進行郵件通知處理；但是我們公司已有郵箱伺服器，所以 postfix 並非必須的；所以我這裡採用 SMTP 的方式配置郵件伺服器來實現通知效果；具體配置參考如下：


開啟 /etc/gitlab/gitlab.rb 配置 SMTP 服務的具體內容如下，我這裡採用的郵箱安全埠，點選開啟更多配置參考。

### Email Settings
 gitlab_rails['gitlab_email_enabled'] = true
 gitlab_rails['gitlab_email_from'] = '[email protected]'
 gitlab_rails['gitlab_email_display_name'] = 'gitlab.notice'
 gitlab_rails['gitlab_email_reply_to'] = '[email protected]'
 gitlab_rails['gitlab_email_subject_suffix'] = 'gitlab'

### GitLab email server settings
###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html
###! **Use smtp instead of sendmail/postfix.**

 gitlab_rails['smtp_enable'] = true
 gitlab_rails['smtp_address'] = "smtp.qq.com"
 gitlab_rails['smtp_port'] = 465
 gitlab_rails['smtp_user_name'] = "[email protected]"
 gitlab_rails['smtp_password'] = "xxxxx"
 gitlab_rails['smtp_domain'] = "qq.com"
 gitlab_rails['smtp_authentication'] = "login"
 gitlab_rails['smtp_enable_starttls_auto'] = true
 gitlab_rails['smtp_tls'] = true

利用以下命令進行測試郵箱配置是否正確，測試使用方式更多參考：如何測試

gitlab-ctl console
irb(main):002:0>Notify.test_email('[email protected]', '郵件標題', '郵件正題').deliver_now

配置生效

當 /etc/gitlab/gitlab.rb 配置發生改變的時候想要生效必須執行以下命令:

gitlab-ctl reconfigure

以上的操作執行完畢並且成功之後，這個時候就可以直接在瀏覽器中打開了。

注意：如果依然無法訪問的話，請檢查主機防火牆或雲服務安全組中的 80 或 443 埠是否正常開放，切記！切記！切記！

最後

此篇主要只涉及安裝與基礎配置的部分，如果需要檢視更多包括：忘記 root 密碼重置、備份與恢復等；可以點選這篇部落格（如何安裝與使用 Gitlab）進行檢視，此篇主要參考了這位作者的部落格內容，並根據自己的操作進行整理，感謝這位作者的付出！

其它參考