目錄

個人感受: 個人專案本地託管還是用SVN吧. GitLab在管理多個專案上可能有優勢, 但是GitLab搭建太複雜不划算. SVN在CentOS上可謂是一鍵安裝
yum install httpd httpd-devel subversion mod_dav_svn mod_auth_mysql

一 準備工作

GitLab目前(2016-06-25)支援的系統 64位

Ubuntu
Debian
CentOS
以下三種系統參考CentOS的安裝包和說明:
Red Hat Enterprise Linux
Scientific Linux
Oracle Linux

1 ssh登入到雲伺服器的終端

選擇CentOS 7.0 64bit系統(因為GitLab目前不支援CentOS6.5)
確認雲伺服器啟動以後, ssh連結到雲伺服器,
ssh [email protected]
輸入雲伺服器root使用者的初始密碼, 回車, 進入雲伺服器的CentOS系統命令列環境.

2 安裝必要軟體

在CentOS系統命令列環境輸入逐個以下命令, 命令的具體意義見文末的附錄:
sudo yum install curl policycoreutils openssh-server openssh-clients

3 配置系統服務

sudo systemctl enable sshd

sudo systemctl start sshd
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
報錯如下:

Job for postfix.service failed. See 'systemctl status postfix.service' and 'journalctl -xn' for details.

根據提示, 使用systemctl status postfix.service -l檢視錯誤原因, 如下:

6月 25 11:05:41 主機名 postfix/sendmail[1143]: fatal: parameter inet_interfaces: no local interface found for ::1
 

解決方案:
開啟postfix的配置檔案
vim /etc/postfix/main.cf
發現116行左右的配置為：

inet_interfaces = localhost
inet_protocols = all

改成以下內容並儲存：

inet_interfaces = localhost # 只能接受來自本機的郵件
inet_protocols = ipv4 # 拒絕ipv6的本機地址::1

再次執行
sudo systemctl start postfix
無報錯, 成功

sudo firewall-cmd --permanent --add-service=http
報錯如下:

FirewallD is not running

解決方案:
修改配置檔案 /etc/sysctl.conf, 在最後新增以下內容後儲存:

net.ipv4.ip_forward=1

為了使配置生效, 輸入:
sysctl -p
再次啟動firewalld服務, 輸入:
systemctl start firewalld
檢查firewalld服務狀態, 輸入:
systemctl status firewalld -l
提示以下資訊, 注意到Active: active (running)則成功:

firewalld.service - firewalld - dynamic firewall daemon
Loaded: loaded (/usr/lib/systemd/system/firewalld.service; disabled)
Active: active (running) since 六 2016-06-25 12:58:15 CST; 4s ago
Main PID: 27738 (firewalld)
CGroup: /system.slice/firewalld.service
       └─27738 /usr/bin/python -Es /usr/sbin/firewalld --nofork --nopid
       6月 25 12:58:15 iZ28blmhjjkZ systemd[1]: Started firewalld - dynamic firewall daemon.

再次輸入
sudo firewall-cmd --permanent --add-service=http
提示以下資訊, 則成功:

success

sudo systemctl reload firewalld

4 安裝 Ruby 語言2.1.x(MRI)版本

Ruby MRI - Matz’s Ruby Interpreter (also called CRuby)

GitLab依賴Ruby, 而且嚴格要求版本為 2.1.x
Ruby 2.1.10 是官方宣告的2.1系列的最後一個版本

系統軟體源的ruby版本是 2.0.0 不是我們想要的
想安裝制定版本的Ruby需要通過RVM(Ruby Version Manager)

安裝RVM

通過gpg工具安裝, 關於gpg的詳細介紹見附錄. 在命令列輸入:
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
提示如下, 則新增密匙成功

gpg: 下載金鑰‘D39DC0E3’，從 hkp 伺服器 keys.gnupg.net
gpg: /root/.gnupg/trustdb.gpg：建立了信任度資料庫
gpg: 金鑰 D39DC0E3：公鑰“Michal Papis (RVM signing) <[email protected]>”已匯入
gpg: 沒有找到任何絕對信任的金鑰
gpg: 合計被處理的數量：1

如果提示如下:

gpgkeys: HTTP fetch error 6: Could not resolve host: keys.gnupg.net; Name or service not known

則用指定用80埠
gpg --keyserver hkp://keys.gnupg.net:80 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
然後再
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
就可以了

然後, 獲得安裝的.sh指令碼, 儲存到當前目錄下的rvm.sh檔案
curl -sSL https://get.rvm.io>rvm.sh
賦予可執行許可權, 並執行rvm.sh檔案
chmod 744 rvm.sh
bash ./rvm.sh
提示如下

