如何在Ubuntu Server 11.10上安装GitLab

kaywang

　　在写了《如何在Ubuntu Server 11.10上安装Gitorious》这篇博文之后，很多兄弟反应这个安装的过程过于复杂，能否找到一个在Ubuntu上安装比较简单的Git系统，得益于Google和百度，本人在网上找到了GitLab，正如其名字长度那样，相对于Gitorious来说在Ubuntu上的安装要简单不少，故将其安装过程记下即也可以满足兄弟们的要求，也可以备查。
　　一、准备工作
　　根据GitLab的官方文档要求，安装GitLab需要以下软件：

• ruby 1.9.2
  
• sqlite
  
• ubuntu/debian
  
• pygments lib  - sudo pip install pygments
  
• gitolite
  

　　因此在安装GitLab之前需要做一些准备工作。
　　1、设置安装环境（安装一些必要软件）
　　

• sudo apt-get update
  
• sudo apt-get dist-upgrade -y
  
• sudo apt-get install git-core openssh-server sendmail curl gcc libxml2-dev libxslt-dev sqlite3 libsqlite3-dev libcurl4-openssl-dev libreadline-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev python-setuptools
  

　　

　　*安装VMWare Tools（这是在虚拟机环境下需要安装的，如果不是的可忽略）
　　

• sudo apt-get update -y
  
• sudo apt-get dist-upgrade -y
  
• sudo apt-get install dkms build-essential gcc linux-headers-$(uname -r) -y
  
• sudo mkdir -p /media/cdrom
  
• sudo mount /dev/cdrom /media/cdrom
  
• cp /media/cdrom/VM* /tmp
  
• sudo umount /media/cdrom
  
• cd /tmp
  
• tar -xzvf VMware*.gz
  
• cd vmware-tools-distrib/
  
• sudo ./vmware-install.pl -d
  
• sudo apt-get autoremove -y
  
• sudo shutdown -r now
  

　　

　　上面关于虚拟机的部分是摘抄官网的，因为没环境测试，所以也只是原样照搬了。:)
　　2、设置专门的帐号
　　接下来我们需要创建一个专门的gitlabhq用户帐号来运行程序，这个帐户需要设置密码，因为需要将它加入到admin组来运行sudo：
　　

• sudo useradd -s /bin/bash -m -G admin gitlabhq
  
• sudo passwd gitlabhq
  

　　

　　现在使用gitlabhq用户帐号登录机器：
　　

• ssh gitlabhq@localhost
  

　　

　　3、配置git全局变量并生成SSH密钥
　　

• git config --global user.email "admin@local.host"
  
• git config --global user.name "GitLabHQ Admin User"
  

　　

　　由于gitlabhq用户稍后要使用SSH密钥访问稍后创建git用户帐号，执行git命令，所以需要生成gitlabhq用户的SSH密钥：
　　

• ssh-keygen -t rsa
  

　　

　　注意：在出现提示询问文件保存位置时直接回车，在要求输入和确认passphrase时也按回车。
　　4、安装Ruby 1.9.2、RubyGem和Rails
　　Ubuntu 11.10中的Ruby包，其版本是1.8的，所以需要安装包ruby1.9.2。由于在Ubuntu 11.10中的Ruby1.9.1包中ruby版本实际上是Ruby1.9.2，之所以包名为Ruby1.9.1是因为该版本为1.9.1的“库兼容版本”，所以可以直接安装包Ruby1.9.1即可，然后更新rubygem并安装rails。
　　

• sudo apt-get install ruby1.9.1-full
  
• sudo update-alternatives --config ruby
  
• sudo update-alternatives --config gem
  
• sudo gem install rails
  

　　

　　注意两点：1)、02-03行命令是在安装了其他ruby版本包时使用；2)、如果在安装rails时出现“RubyGems will revert  to legacy indexes degrading performance.”之类的错误时，修改~/.gemrc文件后重试（有时要试多次才进行安装，一般来说都会3－6次之间，下面的bundle命令也是如此，不知道是不是伟大的墙在起作用，看你的运气了！）：
　　

• vi ~/.gemrc
  
• ---
  
