搭建 Linux 下 GitLab 服務器【轉】
轉自:http://blog.csdn.net/passion_wu128/article/details/8216086
版權聲明:本文為博主原創文章,未經博主允許不得轉載。
目錄(?)[-]
- 平臺需求
- 硬件需求
- 本安裝指南已於 DebianUbuntu 測試通過
- 重要信息
- 1 安裝依賴包
- 數據庫
- SQLite
- MySQL
- PostgreSQL
- 2 安裝 Ruby
- 3 安裝 Gitolite
- 檢查退出並重新登錄以使 git 用戶組生效
- 4 克隆 GitLab 源代碼並安裝先決條件
- 選擇你希望使用的數據庫
- 安裝數據庫 gems
- 初始化數據庫
- 設置 GitLab hooks
- 確認應用程序狀態
- 5 設置 web server
- 6 運行 Resque 進程用於處理工作隊列
- Nginx 與 Unicorn
- 1 Unicorn
- 2 Nginx
- 3 Init 腳本
這兩天因為項目需求需要搭建一個GitLab服務器,遇到了很多問題,參考了很多網絡資料,終於搭建成功,在此把這個過程記錄一下,利人利己。
一、最終目的
1,在Linux下創建GitLab服務器,客戶端能夠完成Git 的 clone,pull,commit,push操作。
2,能夠通過瀏覽器訪問服務器上的GitLab主頁,登錄之後能夠實現,創建工程,增加用戶等操作。
二、準備知識
雖然按照後續過程能夠實現最終目的,但本人強烈建議讀者大致了解下以下知識點。(本人就是因為事先對有些知識不了解導致搭建過程中困難重重)
1,git的基本用法
2,gitolite和github
3,ssh認證
4,uginx代理服務器
三、搭建環境
服務器: Ubuntu11.04(本人使用的是虛擬機),需要已經啟動了ssh服務。
測試客戶端:Win7,需要先安裝git
四、開始搭建
原文鏈接地址
https://github.com/gitlabhq/gitlabhq/blob/stable/doc/installation.md
參考: http://www.zhigang.net/ (感謝這位網友的分享)
平臺需求:
此項目被設計用於linux操作系統。
也許可以工作在 FreeBSD 與 Mac OS 系統,但我們無法保證系統穩定性與功能完整性。
官方支持的 Linux 發行版:
- Ubuntu Linux
- Debian/GNU Linux
它應該工作於:
- Fedora
- CentOS
- RedHat
你使用這些系統需要些運氣,但不保證穩定性:
- MacOS X
- FreeBSD
GitLab 不能運行於 Windows 並且我們也沒有支持的計劃。
硬件需求:
我們推薦至少 1GB 內容用於 gitlab 實例。
本安裝指南已於 Debian/Ubuntu 測試通過。
- 安裝總共需要6步:
- 安裝依賴包
- 安裝 Ruby
- 安裝 Gitolite
- 安裝與配置 GitLab
- 啟動前端Web服務器
- 啟動Resque進行(用於後臺任務)
重要信息
在你發郵件列表詢問安裝與配置問題之前請確認你已經根據本文完成了所有步驟。
Only create a GitHub Issue if you want a specific part of this installation guide updated.
Also read the Read this before you submit an issue wiki page.
使用這個安裝腳本可以輕易的跳過前3個步驟。
# 安裝 curl 與 sudo apt-get install curl sudo # 三合一命令 :) curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu.sh | sh 使用這個命令默認的數據庫依賴包是mysql的.現在你可以直接到到第四步
如果你在 Amazon Web Services 使用 Ubuntu 12.04,你可以使用一個命令跳過所有步驟(1-6)
curl https://raw.github.com/gitlabhq/gitlab-recipes/master/install/debian_ubuntu_aws.sh | sh更多詳細信息,你可以閱讀此腳本的 HOWTO 部分。
筆者註:本人使用了三合一命令欲跳過前三步,但後續安裝怎麽都不成功,後來才發現第二步安裝有問題,按照第2步要求安裝ruby就可以了。
所以請關註這個三個一命令狀態,確保都能執行成功。
1. 安裝依賴包
請記住,Debian 默認並沒有安裝 sudo,請使用 root 安裝它:
apt-get update && apt-get upgrade && apt-get install sudo
現在你可以安裝必須包:
sudo apt-get update sudo apt-get upgrade sudo apt-get install -y wget curl gcc checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libreadline6-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip libyaml-dev postfix libpq-dev
數據庫
SQLite
sudo apt-get install -y sqlite3 libsqlite3-dev
MySQL
sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev # Login to MySQL $ mysql -u root -p # Create the GitLab production database mysql> CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`; # Create the MySQL User change $password to a real password mysql> CREATE USER [email protected] IDENTIFIED BY ‘$password‘; # Grant proper permissions to the MySQL User mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO [email protected];
PostgreSQL
sudo apt-get install -y postgresql-9.2 postgresql-server-dev-9.2 # Connect to database server sudo -u postgres psql -d template1 # Add a user called gitlab. Change $password to a real password template1=# CREATE USER gitlab WITH PASSWORD ‘$password‘; # Create the GitLab production database template1=# CREATE DATABASE IF NOT EXISTS gitlabhq_production; # Grant all privileges on database template1=# GRANT ALL PRIVILEGES ON DATABASE gitlabhq_production to gitlab; # Quit from PostgreSQL server template1=# \q # Try connect to new database $ su - gitlab $ psql -d gitlabhq_production -U gitlab
(譯者註:以上3種數據庫根據需要安裝其一即可)
2. 安裝 Ruby
wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p194.tar.gz tar xfvz ruby-1.9.3-p194.tar.gz cd ruby-1.9.3-p194 ./configure make sudo make install
3. 安裝 Gitolite
為 Git 創建用戶:
sudo adduser --system --shell /bin/sh --gecos ‘git version control‘ --group --disabled-password --home /home/git git
為 GitLab 創建用戶:
# ubuntu/debian sudo adduser --disabled-login --gecos ‘gitlab system‘ gitlab
將 gitlab 用戶添加到 git 用戶組:
sudo usermod -a -G git gitlab
將 git 用戶添加到 gitlab 用戶組:
sudo usermod -a -G gitlab git
生成密鑰:
sudo -H -u gitlab ssh-keygen -q -N ‘‘ -t rsa -f /home/gitlab/.ssh/id_rsa
克隆 GitLab 的 Gitolite 分支源代碼:
sudo -H -u git git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite
安裝:
cd /home/git sudo -u git -H mkdir bin sudo -u git sh -c ‘echo -e "PATH=\$PATH:/home/git/bin\nexport PATH" >> /home/git/.profile‘ sudo -u git sh -c ‘gitolite/install -ln /home/git/bin‘ sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub sudo chmod 0444 /home/git/gitlab.pub sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gitolite setup -pk /home/git/gitlab.pub"
權限:
sudo chmod -R g+rwX /home/git/repositories/ sudo chown -R git:git /home/git/repositories/
檢查:退出並重新登錄以使 git 用戶組生效
# 克隆 admin 資源庫以將 localhost 添加到 known_hosts # 並且確認 gitlab 用戶有權訪問 gitolite sudo -u gitlab -H git clone [email protected]:gitolite-admin.git /tmp/gitolite-admin # 如果執行成功,你可以將其刪除 sudo rm -rf /tmp/gitolite-admin
重要! 如果你不能克隆 gitolite-admin 資源庫,請不要繼續本次安裝,請根據 Trouble Shooting Guide 並且確認你已經小心的完成上文的全部步驟。
筆者註:這一步測試能否克隆成功。本人沒有註意這個提示,[email protected]:gitolite-admin.git的方式克隆工程,原因就是ssh認證失敗,所以請務必確認這一點。順便說下本人ssh認證失敗的原因: /etc/ssh/sshd_config配置文件裏面PubkeyAuthentication的值為no,意味著不允許公鑰認證,改為yes就可以了。如果還是不能克隆,重復下第3步,並且註意每個命令是否執行成功。或者刪除git和gitlab用戶,重新執行第3步。
4. 克隆 GitLab 源代碼並安裝先決條件
sudo gem install charlock_holmes --version ‘0.6.8‘ sudo pip install pygments sudo gem install bundler cd /home/gitlab # Get gitlab code. Use this for stable setup sudo -H -u gitlab git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab (2013/1/6,最近發現最新的版本是4.0.0.rc2,這個版本已經沒有支持sqlite,而我選擇sql數據庫的時候沒有成功, 克隆之後執行 sudo -u gitlab git checkout 2.9.1 可以回到2.9.1的版本,這個版本既支持sqlite,其gitlab管理界面也較美觀。3.1.0以後的版本管理界面都有點難看。) # Skip this for stable setup.(筆者註:執行了上個命令就不用執行這個命令了) # Master branch (recent changes, less stable) sudo -H -u gitlab git clone -b master https://github.com/gitlabhq/gitlabhq.git gitlab cd gitlab # Rename config files sudo -u gitlab cp config/gitlab.yml.example config/gitlab.yml
選擇你希望使用的數據庫
筆者註:建議選擇SQLite# SQLite sudo -u gitlab cp config/database.yml.sqlite config/database.yml # Mysql sudo -u gitlab cp config/database.yml.mysql config/database.yml # PostgreSQL sudo -u gitlab cp config/database.yml.postgres config/database.yml # 修改 config/database.yml 確認輸入了正確的用戶名/密碼
安裝數據庫 gems
# mysql sudo -u gitlab -H bundle install --without development test sqlite postgres --deployment # 或者 postgres sudo -u gitlab -H bundle install --without development test sqlite mysql --deployment # 或者 sqlite sudo -u gitlab -H bundle install --without development test mysql postgres --deployment
初始化數據庫
sudo -u gitlab bundle exec rake gitlab:app:setup RAILS_ENV=production
設置 GitLab hooks
sudo cp ./lib/hooks/post-receive /home/git/.gitolite/hooks/common/post-receive sudo chown git:git /home/git/.gitolite/hooks/common/post-receive
確認應用程序狀態:
sudo -u gitlab bundle exec rake gitlab:app:status RAILS_ENV=production # OUTPUT EXAMPLE Starting diagnostic config/database.yml............exists config/gitlab.yml............exists /home/git/repositories/............exists /home/git/repositories/ is writable?............YES remote: Counting objects: 603, done. remote: Compressing objects: 100% (466/466), done. remote: Total 603 (delta 174), reused 0 (delta 0) Receiving objects: 100% (603/603), 53.29 KiB, done. Resolving deltas: 100% (174/174), done. Can clone gitolite-admin?............YES UMASK for .gitolite.rc is 0007? ............YES /home/git/share/gitolite/hooks/common/post-receive exists? ............YES
筆者註:如果所有結果都是 YES,恭喜!你可以繼續進行下一步。
5. 設置 web server
應用可以用下一個命令行動:
# 用於測試目的 sudo -u gitlab bundle exec rails s -e production # 用於守護進程 sudo -u gitlab bundle exec rails s -e production -d
默認登錄用戶名及密碼:
筆者註:記住這個用戶名和密碼,在通過瀏覽器登錄gitlab工程主頁的時候有用。
[email protected] 5iveL!fe
6. 運行 Resque 進程(用於處理工作隊列)
# 手動啟動 sudo -u gitlab bundle exec rake environment resque:work QUEUE=* RAILS_ENV=production BACKGROUND=yes # GitLab 啟動腳本 sudo -u gitlab ./resque.sh # 如果你使用 root 運行此腳本,會導致 /home/gitlab/gitlab/tmp/pids/resque_worker.pid 文件的擁有者為 root # 將導致 resque 在下一次系統初始化中無法啟動
自定義 Resque 使用的 Redis 連接
如果你希望 Resque 連接到一個非標準端口號或另一臺服務器上的 redis,你可以在 config/resque.yml 文件修改連接信息:
production: redis.example.com:6379
好了,我們已經擁有了一個工作正常的 GitLab 了,但請繼續下去,有一些事情是必須完成的。
Nginx 與 Unicorn
1. Unicorn
cd /home/gitlab/gitlab sudo -u gitlab cp config/unicorn.rb.example config/unicorn.rb sudo -u gitlab bundle exec unicorn_rails -c config/unicorn.rb -E production -D
2. Nginx
# 初次安裝 Nginx sudo apt-get install nginx # 添加GitLab 到 nginx sites sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/nginx/gitlab -P /etc/nginx/sites-available/ sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab # 修改 **YOUR_SERVER_IP** 與 **YOUR_SERVER_FQDN** # 為起初的 IP 地址與準備讓 GitLab 服務的域名sudo vim /etc/nginx/sites-enabled/gitlab筆者註:本人最初的時候不知道這個配置文件怎麽配置,在瀏覽器裏輸入服務器ip的時候老是出現“welcome to nginx”頁面。後來的配置是listion 80; #監聽所有80端口的客戶端請求server_name: 192.168.1.120; #這是我ubuntu服務器的ip地址。因為我們是小組局域網訪問,所以直接配ip地址就可以了。遠程訪問的話可以通過vpn鏈接。
# 重啟 nginx:sudo /etc/init.d/nginx restart
3. Init 腳本
在 /etc/init.d/gitlab 創建 init 腳本:
sudo wget https://raw.github.com/gitlabhq/gitlab-recipes/master/init.d/gitlab -P /etc/init.d/ sudo chmod +x /etc/init.d/gitlab
設置 GitLab 自動啟動:
sudo update-rc.d gitlab defaults 21
現在你可以用這種方式啟動/重啟/停止 GitLab 服務:
sudo /etc/init.d/gitlab restart
至此搭建過程全部完成,關於添加用戶和創建工程請參考這篇博文:
http://blog.csdn.net/passion_wu128/article/details/8218041
搭建 Linux 下 GitLab 服務器【轉】