官方安裝教程
開源版本和企業版本對比:https://www.gitlab.cc/features/#enterprise
解決官方無法安裝的情況
編輯源
使用清華大學 TUNA 鏡像源 打開網址將內容複製到gitlab-ce.repo
文件中,編輯路徑
vim /etc/yum.repos.d/gitlab-ce.repo [gitlab-ce] name=gitlab-ce baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6 repo_gpgcheck=0 gpgcheck=0 enabled=1 gpgkey=https://packages.gitlab.com/gpg.key
更新本地 YUM 緩存
sudo yum makecache
建立新版nginx的yum倉庫
wget http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm rpm -ivh nginx-release-centos-6-0.el6.ngx.noarch.rpm
安裝git
如果已經用yum安裝過git,並且版本低於2.7.4,要先卸載掉舊的版本
yum remove git yum install vim curl openssh-server openssh-clients gcc-c++ zlib1g-dev zlib-devel curl-devel expat-devel gettext-devel opgcc perl-ExtUtils-MakeMaker
使用源碼編譯安裝git
mkdir /tmp/git && cd /tmp/git curl -O --progress https://www.kernel.org/pub/software/scm/git/git-2.8.5.tar.gz tar zxvf git-2.8.5.tar.gz cd git-2.8.5 ./configure make prefix=/usr/local all # 安裝到/usr/local/bin make prefix=/usr/local install # 驗證git版本號 git --version #查看git安裝路徑 which git #創建軟連接 ln -s /usr/local/bin/git /usr/bin/git
安裝 GitLab 社區版
sudo yum install gitlab-ce #(自動安裝最新版) sudo yum install gitlab-ce-8.8.4-ce.0.el6 #(安裝指定版本)
配置並啓動GitLab
# vim /etc/gitlab/gitlab.rb # 找到 external_url 'http://000.00.00.00:8081' # 修改成你的地址 # 然後執行下面的命令,對GitLab進行編譯。 sudo gitlab-ctl reconfigure #啓動gitlab sudo gitlab-ctl restart
可能遇到的問題
解決方法:
是因爲/etc/gitlab/gitlab.rb文件中的內容是: external_url 'hostname' 將其修改爲: external_url='hostname' 即可,只需要在原來的配置項中添加個 ‘=’ 即可
登錄GitLab
Username: root Password: 5iveL!fe
GitLab漢化
Gitlab中文社區版地址:https://gitlab.com/xhang/gitlab
1. 使用 marbleqi 製作的漢化增量補丁包
注: 使用該漢化補丁包需要重新配置編譯資源文件
sudo gitlab-ctl reconfigure
2. 手動導出漢化補丁包漢化
請先使用官方包安裝或升級完成,確認當前版本。
sudo cat /opt/gitlab/embedded/service/gitlab-rails/VERSION 9.3.5
假設當前版本爲 v9.3.5,並確認漢化版本庫是否包含該版本的漢化標籤(-zh結尾),也就是是否包含 v9.3.5-zh。
# 克隆漢化版本庫 git clone https://gitlab.com/xhang/gitlab.git # 如果已經克隆過,則進行更新 git fetch
# 導出9.3.5 版本的漢化補丁
git diff v9.3.5 v9.3.5-zh > ../9.3.5-zh.diff
然後上傳 9.0.0-zh.diff 文件到服務器。
# 停止 gitlab sudo gitlab-ctl stop sudo patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < ../9.3.5-zh.diff
確定沒有 .rej 文件,重啓 GitLab 即可。
sudo gitlab-ctl start
執行重新配置命令
sudo gitlab-ctl reconfigure
如果漢化中出現問題,請重新安裝 GitLab(注意備份數據)。
此時訪問http://192.168.0.80就是全中文頁面了
GitLab配置更改
當gitlab安裝完成後,根據自己的環境,要修改配置。
如:
gitlab修改nginx端口,綁定IP等
gitlab修改ssh端口
gitlab修改訪問url等
gitlab修改數據庫類型(這個沒必要,因爲這裏的數據庫只存儲些用戶名,gitlab代碼放在/var/opt/gitlab/git-data/下)
gitlab修改redis,gunicorn配置等等
所有的配置在/etc/gitlab/gitlab.rb中修改,修改完配置後執行gitlab-ctl reconfigure生效
gitlab所有的工程目錄都在/var/opt/gitlab/下
# ls /var/opt/gitlab/ backups bootstrapped git-data gitlab-rails gitlab-shell logrotate nginx postgresql redis
修改配置示例:
#grep -v '#' gitlab.rb |grep -v ^$ external_url 'http://gitlab.sec.com' gitlab_rails['gitlab_shell_ssh_port'] = 2222 nginx['listen_addresses']= ['10.18.103.1'] 修改url是別人通過url拉取代碼,IP對客戶端透明。修改ssh port及nginx綁定IP等爲環境需要解決衝突。
GitLab頭像無法正常顯示
原因:gravatar被牆 解決辦法: 編輯 /etc/gitlab/gitlab.rb,將
# gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'
修改爲:
gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'
然後在命令行執行:
sudo gitlab-ctl reconfigure sudo gitlab-rake cache:clear RAILS_ENV=production
nginx配置
解決 80 端口被佔用 upstream gitlab { server 114.55.111.111:8081 ; } server { #偵聽的80端口 listen 80; server_name git.diggg.cn; location / { proxy_pass http://gitlab; #在這裏設置一個代理,和upstream的名字一樣 #以下是一些反向代理的配置可刪除 proxy_redirect off; #後端的Web服務器可以通過X-Forwarded-For獲取用戶真實IP proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; client_max_body_size 10m; #允許客戶端請求的最大單文件字節數 client_body_buffer_size 128k; #緩衝區代理緩衝用戶端請求的最大字節數 proxy_connect_timeout 300; #nginx跟後端服務器連接超時時間(代理連接超時) proxy_send_timeout 300; #後端服務器數據回傳時間(代理髮送超時) proxy_read_timeout 300; #連接成功後,後端服務器響應時間(代理接收超時) proxy_buffer_size 4k; #設置代理服務器(nginx)保存用戶頭信息的緩衝區大小 proxy_buffers 4 32k; #proxy_buffers緩衝區,網頁平均在32k以下的話,這樣設置 proxy_busy_buffers_size 64k; #高負荷下緩衝大小(proxy_buffers*2) proxy_temp_file_write_size 64k; #設定緩存文件夾大小,大於這個值,將從upstream服務器傳 } } # 檢查配置 /usr/local/nginx-1.5.1/sbin/nginx -tc conf/nginx.conf # nginx 重新加載配置 /usr/local/nginx-1.5.1/sbin/nginx -s reload
運維
# 啓動所有 gitlab 組件: sudo gitlab-ctl start # 停止所有 gitlab 組件: sudo gitlab-ctl stop # 重啓所有 gitlab 組件: sudo gitlab-ctl restart # 查看服務狀態 sudo gitlab-ctl status # 啓動服務 sudo gitlab-ctl reconfigure # 修改默認的配置文件 sudo vim /etc/gitlab/gitlab.rb # 查看版本 sudo cat /opt/gitlab/embedded/service/gitlab-rails/VERSION # echo "vm.overcommit_memory=1" >> /etc/sysctl.conf # sysctl -p # echo never > /sys/kernel/mm/transparent_hugepage/enabled # 檢查gitlab gitlab-rake gitlab:check SANITIZE=true --trace # 查看日誌 sudo gitlab-ctl tail
備份恢復
Gitlab 創建備份
使用Gitlab一鍵安裝包安裝Gitlab非常單, 同樣的備份恢復與遷移也非常簡單,用一條命令即可創建完整的Gitlab備份:
gitlab-rake gitlab:backup:create #如果使用源碼安裝的gitlab話,使用以下命令 sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
以上命令將在/var/opt/gitlab/backups目錄下創建一個名稱類似爲xxxxxxxx_gitlab_backup.tar的壓縮包, 這個壓縮包就是Gitlab整個的完整部分, 其中開頭的xxxxxx是備份創建的時間戳。
也可以使用SKIP變量來選擇要備份的內容,SKIP變量的選項有:db, uploads (attachments), repositories, builds(CI build output logs), artifacts (CI build artifacts), lfs (LFS objects)。多個項之間用逗號隔開:
sudo gitlab-rake gitlab:backup:create SKIP=db,uploads1
backup命令執行之後,終端上會出現導出數據庫及repo數據等的的操作日誌。
Gitlab 修改備份文件默認目錄
修改/etc/gitlab/gitlab.rb
來修改默認存放備份文件的目錄:
gitlab_rails['backup_path'] = '/mnt/backups'
修改後使用gitlab-ctl reconfigure命令重載配置文件。
備份
0 2 * * * /usr/bin/gitlab-rake gitlab:backup:create 0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create
恢復
首先進入備份 gitlab 的目錄,這個目錄是配置文件中的 gitlab_rails['backup_path']
,默認爲 /var/opt/gitlab/backups
。
然後停止 unicorn 和 sidekiq ,保證數據庫沒有新的連接,不會有寫數據情況。
# 停止相關數據連接服務 gitlab-ctl stop unicorn # ok: down: unicorn: 0s, normally up gitlab-ctl stop sidekiq # ok: down: sidekiq: 0s, normally up # 從xxxxx編號備份中恢復 # 然後恢復數據,1406691018爲備份文件的時間戳 gitlab-rake gitlab:backup:restore BACKUP=1406691018 # 啓動Gitlab sudo gitlab-ctl start
# 恢復過程中沒有權限 mkdir /var/opt/gitlab/backups chown git /var/opt/gitlab/backups chmod 700 /var/opt/gitlab/backups # 恢復成功頁面報沒有權限的錯誤 sudo chown -R git:git /var/opt/gitlab/git-data/repositories sudo chmod -R ug+rwX,o-rwx /var/opt/gitlab/git-data/repositories sudo chmod -R ug-s /var/opt/gitlab/git-data/repositories sudo find /var/opt/gitlab/git-data/repositories -type d -print0 | sudo xargs -0 chmod g+
遷移
把備份文件拷貝到gitlab的備份目錄下,根據上面gitlab恢復步驟即可。
錯誤處理
Error executing action `run` on resource 'bash[migrate gitlab-rails database]'
https://gitlab.com/gitlab-org/gitlab-ce/issues/2052#note_1667899
NameError: uninitialized constant Devise::Async
本文參考:http://www.cnblogs.com/chinajava/p/5870683.html