如何在Ubuntu Server 11.10上安装GitLab

2022-01-21 03:05:33

在写了《如何在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、设置安装环境（安装一些必要软件）



    

  1. sudo apt-get update
    2. 

  2. sudo apt-get dist-upgrade -y
    3. 

  3. 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  
    4. 



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




    

  1. sudo apt-get update -y 
    2. 

  2. sudo apt-get dist-upgrade -y 
    3. 

  3. sudo apt-get install dkms build-essential gcc linux-headers-$(uname -r) -y 
    4. 

  4. sudo mkdir -p /media/cdrom 
    5. 

  5. sudo mount /dev/cdrom /media/cdrom 
    6. 

  6. cp /media/cdrom/VM* /tmp 
    7. 

  7. sudo umount /media/cdrom 
    8. 

  8. cd /tmp 
    9. 

  9. tar -xzvf VMware*.gz 
    10. 

  10. cd vmware-tools-distrib/ 
    11. 

  11. sudo ./vmware-install.pl -d 
    12. 

  12. sudo apt-get autoremove -y 
    13. 

  13. sudo shutdown -r now 
    14. 



上面关于虚拟机的部分是摘抄官网的，因为没环境测试，所以也只是原样照搬了。:)


2、设置专门的帐号


接下来我们需要创建一个专门的gitlabhq用户帐号来运行程序，这个帐户需要设置密码，因为需要将它加入到admin组来运行sudo：




    

  1. sudo useradd -s /bin/bash -m -G admin gitlabhq 
    2. 

  2. sudo passwd gitlabhq 
    3. 



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




  1. ssh gitlabhq@localhost 


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




    

  1. git config --global user.email "admin@local.host" 
    2. 

  2. git config --global user.name "GitLabHQ Admin User" 
    3. 



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




  1. 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。




    

  1. sudo apt-get install ruby1.9.1-full
    2. 

  2. sudo update-alternatives --config ruby
    3. 

  3. sudo update-alternatives --config gem
    4. 

  4. sudo gem install rails
    5. 



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




    

  1. vi ~/.gemrc 
    2. 

  2. ---  
    3. 

  3. :backtrace: false 
    4. 

  4. :benchmark: false 
    5. 

  5. :bulk_threshold: 1000 
    6. 

  6. :sources:  
    7. 

  7. - http://gems.rubyforge.org/ 
    8. 

  8. - http://gems.github.com/ 
    9. 

  9. - http://gems.rubyonrails.org/ 
    10. 

  10. :update_sources: true 
    11. 

  11. :verbose: true 
    12. 



5、安装和设置Gitolite


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


安装Gitolite也十分简单，首先添加git用户帐号并将其加入git组：




    

  1. sudo adduser \ 
    2. 

  2.   --system \ 
    3. 

  3.   --shell /bin/sh \ 
    4. 

  4.   --gecos 'git version control' \ 
    5. 

  5.   --group \ 
    6. 

  6.   --disabled-password \ 
    7. 

  7.   --home /home/git \ 
    8. 

  8.   git
    9. 

  9. sudo usermod -a -G git `eval whoami` 
    10. 



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




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


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




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


再以git用户的名义安装gitolite




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


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




  1. 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中编辑这里就不做说明了，我偷个懒，反正有谷歌和百度。:)


最后设置库目录的权限：




    

  1. sudo chmod -R g+rwX ~git/repositories/ 
    2. 

  2. sudo chown -R git:git ~git/repositories/ 
    3. 



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




    

  1. exit 
    2. 

  2. ssh gitlabhq@localhost 
    3. 



二、安装和设置GitLab


1、安装GitLab




    

  1. cd ~
    2. 

  2. git clone git://github.com/gitlabhq/gitlabhq.git ~/gitlabhq 
    3. 

  3. cd gitlabhq
    4. 

  4. sudo easy_install pygments 
    5. 

  5. sudo gem install bundler
    6. 

  6. sudo gem install linecache19 -- --with-ruby-include=/usr/include/ruby-1.9.1/ruby/ 
    7. 

  7. bundle install --without development test 
    8. 



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