Downloading https://github.com/rvm/rvm/archive/master.tar.gz
Creating group 'rvm'

Installing RVM to /usr/local/rvm/
Installation of RVM in /usr/local/rvm/ is almost complete:

  * First you need to add all users that will be using rvm to 'rvm' group,
    and logout - login again, anyone using rvm will be operating with `umask u=rwx,g=rwx,o=rx`.

  * To start using RVM you need to run `source /etc/profile.d/rvm.sh`
    in all your open shell windows, in rare cases you need to reopen all shell windows.

# Administrator,
#
#   Thank you for using RVM!
#   We sincerely hope that RVM helps to make your life easier and more enjoyable!!!
#
# ~Wayne, Michal & team.

In case of problems: https://rvm.io/help and https://twitter.com/rvm_io

翻譯一下就是還要做兩件事:
1. 添加當前系統使用者到系統使用者組rvm, 登出後重新登入
2. source /etc/profile.d/rvm.sh

安裝RVM第一步 - 添加當前系統使用者到系統使用者組rvm

檢查使用者組列表檔案是否有使用者組rvm
cat /etc/group
確實有, 新增root到rvm組
usermod -a -G rvm root
-a 代表 append， 也就是將使用者新增到新使用者組中而不必離開原有的其他使用者組。不過需要與 -G 選項配合使用.

檢視root使用者所在的組, 命令列輸入:
groups
提示如下:

root

發現仍然只有root, 並沒有加入到rvm使用者組, 不要擔心, 重新登入一下就好了.
重新登入後, 命令列輸入:
groups
提示如下:

root rvm

安裝RVM第二步 - source /etc/profile.d/rvm.sh

命令列輸入:
source /etc/profile.d/rvm.sh
無報錯資訊, 繼續輸入:
rvm
出現rvm使用幫助, 大功告成

用RVM安裝Ruby 2.1.10

此部分內容轉自RVM 實用指南 · Ruby China
列出已知版本
rvm list known
稍等5秒左右, 提示如下. 哇塞, 有這麼多版本的Ruby:

# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.5]
[ruby-]2.3[.1]
[ruby-]2.3-head
ruby-head

# for forks use: rvm install ruby-head-<name> --url https://github.com/github/ruby.git --branch 2.2

# JRuby
jruby-1.6[.8]
jruby-1.7[.25]
jruby[-9.1.1.0]
jruby-head

# Rubinius
rbx-1[.4.3]
rbx-2.3[.0]
rbx-2.4[.1]
rbx[-2.5.8]
rbx-head

# Opal
opal

# Minimalistic ruby implementation - ISO 30170:2012
mruby[-head]

# Ruby Enterprise Edition
ree-1.8.6
ree[-1.8.7][-2012.02]

# GoRuby
goruby

# Topaz
topaz

# MagLev
maglev[-head]
maglev-1.0.0

# Mac OS X Snow Leopard Or Newer
macruby-0.10
macruby-0.11
macruby[-0.12]
macruby-nightly
macruby-head

# IronRuby
ironruby[-1.1.3]
ironruby-head

安裝一個 Ruby 版本
rvm install 2.1.10 --disable-binary
一步一步安裝順利, 直到出現以下報錯:

curl: (6) Could not resolve host: rubygems.org; 未知的名稱或服務
There was an error while trying to resolve rubygems version for 'latest'. 
Halting the installation.

我是隔一會兒多試幾次就好了

切換 Ruby 版本
rvm use 2.1.10
檢查ruby是否安裝
ruby -v

ruby 2.1.10p492 (2016-04-01 revision 54464) [x86_64-linux]

ruby 2.1.10 安裝成功!

如果想設定為預設版本，這樣一來以後新開啟的控制檯預設的 Ruby 就是這個版本
rvm use 2.1.10 --default

查詢已經安裝的ruby
rvm list

解除安裝一個已安裝版本
rvm remove 1.8.7

二 GitLab 安裝

官網推薦使用 Omnibus GitLab 安裝, Omnibus GitLab 已經集成了GitLab, 資料庫, Redis, Nigix.

方案一 - 科學上網安裝Omnibus GitLab

不一定成功, 詳見附錄 - 科學上網安裝GitLab

方案二 - 使用清華大學映象安裝Omnibus GitLab(親測可用)

新建 /etc/yum.repos.d/gitlab-ce.repo，內容為

[gitlab-ce]
name=gitlab-ce
baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7
repo_gpgcheck=0
gpgcheck=0
enabled=1
gpgkey=https://packages.gitlab.com/gpg.key