• :backtrace: false
  
• :benchmark: false
  
• :bulk_threshold: 1000
  
• :sources:
  
• - http://gems.rubyforge.org/
  
• - http://gems.github.com/
  
• - http://gems.rubyonrails.org/
  
• :update_sources: true
  
• :verbose: true
  

　　

　　5、安装和设置Gitolite
　　Gitolite 是一款 Perl 语言开发的 Git 服务管理工具，通过公钥对用户进行认证，并能够通过配置文件对写操作进行基于分支和路径的的精细授权，它是采用 SSH 协议并且使用 SSH 公钥认证的。Gitolite开始于 2009年8月，其作者当时是受到了 Gitosis 的启发，开发了这款功能更为强大和易于安装的软件。对于Gitolite的命名，作者原意是  Gitosis 和 lite 的组合，不过因为 Gitolite 的功能越来越强大，已经超越了 Gitosis，因此作者笑称 Gitolite  可以看作是 Github-lite —— 轻量级的 Github。
　　安装Gitolite也十分简单，首先添加git用户帐号并将其加入git组：
　　

• sudo adduser \
  
•   --system \
  
•   --shell /bin/sh \
  
•   --gecos 'git version control' \
  
•   --group \
  
•   --disabled-password \
  
•   --home /home/git \
  
•   git
  
• sudo usermod -a -G git `eval whoami`
  

　　

　　然后将生成的gitlabhq用户的公钥拷到git用户目录中：
　　

• sudo cp ~/.ssh/id_rsa.pub /home/git/rails.pub
  

　　

　　接下来以git用户的名义将gitolite源文件下载的git用户家目录中：
　　

• sudo -u git -H git clone git://github.com/gitlabhq/gitolite ~git/gitolite
  

　　

　　再以git用户的名义安装gitolite
　　

• sudo -u git -H /home/git/gitolite/src/gl-system-install
  

　　

　　在这里该命令会提示关于目录的警告信息，不用理会。直接运行下列命令：
　　

• sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gl-setup ~/rails.pub"
  

　　

　　在这里将会出现vim文本编辑器的编辑界面，请将其中的REPO_UMASK=0077改为REPO_UMASK=0007，然后保存退出（退出编辑状态ESC，然后使用:x）。关于如何在vim中编辑这里就不做说明了，我偷个懒，反正有谷歌和百度。:)
　　最后设置库目录的权限：
　　

• sudo chmod -R g+rwX ~git/repositories/
  
• sudo chown -R git:git ~git/repositories/
  

　　

　　OK，设置完了之后，重新进入一次gitlabhq用户，以使gitlabhq用户生效：
　　

• exit
  
• ssh gitlabhq@localhost
  

　　

　　二、安装和设置GitLab
　　1、安装GitLab
　　

• cd ~
  
• git clone git://github.com/gitlabhq/gitlabhq.git ~/gitlabhq
  
• cd gitlabhq
  
• sudo easy_install pygments
  
• sudo gem install bundler
  
• sudo gem install linecache19 -- --with-ruby-include=/usr/include/ruby-1.9.1/ruby/
  
• bundle install --without development test
  

　　

　　注意：linecache19的安装是必须要指定with-ruby-include参数的，否则将会在后面的bundle install中出错！
　　2、设置数据库
　　

• bundle exec rake db:setup RAILS_ENV=production
  
• bundle exec rake db:seed_fu RAILS_ENV=production
  

　　

　　注意：运行01行的rake db:setup语句时，如果出现“unititialized constant  Rake::DSL”，则需要在GitLab根目录中的Rakefile文件中添加以下语句（参见http://stackoverflow.com /questions/6268518/uninitialized-constant-rakedsl-in-ruby-gem）来解决，如未出现上述出错信息，可忽略：
　　

• require 'rake/dsl_definition'
  
• require 'rake'
  

　　

　　3、配置GitLab
　　编辑GitLab的配置程序：
　　

• vi ~gitlabhq/gitlabhq/config/gitlab.yml
  

　　

　　将下列内容
　　

• git_host:
  
•   system: gitolite
  
•   admin_uri: git@localhost:gitolite-admin
  
