最后一次更新时间：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
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
python2 --version
要求为3以下的python版本,但要高于2.5版本,如果版本过低,请升级Python版本.参考:http://blog.haohtml.com/archives/13959.这里我们使用 2.5.6版本的,测试的2.7版本好像也不支持的.换成2.5.6版本就正常了.
安装libyaml库
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 ../
2. Ruby
Remove old 1.8 ruby if present
#sudo apt-get remove ruby1.8
Download and compile it:
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 ../
Install the Bundler Gem:
gem install bundler
3. System Users
Create a git user for Gitlab:
groupadd git adduser git -g git
4. GitLab shell
GitLab Shell is a ssh access and repository management software developed specially for GitLab.
# Login as git
su git
# Go to home directory
cd /home/git
# Clone gitlab shell
git clone https://github.com/gitlabhq/gitlab-shell.git cd gitlab-shell
# switch to right version
git checkout v1.4.0
cp config.yml.example config.yml
# Edit config and replace gitlab_url
# with something like ‘http://domain.com/’
vim config.yml
# Do setup
./bin/install cd ../
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”
cd /home/git
Clone the Source
# Clone GitLab repository
sudo -u git -H git clone https://github.com/gitlabhq/gitlabhq.git gitlab
# Go to gitlab dir
cd /home/git/gitlab
# Checkout to stable release
sudo -u git -H git checkout 5-2-stable
Note: You can change 5-2-stable to master if you want the bleeding edge version, but do so with caution!
Configure it
cd /home/git/gitlab
# Copy the example GitLab config
sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml
# Make sure to change “localhost” to the fully-qualified domain name of your
# host serving GitLab where necessary
sudo -u git -H vim config/gitlab.yml
# Make sure GitLab can write to the log/ and tmp/ directories
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/
# Create directory for satellites
sudo -u git -H mkdir /home/git/gitlab-satellites
# Create directories for sockets/pids and make sure GitLab can write to them
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/
# Create public/uploads directory otherwise backup will fail
sudo -u git -H mkdir public/uploads<br />sudo chmod -R u+rwX public/uploads
# Copy the example Puma config
sudo -u git -H cp config/puma.rb.example config/puma.rb
# Configure Git global settings for git user, useful when editing via web
# Edit user.email according to what is set in gitlab.yml
sudo -u git -H git config --global user.name "GitLab"<br />sudo -u git -H git config --global user.email "gitlab@localhost"
Important Note: Make sure to edit both gitlab.yml and puma.rb to match your setup.
Configure GitLab DB settings
# Mysql(我们使用mysql)
sudo -u git cp config/database.yml.mysql config/database.yml
# PostgreSQL(这里不使用这个数据库，所有不用执行)
sudo -u git cp config/database.yml.postgresql config/database.yml
Make sure to update username/password in config/database.yml.
Install Gems
su root<br />cd /home/git/gitlab<br />gem install charlock_holmes --version '0.6.9.4'
# For MySQL (note, the option says “without”)
bundle install --deployment --without development test postgres
# Or for PostgreSQL
bundle install --deployment --without development test mysql
Initialize Database and Activate Advanced Features
bundle exec rake gitlab:setup RAILS_ENV=production
Install Init Script
Download the init script (will be /etc/init.d/gitlab):
cp lib/support/init.d/gitlab /etc/init.d/gitlab<br />chmod +x /etc/init.d/gitlab
Make GitLab start on boot:
chkconfig gitlab on
Check Application Status
Check if GitLab and its environment are configured correctly:
bundle exec rake gitlab:env:info RAILS_ENV=production
Start Your GitLab Instance
service gitlab start
# or
/etc/init.d/gitlab restart
启用服务时，如何提示：
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:
su git<br />bundle exec rake gitlab:check RAILS_ENV=production
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)．
可能还会提示需要执行一次下面的命令
bundle exec rake sidekiq:start RAILS_ENV=production
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:
cd /home/git/gitlab<br />cp lib/support/nginx/gitlab /usr/local/nginx/conf/gitlab<br />vim /usr/local/nginx/conf/nginx.conf
在server段中添加 include gitlab; 一行
修改配置文件gitlab，注意日志路径
vim /usr/local/nginx/conf/gitlab
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配置是否正确
/usr/local/nginx/sbin/nginx -t
重启Nginx
/usr/local/nginx/sbin/nginx -s reload
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.
注意关闭防火墙
service iptables stop
参考官方文档：https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md
注意nginx的运行用户权限问题.gitlab使用的是git:git用户，而nginx运行使用的www:www用户．这种情况会导致一些权限问题，可能会出现nginx 502错误，这里为了方便，要修改一下nginx的运行用户修改为 git，重启nginx就可以了．根据自己的自行设置权限.