安装GitLab

一、准备工作 根据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用户密码，那么请在客户机上使用以下命令将用户私钥加进来 （根据个人的密匙命名不同更改 id_rsa）： 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/%E6%9D%A5%E6%B5%8B%E8%AF%95GitLab%E8%83%BD%E6%98%AF%E5%90%A6%E6%AD%A3%E5%B8%B8%E5%B7%A5%E4%BD%9C%E3%80%82%E5%A6%82%E6%9E%9C%E4%B8%80%E5%88%87%E6%AD%A3%E5%B8%B8%E7%9A%84%E8%AF%9D%EF%BC%8C%E5%B0%B1%E5%8F%AF%E4%BB%A5%E6%89%93%E5%AE%8C%E6%94%B6%E5%8A%9F%E4%BA%86%EF%BC%81