再執行
sudo yum makecache
sudo yum install gitlab-ce

安裝完以後 /var/opt/gitlab/ 目錄結構

/var/opt/gitlab/
├── backups
├── git-data
│   └── repositories
│       └── root
├── gitlab-ci
│   └── builds
├── gitlab-rails
│   ├── etc
│   ├── shared
│   │   ├── artifacts
│   │   ├── lfs-objects
│   │   └── pages
│   ├── sockets
│   ├── tmp
│   ├── upgrade-status
│   ├── uploads
│   └── working
├── gitlab-shell
├── gitlab-workhorse
├── logrotate
│   └── logrotate.d
├── nginx
│   ├── client_body_temp
│   ├── conf
│   ├── fastcgi_temp
│   ├── logs -> /var/log/gitlab/nginx
│   ├── proxy_cache
│   ├── proxy_temp
│   ├── scgi_temp
│   └── uwsgi_temp
├── postgresql
│   └── data
│       ├── base
│       │   ├── 1
│       │   ├── 12918
│       │   ├── 12923
│       │   └── 16385
│       ├── global
│       ├── pg_clog
│       ├── pg_multixact
│       │   ├── members
│       │   └── offsets
│       ├── pg_notify
│       ├── pg_serial
│       ├── pg_snapshots
│       ├── pg_stat_tmp
│       ├── pg_subtrans
│       ├── pg_tblspc
│       ├── pg_twophase
│       └── pg_xlog
│           └── archive_status
└── redis

新增git使用者和使用者組

這一步預設安裝gitlab-ce的時候自動幫我們做了.

omnibus-gitLab uses the user name “git” for Git gitlab-shell login, ownership of the Git data itself, and SSH URL generation on the web interface. Similarly, git group is used for group ownership of the Git data.

We do not recommend changing the user/group of an existing installation

檢視使用者
cat /etc/passwd

檢視組
cat /etc/group

發現已經有 git 使用者和 git 使用者組了.

切換到git使用者
sudo su git

備註:
安裝gitlab-ce時, 通過以下命令建立使用者
sudo adduser --disabled-login --gecos 'GitLab' git
–disabled-login 選項建立了gitlab賬戶但是並沒有為之設立密碼，所以是無法使用密碼登陸的。
你應該在gitlab的網頁上面把自己的公鑰新增上去。

配置gitlab-shell

GitLab Shell - handles git commands for GitLab. GitLab Shell is not a Unix shell nor a replacement for Bash.

gitlab-shell處理使用者提交的 git push/pull 命令的四種 cases

git pull over ssh -> gitlab-shell -> API call to gitlab-rails (Authorization) -> accept or decline -> execute git command

git pull over http -> gitlab-rails (Authorization) -> accept or decline -> execute git command

git push over ssh -> gitlab-shell (git command is not executed yet) -> execute git command -> gitlab-shell pre-receive hook -> API call to gitlab-rails (authorization) -> accept or decline push

git push over http -> gitlab-rails (git command is not executed yet) -> execute git command -> gitlab-shell pre-receive hook -> API call to gitlab-rails (authorization) -> accept or decline push

安裝gitlab-ce的時候自動幫我們安裝了gitlab-shell, 安裝位置是 /var/opt/gitlab/gitlab-shell , 所以我們只需要配置gitlab-shell就好了
cd /var/opt/gitlab/gitlab-shell

vim config.yml

三 GitLab配置

/etc/gitlab/ 目錄結構:

/etc/gitlab/
├── gitlab.rb
├── gitlab-secrets.json
└── ssl
    └── trusted-certs

gitLab基本配置集中在 /etc/gitlab/gitlab.rb 檔案, 每個引數的作用和配置請參考官網的配置說明.

先停止 GitLab 服務
sudo gitlab-ctl stop

編輯器開啟 /etc/gitlab/gitlab.rb
vim /etc/gitlab/gitlab.rb

進行任何改動後, 儲存退出, 在命令列逐個輸入以下命令使配置生效

啟動資料庫, 不然 reconfigure 報錯
sudo gitlab-ctl restart postgresql

sudo gitlab-ctl reconfigure

sudo gitlab-ctl start

配置服務機地址

用你的阿里雲主機公網地址就可以了

external_url 'http://xxx.xxx.xxx.xxx'

配置資料庫

GitLab支援兩種資料庫

PostgreSQL
MySQL

GitLab自帶PostgreSQL資料庫位於 /var/opt/gitlab/postgresql/ 目錄下, 如果需要使用自定義的資料庫參考官網的這篇文章.

