最后一次更新时间：2013-05-29
https://github.com/gitlabhq/gitlabhq
gitlab 5.2.0
centos6.3 i686
Redis 2.6.13
nginx-1.4.1
mysql-5.5.31-linux2.6-i686.tar.gz
这里与官方的教程有些不一样，主要是一些软件如mysql nginx redis之类的以前是手动编译安装的．
网上也有提供一键安装包工具:http://bitnami.com/stack/gitlab
gitlab中文使用指南:GitLab使用介绍
首先我们选择比较快的yum源，不然安装速度会非常的慢的.这里使用中国科技大学的yum源http://lug.ustc.edu.cn/wiki/mirrors/help/centos更换yum源方法参考：http://blog.haohtml.com/archives/5669,
说明：
默认安装的git版本可能会低一些，需要升级到最新版本才可以.
1. Packages / Dependencies
[shell]yum -y install readline-devel gdbm-devel ncurses-devel openssl-devel zlib-devel gcc gcc-c++ make autoconf curl-devel expat-devel gettext-devel tk-devel libxml2-devel libffi-devel libxslt-devel libicu-devel git-all python-devel vim sudo[/shell]
[shell]python2 –version[/shell]
要求为3以下的python版本,但要高于2.5版本,如果版本过低,请升级Python版本.参考:http://blog.haohtml.com/archives/13959.这里我们使用 2.5.6版本的,测试的2.7版本好像也不支持的.换成2.5.6版本就正常了.
安装libyaml库
[shell]wget -c http://pyyaml.org/download/libyaml/yaml-0.1.4.tar.gz
tar xzvf yaml-0.1.4.tar.gz
cd yaml-0.1.4
./configure –prefix=/usr/local
make;make install
cd ../[/shell]
2. Ruby
Remove old 1.8 ruby if present
#sudo apt-get remove ruby1.8
Download and compile it:
[shell]mkdir /tmp/ruby
cd /tmp/ruby
curl –progress http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p392.tar.gz | tar xz
cd ruby-1.9.3-p392
./configure
make
make install
cd ../[/shell]
Install the Bundler Gem:
[shell]gem install bundler[/shell]
3. System Users
Create a git user for Gitlab:
[shell]groupadd git
adduser git -g git[/shell]
4. GitLab shell
GitLab Shell is a ssh access and repository management software developed specially for GitLab.
# Login as git
[shell]su git[/shell]
# Go to home directory
[shell]cd /home/git[/shell]
# Clone gitlab shell
[shell]git clone https://github.com/gitlabhq/gitlab-shell.git
cd gitlab-shell[/shell]
# switch to right version
[shell]git checkout v1.4.0[/shell]
[shell]cp config.yml.example config.yml[/shell]
# Edit config and replace gitlab_url
# with something like ‘http://domain.com/’
[shell]vim config.yml[/shell]
# Do setup
[shell]./bin/install
cd ../[/shell]
gitlab要使用redis-server软件，redis的安装参考：http://www.cnblogs.com/hb_cattle/archive/2011/10/22/2220907.html
5. Database
mysql安装教程参考 http://blog.haohtml.com/archives/12473
安装Mysql数据库,gitlab数据库配置:To setup the MySQL/PostgreSQL database and dependencies please see doc/install/databases.md.
6. GitLab
# We’ll install GitLab into home directory of the user “git”
[shell]cd /home/git[/shell]
Clone the Source
# Clone GitLab repository
[shell]sudo -u git -H git clone https://github.com/gitlabhq/gitlabhq.git gitlab[/shell]
# Go to gitlab dir
[shell]cd /home/git/gitlab[/shell]
# Checkout to stable release
[shell]sudo -u git -H git checkout 5-2-stable[/shell]
Note: You can change 5-2-stable to master if you want the bleeding edge version, but do so with caution!
Configure it
[shell]cd /home/git/gitlab[/shell]
# Copy the example GitLab config
[shell]sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml[/shell]
# Make sure to change “localhost” to the fully-qualified domain name of your
# host serving GitLab where necessary
[shell]sudo -u git -H vim config/gitlab.yml[/shell]
# Make sure GitLab can write to the log/ and tmp/ directories
[shell]sudo chown -R git log/<br />sudo chown -R git tmp/<br />sudo chmod -R u+rwX log/<br />sudo chmod -R u+rwX tmp/[/shell]
# Create directory for satellites
[shell]sudo -u git -H mkdir /home/git/gitlab-satellites[/shell]
# Create directories for sockets/pids and make sure GitLab can write to them
[shell]sudo -u git -H mkdir tmp/pids/<br />sudo -u git -H mkdir tmp/sockets/<br />sudo chmod -R u+rwX tmp/pids/<br />sudo chmod -R u+rwX tmp/sockets/[/shell]
# Create public/uploads directory otherwise backup will fail
[shell]sudo -u git -H mkdir public/uploads<br />sudo chmod -R u+rwX public/uploads[/shell]
# Copy the example Puma config
[shell]sudo -u git -H cp config/puma.rb.example config/puma.rb[/shell]
# Configure Git global settings for git user, useful when editing via web
# Edit user.email according to what is set in gitlab.yml
[shell]sudo -u git -H git config –global user.name "GitLab"<br />sudo -u git -H git config –global user.email "gitlab@localhost"[/shell]
Important Note: Make sure to edit both gitlab.yml and puma.rb to match your setup.
Configure GitLab DB settings
# Mysql(我们使用mysql)
[shell]sudo -u git cp config/database.yml.mysql config/database.yml[/shell]
# PostgreSQL(这里不使用这个数据库，所有不用执行)
[shell]sudo -u git cp config/database.yml.postgresql config/database.yml[/shell]
Make sure to update username/password in config/database.yml.
Install Gems
[shell]su root<br />cd /home/git/gitlab<br />gem install charlock_holmes –version ‘0.6.9.4’[/shell]
# For MySQL (note, the option says “without”)
[shell]bundle install –deployment –without development test postgres[/shell]
# Or for PostgreSQL
[shell]bundle install –deployment –without development test mysql[/shell]
Initialize Database and Activate Advanced Features
[shell]bundle exec rake gitlab:setup RAILS_ENV=production[/shell]
Install Init Script
Download the init script (will be /etc/init.d/gitlab):
[shell]cp lib/support/init.d/gitlab /etc/init.d/gitlab<br />chmod +x /etc/init.d/gitlab[/shell]
Make GitLab start on boot:
[shell]chkconfig gitlab on[/shell]
Check Application Status
Check if GitLab and its environment are configured correctly:
[shell]bundle exec rake gitlab:env:info RAILS_ENV=production[/shell]
Start Your GitLab Instance
[shell]service gitlab start[/shell]
# or
[shell]/etc/init.d/gitlab restart[/shell]
启用服务时，如何提示：
bash: bundle: command not found
GitLab service started
错误信息，说明用户的环境变量不合适，先whereis bundle 命令查看出来bundle命令所在的位置，然后添加到 /etc/profile 里就可以了．
在export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE HISTCONTROL下面添加一行
export PATH=$PATH:/usr/local/bin
参考：http://blog.haohtml.com/archives/9765
Double-check Application Status
To make sure you didn’t miss anything run a more thorough check with:
[shell]su git<br />bundle exec rake gitlab:check RAILS_ENV=production[/shell]
If all items are green, then congratulations on successfully installing GitLab! However there are still a few steps left.
这里可能会提示git的版本过低的问题(上面的git-all)，只需要重新安装一下git,参考：http://blog.haohtml.com/archives/10093 然后在配置文件config/gitlab.yml里git的bin_path路径就可以了, 这里我将git安装在/usr/local/目录里了.命令在 /usr/local/bin/git 位置，所以配置为(bin_path: /usr/local/bin/git)．
可能还会提示需要执行一次下面的命令
[shell]bundle exec rake sidekiq:start RAILS_ENV=production[/shell]
7. Nginx
Installation
Nginx安装教程可参考：http://blog.haohtml.com/archives/12473
Note: If you can’t or don’t want to use Nginx as your web server, have a look at the Advanced Setup Tips section.
Site Configuration
Download an example site config:
[shell]cd /home/git/gitlab<br />cp lib/support/nginx/gitlab /usr/local/nginx/conf/gitlab<br />vim /usr/local/nginx/conf/nginx.conf[/shell]
在server段中添加 include gitlab; 一行
修改配置文件gitlab，注意日志路径
[shell]vim /usr/local/nginx/conf/gitlab[/shell]
Make sure to edit the config file to match your setup:
# **YOUR_SERVER_FQDN** to the fully-qualified
# domain name of your host serving GitLab. Also, replace
# the ‘listen’ line with the following:
# listen 80 default_server; # e.g., listen 192.168.1.1:80;
测试nginx配置是否正确
[shell]/usr/local/nginx/sbin/nginx -t[/shell]
重启Nginx
[shell]/usr/local/nginx/sbin/nginx -s reload[/shell]
Done!
Visit YOUR_SERVER for your first GitLab login. The setup has created an admin account for you. You can use it to log in:
admin@local.host
5iveL!fe
Important Note: Please go over to your profile page and immediately change the password, so nobody can access your GitLab by using this login information later on.
注意关闭防火墙
[shell]service iptables stop[/shell]
参考官方文档：https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md
注意nginx的运行用户权限问题.gitlab使用的是git:git用户，而nginx运行使用的www:www用户．这种情况会导致一些权限问题，可能会出现nginx 502错误，这里为了方便，要修改一下nginx的运行用户修改为 git，重启nginx就可以了．根据自己的自行设置权限.