2、设置数据库




    

  1. bundle exec rake db:setup RAILS_ENV=production 
    2. 

  2. bundle exec rake db:seed_fu RAILS_ENV=production 
    3. 



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




    

  1. require 'rake/dsl_definition' 
    2. 

  2. require 'rake' 
    3. 



3、配置GitLab


编辑GitLab的配置程序：




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


将下列内容




    

  1. git_host: 
    2. 

  2.   system: gitolite 
    3. 

  3.   admin_uri: git@localhost:gitolite-admin 
    4. 

  4.   base_path: /home/git/repositories/ 
    5. 

  5.   host: gitlab 
    6. 

  6.   git_user: git 
    7. 

  7.   # port: 22 
    8. 



修改为：




    

  1. git_host: 
    2. 

  2.   system: gitolite 
    3. 

  3.   admin_uri: git@localhost:gitolite-admin 
    4. 

  4.   base_path: /home/git/repositories/ 
    5. 

  5.   host: gitlabhq.your.domain 
    6. 

  6.   git_user: git 
    7. 

  7.   # port: 22 
    8. 



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


启动服务




    

  1. cd ~gitlabhq/gitlabhq
    2. 

  2. bundle exec rails s -e production 
    3. 



三、测试服务


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




    

  1. Email:    admin@local.host 
    2. 

  2. Password: 5iveL!fe 
    3. 



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




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


然后用新用户登录，点击GitLab中My profile>Keys>Add new按钮，将生成的SSH公钥贴到弹出对话框的Key中，Title可随便填，我一般是使用用户_机器名这种格式，然后点击Save按钮。


在保存用户公钥之后，就可测试是否可以通过公钥来访问服务器上的git用户，执行git命令：




  1. ssh -T git@gitlabhq.your.domain 


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




    

  1. ssh-add   ~/.ssh/id_rsa
    2. 

  2. 
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 
    3. 



 再次访问git，如出现类似02行信息时，则表明设置成功。


四、安裝和配置 Nginx和Passenger


1、卸载Apache2




    

  1. sudo apt-get autoremove apache2* 
    2. 

  2. sudo dpkg --purge apache2* 
    3. 



2、安装Nginx和Passenger模块




    

  1. sudo gem install passenger 
    2. 

  2. sudo passenger-install-ngnix-module 
    3. 



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


3、创建运行Nginx服务的用户




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


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




    

  1. wget -O init-deb.sh http://library.linode.com/assets/660-init-deb.sh 
    2. 

  2. sudo mv init-deb.sh /etc/init.d/nginx 
    3. 

  3. sudo chmod +x /etc/init.d/nginx 
    4. 

  4. sudo /usr/sbin/update-rc.d -f nginx defaults 
    5. 



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




    

  1. sudo vi /opt/nginx/conf/nginx.conf 
    2. 

  2.  
    3. 

  3. user gitlabhq staff; 
    4. 

  4. # --- 
    5. 

  5. server {  
    6. 

  6.   listen 80;  
    7. 

  7.   server_name gitlabhq.your.domain;  
    8. 

  8.   root /home/gitlabhq/gitlabhq/public;  
    9. 

  9.   passenger_enabled on;  
    10. 

  10. }  
    11. 

  11. # ---  
    12. 



 其中，07行的gitlab.yourdomain.com要改为你的域名。


6、启动Nginx




  1. sudo /etc/init.d/nginx start 


五、测试服务


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








本文转自 firehare 51CTO博客，原文链接：http://blog.51cto.com/firehare/743509，如需转载请自行联系原作者
上一篇：Python天天美味(3) - 字符转换

下一篇：PolarDB-X 1.0-用户指南-SQL调优指南-SQL调优进阶-查询执行器介绍