重啟資料庫
gitlab-ctl restart postgresql

資料庫配置地址 /var/opt/gitlab/postgresql/data/postgresql.conf
修改後需要重啟
vim postgresql.conf

# 修改監聽地址為ip，*表示全部IP都可以進入資料庫
（有賬號就需要賬號驗證，無賬號就可以直接連線進來）
listen_addresses = '*'    
port = 5432        註釋# 監聽埠
max_connections = 200      # (change requires restart)

連線資料庫的配置
vim pg_hba.conf

host all all 192.168.1.0/24 trust 新增這行，192.168.1.0/24這個段的ip地址不需要密碼可以連線

在維護 PostgreSQL 庫時，有兩個配置檔案修改的情況比較多，第一是認證檔案 pg_hba.conf，另一個是配置檔案 postgresql.conf。

其中 pg_hba.conf 的更改更頻繁些，因為業務伺服器經常出現調整，或增加應用伺服器，此時需要增加 pg_hba.conf 的 IP 籤權資訊，因為目前我們的生產庫對 IP 實行嚴格控制，只有指定的 IP 許可權才被開放，下面是一個生產庫的 pg_hba.conf 檔案。

# TYPE  DATABASE    USER        CIDR-ADDRESS          METHOD
host postgres all 0.0.0.0/0 reject
host template0 all 0.0.0.0/0 reject
host template1 all 0.0.0.0/0 reject
#Aplication Ip list
host all all 180.166.148.57/32 md5 表示僅僅允許這個IP的外網地址可以連線到資料庫
# "local" is for Unix domain socket connections only
local all all peer map=gitlab

前三行的認證策略為 reject ，表示不允許任何遠端的連線連線系統庫，之後才是應用伺服器的IP 列表，沒列入檔案的 IP 將不允許連線，這就是常見的 “no pg_hba.conf entry” 錯誤。

更多的時候，有時不小心在配置檔案 pg_hba.conf 增加了非法字元，也不會報錯，但會帶來問題。

配置Web容器

GitLab自帶Web容器 - ngnix 位於 /var/opt/gitlab/ngnix/ 目錄下, 如果需要使用自定義的資料庫參考官網的這篇文章.

修改NGINX監聽埠

By default NGINX will listen on the port specified in external_url or implicitly use the right port (80 for HTTP, 443 for HTTPS). If you are running GitLab behind a reverse proxy, you may want to override the listen port to something else. For example, to use port 8080

nginx['listen_port'] = xxxx

可選 - 配置SMTP傳送郵件配置，使用163郵箱需要登入網頁版, 在設定裡開通SMTP服務才行

###163 exmail
#Sending application email via SMTP#
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_port'] = 25 
gitlab_rails['smtp_user_name'] = "發件箱@163.com"
gitlab_rails['smtp_password'] = "發件箱賬號"
gitlab_rails['smtp_domain'] = "163.com"
gitlab_rails['smtp_authentication'] = :login
gitlab_rails['smtp_enable_starttls_auto'] = true
#
###修改gitlab配置的發信人
gitlab_rails['gitlab_email_from'] = "發件箱@163.com"
user["git_user_email"] = "發件箱@163.com"

四 GitLab啟動停止

sudo gitlab-ctl start
sudo gitlab-ctl stop

五 GitLab運維

檢視ngnix伺服器日誌

/var/opt/gitlab/nginx/logs/

檢視gitlab-shell日誌

/var/log/gitlab/gitlab-shell/gitlab-shell.log

附錄

附錄A - 術語

curl - linux下發送http GET和POST請求的工具

postfix - 一種電子郵件伺服器郵件伺服器，它是由任職於IBM沃森研究中心（T.J. Watson Research Center）的荷蘭籍研究員Wietse Venema為了改良sendmail郵件伺服器而產生的。最早在1990年代晚期出現，是一個開放原始碼的軟體

systemctl - 使用linux的同學對service和chkconfig兩個命令都不陌生，其重要性不言而喻，為了簡化操作，通過systemctl一個命令就可以實現兩個命令的功能.
用法是
systemctl 動作 服務名.service
支援該命令的Linux發行版有CentOS 7.

Firewalld - the new userland interface in RHEL 7(CentOS 7). It replaces the iptables interface and connects to the netfilter kernel code. It mainly improves the security rules management by allowing configuration changes without stopping the current connections.

gpg - RSA演算法的一個實現. RSA演算法是最通用最安全的加密方法. 目前被破解的最長RSA金鑰是768個二進位制位。也就是說，長度超過768位的金鑰，還無法破解（至少沒人公開宣佈）。因此可以認為，2048位的金鑰極其安全. gpg預設使用2048位的密匙. gpg的詳細介紹請看http://www.ruanyifeng.com/blog/2013/07/gpg.html