•   base_path: /home/git/repositories/
  
•   host: gitlab
  
•   git_user: git
  
•   # port: 22
  

　　

　　修改为：
　　

• git_host:
  
•   system: gitolite
  
•   admin_uri: git@localhost:gitolite-admin
  
•   base_path: /home/git/repositories/
  
•   host: gitlabhq.your.domain
  
•   git_user: git
  
•   # port: 22
  

　　

　　其中03和05行中的gitlabhq.your.domain是服务器的域名。
　　启动服务
　　

　　

• cd ~gitlabhq/gitlabhq
  
• bundle exec rails s -e production
  

　　

　　三、测试服务
　　如果一切OK的话，就可以在浏览器上输入：http://server.ip:3000/ 来测试该服务了，使用以下信息登录：
　　

• Email:    admin@local.host
  
• Password: 5iveL!fe
  

　　

　　接下来您可以在admin中创建一个新的用户，注意该用户在创建时要花费一段时间，请耐心等待。在该用户生成成功后，您需要按照前面的方法在客户机上生成该用户的密钥（Windows下可以使用Git for Windows中的Git Bash来代替）：
　　

• ssh-keygen -t rsa -C "your_email@youremail.com"
  

　　

　　然后用新用户登录，点击GitLab中My profile>Keys>Add new按钮，将生成的SSH公钥贴到弹出对话框的Key中，Title可随便填，我一般是使用用户_机器名这种格式，然后点击Save按钮。
　　在保存用户公钥之后，就可测试是否可以通过公钥来访问服务器上的git用户，执行git命令：
　　

• ssh -T git@gitlabhq.your.domain
  

　　


　　其中，gitlabhq.your.domain是服务器的域名。如果出现"Agent admitted failure to sign using the key"错误，并提示输入git用户密码，那么请在客户机上使用以下命令将用户私钥加进来 （根据个人的密匙命名不同更改>　　

• ssh-add   ~/.ssh/id_rsa
  
• ssh -T git@gitlabhq.your.domain hello your_email_youremail_com_1324608633, this is gitolite v2.2-11-g8c4d1aa    running on git 1.7.5.4 the gitolite config gives you the following access:   @R_ @W_testing
  

　　

　　再次访问git，如出现类似02行信息时，则表明设置成功。
　　四、安裝和配置 Nginx和Passenger
　　1、卸载Apache2
　　

• sudo apt-get autoremove apache2*
  
• sudo dpkg --purge apache2*
  

　　

　　2、安装Nginx和Passenger模块
　　

• sudo gem install passenger
  
• sudo passenger-install-ngnix-module
  

　　

　　注意：02行语句会检查编译Ngnix和Passenger模块所需要的工具，然后询问你是否有Ngnix的源码，如果没有的话，就选1，会自动下载，如果有的话，就选2，并告之源码所在位置。在这里选择1。
　　3、创建运行Nginx服务的用户
　　

• sudo adduser --system --no-create-home --disabled-login --disabled-password --group nginx
  

　　

　　4、将Nginx设置开机启动脚本
　　

• wget -O init-deb.sh http://library.linode.com/assets/660-init-deb.sh
  
• sudo mv init-deb.sh /etc/init.d/nginx
  
• sudo chmod +x /etc/init.d/nginx
  
• sudo /usr/sbin/update-rc.d -f nginx defaults
  

　　

　　5、将Nginx设置为GitLab的服务器
　　

• sudo vi /opt/nginx/conf/nginx.conf
  
• 
  
• user gitlabhq staff;
  
• # ---
  
• server {
  
•   listen 80;
  
•   server_name gitlabhq.your.domain;
  
•   root /home/gitlabhq/gitlabhq/public;
  
•   passenger_enabled on;
  
• }
  
• # ---
  

　　

　　其中，07行的gitlab.yourdomain.com要改为你的域名。
　　6、启动Nginx
　　

• sudo /etc/init.d/nginx start
  

　　

　　五、测试服务
　　在浏览器中输入http://gitlab.yourdomain.com/来测试GitLab能是否正常工作。如果一切正常的话，就可以打完收功了！