Ruby gem - Gem是 Ruby 語言的包管理工具, 類似於Maven倉庫是 Java 語言的包管理工具

Ruby gemset - gemset 可以理解為是一個獨立的 Gem 環境, 可以包含一些 Gem 包. gemset依賴於某一個Ruby版本, 也就是說 Ruby 2.1.10 的gemset在 Ruby 2.2 中並不存在.

SOCKS5代理 - SOCKS5 是一個代理協議，它在使用TCP/IP協議通訊的前端機器和伺服器機器之間扮演一箇中介角色，使得內部網中的前端機器變得能夠訪問Internet網中的伺服器，或者使通訊更加安全。SOCKS5 伺服器通過將前端發來的請求轉發給真正的目標伺服器， 模擬了一個前端的行為。在這裡，前端和SOCKS5之間也是通過TCP/IP協議進行通訊，前端將原本要傳送給真正伺服器的請求傳送給SOCKS5伺服器，然後SOCKS5伺服器將請求轉發給真正的伺服器。

附錄B - GitLab支援的併發數

硬體對併發的影響如表所示:

CPU數	記憶體(GB)	使用者數
1	2	100
2	500
4	1000
4	8	2000
16	4000
8	5000

由表可知: 單人用的本地GitLab可以用VirtualBox開一個虛擬機器, CPU分1個, 記憶體分2GB.
公司開發小組用的可以用物理機, CPU分2個, 記憶體分4GB.

附錄C - 科學上網安裝GitLab

用curl工具下載GitLab官方提供的安裝指令碼script.rpm.sh到當前目錄
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh>script.rpm.sh
執行指令碼
chmod 744 script.rpm.sh
bash script.rpm.sh
報錯如下:

https://packages.gitlab.com/gitlab/gitlab-ce/el/7/x86_64/repodata/repomd.xml: [Errno 12] Timeout on https://packages-gitlab-com.s3.amazonaws.com/7/8/el/7/x86_64/repodata/ee01a5a96e4998a0779196d25a4bb4bbfe86fcf569ee8b124bda109ad30f1fdc-repomd.xml?AWSAccessKeyId=AKIAJ74R7IHMTQVGFCEA&Signature=VXOyX8hwwoaiKAs4imo4yPchHx4=&Expires=1466862919: (28, 'Connection timed out after 3772 milliseconds')
正在嘗試其它映象。

亞馬遜的s3伺服器被牆了…

先還原yum源, 刪掉gitlab-ce源
ls -l /etc/yum.repos.d/

總用量 32
-rw-r--r--. 1 root root 2573 11月 21 2014 CentOS-Base.repo
-rw-r--r--. 1 root root 1664 8月  23 2014 CentOS-Base.repo.rpmnew
-rw-r--r--. 1 root root  649 8月  23 2014 CentOS-Debuginfo.repo
-rw-r--r--. 1 root root  290 8月  23 2014 CentOS-fasttrack.repo
-rw-r--r--. 1 root root 1331 8月  23 2014 CentOS-Sources.repo
-rw-r--r--. 1 root root  156 8月  23 2014 CentOS-Vault.repo
-rw-r--r--. 1 root root 1084 11月 21 2014 epel.repo
-rw-r--r--  1 root root  531 6月  25 21:46 gitlab_gitlab-ce.repo

mv /etc/yum.repos.d/gitlab_gitlab-ce.repo /etc/yum.repos.d/gitlab_gitlab-ce.repo.bak

依次執行以下命令

yum  install  gcc
yum install -y git
mkdir git_clone
cd git_clone
git clone https://github.com/haad/proxychains
cd proxychains
./configure --sysconfdir=/usr/local/etc
make && make install

使用方法:
proxychains4 任何命令

proxychains的配置預設檔案在 [你執行git-clone命令時的目錄]/proxychains/src/proxychains.conf下，需要將它拷貝到 /etc/proxychains.conf 這個路徑下才能生效；
請自行搜尋可用的代理, 寫入 /etc/proxychains.conf中

還原gitlab-ce源
mv /etc/yum.repos.d/gitlab_gitlab-ce.repo.bak /etc/yum.repos.d/gitlab_gitlab-ce.repo
代理安裝GitLab:
proxychains4 yum install gitlab-ce

然而我找的socks5代理全都不能用.

這時, 我注意到一行小字

注意國情, 有官方機構提供映象的話不要盲目科學上網, 嘗試各種代理還不行簡直在浪費生命