centos 6.5安装GitLab全过程和问题记录

前端之家收集整理的这篇文章主要介绍了centos 6.5安装GitLab全过程和问题记录前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

from: http://www.01happy.com/centos-6-5-install-gitlab/

GitLab,是一个使用 Ruby on Rails 开发的开源应用程序,与Github类似,能够浏览源代码,管理缺陷和注释,非常适合在团队内部使用。

官方只提供了Debian/Ubuntu系统下的安装说明文档,如果需要在centos下安装,可以参考这篇:https://github.com/gitlabhq/gitlab-recipes/tree/master/install/centos,笔者依照这篇文章的说明,成功的在centos系统上安装了gitlab,分享一下自己的安装过程和碰到的问题。

安装的英文文档:centos-6-5-install-gitlab.zip

先秀下安装完成后的成果。

centos安装gitlab成果

开始之前

在开始之前请先查看官方的刚需文档: https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/requirements.md ,该文档说明了系统,软件和硬件等各方面的需求。详细的了解这些,可以避免碰到很多怪异的问题。

安装步骤总览

  • 基础操作系统(CentOS 6.4 Minimal,升级后为6.5)
  • Ruby (版本: 2.0.0p353)
  • 创建项目运行用户(创建git账号,方便权限管理)
  • GitLab Shell(版本:1.8.0)
  • 数据库(可以支持MysqL和Postgresql,这里使用MysqL,版本:5.1.17)
  • GitLab(版本:6.3.1)
  • Web服务器(可支持Nginx和apache,这里使用Nginx,版本:1.0.15)
  • 防火墙(iptables)

1、安装操作系统

这个比较简单,安装完成之后记的配置下网络,使其可以在启动时自动连接。而后需要升级系统和安装一些相应的软件和依赖包,以下逐一说明。

Tips:如果不能连接国外的网络,经常出现网络错误或者couldn’t not resolve host这样的错误,建议修改dns服务器为8.8.8.8和8.8.4.4。

a、升级操作系统和安装wget

  1. $ sudo yum -y update
  2. $ sudo yum -y install wget

升级完成后,系统版本是6.5。

笔者注:和英文文档不同,笔者这里是先升级系统和安装wget,不然后面的操作会提示wget命令找到。

b、增加EPEL安装源

EPEL,即Extra Packages for Enterprise Linux,这个软件仓库里有很多非常常用的软件,而且是专门针对RHEL设计的,对RHEL标准yum源是一个很好的补充,完全免费使用,由Fedora项目维护,所以如果你使用的是RHEL,或者CentOS,Scientific等RHEL系的linux,可以非常放心的使用EPEL的yum源。

下载并安装GPG key

  1. $ sudo wget -O /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6 https://www.fedoraproject.org/static/0608B895.txt
  2. $ sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6

检验下是否安装成功

  1. $ sudo rpm -qa gpg*

安装epel-release-6-8.noarch包

  1. $ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm

提示:不要在意x86_64,在i686的机器上一样能使用。

c、增加PUIAS安装源

PUIAS Linux是面向桌面和服务器的完整的操作系统,它靠编译Red Hat Enterprise Linux的源代码包来创建。除了这些上游的软件包外,该项目还提供一些其他的软件仓库:“Addons”包含了通常的Red Hat发行中未收入的额外软件包,“Computational”提供专门针对科学计算的软件,“Unsupported”则收入各种各样的测试性软件 包。该发行由美国普林斯顿 大学的高等研究所维护。

创建/etc/yum.repos.d/PUIAS_6_computational.repo,并添加如下内容

  1. [PUIAS_6_computational]
  2. name=PUIAS computational Base $releasever - $basearch
  3. mirrorlist=http://puias.math.ias.edu/data/puias/computational/$releasever/$basearch/mirrorlist
  4. #baseurl=http://puias.math.ias.edu/data/puias/computational/$releasever/$basearch
  5. gpgcheck=1
  6. gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-puias

下载并安装GPG key

  1. $ sudo wget -O /etc/pki/rpm-gpg/RPM-GPG-KEY-puias http://springdale.math.ias.edu/data/puias/6/x86_64/os/RPM-GPG-KEY-puias
  2. $ sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-puias

检验下是否安装成功

  1. $ sudo rpm -qa gpg*

Tips:安装完EPEL和PUIAS两个源后,可以检测下:

  1. $ sudo yum repolist

d、安装GitLab的所需依赖包和工具

  1. $ su -
  2. $ yum -y groupinstall 'Development Tools'
  3. $ yum -y install vim-enhanced readline readline-devel ncurses-devel gdbm-devel glibc-devel tcl-devel openssl-devel curl-devel expat-devel db4-devel byacc sqlite-devel gcc-c++ libyaml libyaml-devel libffi libffi-devel libxml2 libxml2-devel libxslt libxslt-devel libicu libicu-devel system-config-firewall-tui python-devel redis sudo wget crontabs logwatch logrotate perl-Time-HiRes git

RHEL提示
如果部分包不能安装,例如: eg. gdbm-devel,libffi-devel and libicu-devel,那么增加rhel6的安装源。

  1. $ yum-config-manager --enable rhel-6-server-optional-rpms

e、配置redis

配置redis使其在开机时启动:

  1. $ sudo chkconfig redis on
  2. $ sudo service redis start

f、配置邮件服务器

笔者注:这个过程笔者没有配置,请参考英文文档。

2、安装Ruby

下载并编译:

  1. $ su -
  2. $ mkdir /tmp/ruby && cd /tmp/ruby
  3. $ curl --progress ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p353.tar.gz | tar xz
  4. $ cd ruby-2.0.0-p353
  5. $ ./configure --prefix=/usr/local/
  6. $ make && make install

安装完成后,重新登录终端确保$PATH生效,检测ruby的安装成功与否:

  1. $ which ruby
  2. /usr/local/bin/ruby
  3. $ ruby -v
  4. ruby 2.0.0p353 (2013-11-22 revision 43784) [x86_64-linux]

安装bundle:

  1. $ sudo gem install bundler --no-ri --no-rdoc

如果提示sudo: gem: command not found,使用root账号登录执行该命令即可。

3、系统用户

创建用户git

  1. $ su -
  2. $ adduser --system --shell /bin/bash --comment 'GitLab' --create-home --home-dir /home/git/ git

因为git用户不需要登录,所以这里不需要设置git的密码。

转发所有邮件

笔者注:因为上面没有配置发送邮件,这里也省略。

4、配置GitLab shell

GitLab shell是专门为GitLab开发的提供ssh访问和版本管理的软件。

先使用root登录,而后切换成git

  1. $ su -
  2. $ su - git

克隆gitlab shell

  1. $ git clone https://github.com/gitlabhq/gitlab-shell.git
  2. $ cd gitlab-shell

切换成1.8.0版本,并编辑配置

  1. $ git checkout v1.8.0
  2. $ cp config.yml.example config.yml

这里最重要的是将gitlab_url修改成gitlab的访问域名。形如:http://test.gitlab.com/

笔者注:如果gitlab是使用https访问,则需将http替换成https,配置文件中的self_signed_cert要修改成true,否则gitlab shell在通过api和gitlab进行通信的时候就会出现错误,导致项目push出错。因为后面配置web服务器的时候是使用ssl,所以这里要按照ssl的方式配置。

Tips: 另外如果使用的域名是测试域名,不要忘记在系统的/etc/hosts做域名映射。

安装一些需要的目录和文件

  1. $ ./bin/install

5、安装数据库

笔者这里使用的是msyql,关于Postgresql的安装请参考原文档。

安装MysqL并设置开机启动:

  1. $ su -
  2. $ yum install -y MysqL-server MysqL-devel
  3. $ chkconfig MysqLd on
  4. $ service MysqLd start

设置MysqL root账号的密码:

  1. $ /usr/bin/MysqL_secure_installation

创建新用户数据库给gitlab使用

  1. # 登录数据库
  2. $ MysqL -u root -p
  3. # 输入root密码
  4. # 为gitlab创建使用用户
  5. CREATE USER 'gitlab'@'localhost' IDENTIFIED BY 'gitlab账号的密码';
  6.  
  7. # 创建gitlaba使用的数据库
  8. CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
  9.  
  10. # 给予gitlab用户权限
  11. GRANT SELECT,LOCK TABLES,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON `gitlabhq_production`.* TO 'gitlab'@'localhost';
  12.  
  13. # 登出数据库
  14. \q

6、安装GitLab

将GitLab安装在git的家目录下:

  1. $ su -
  2. $ su - git

a、克隆GitLab并切换分支到6-3-stable

  1. # 克隆GitLab
  2. $ git clone https://github.com/gitlabhq/gitlabhq.git gitlab
  3. # 进入gitlab目录
  4. $ cd /home/git/gitlab
  5. # 切换到6-3-stable分支
  6. $ git checkout 6-3-stable

b、配置项目

  1. # 复制配置文件
  2. $ cp config/gitlab.yml.example config/gitlab.yml
  3.  
  4. # 修改配置文件中的访问域名
  5. your_domain_name为项目的访问域名)
  6. $ sed -i 's|localhost|your_domain_name|g' config/gitlab.yml
  7.  
  8. # 设定log和tmp目录所有者和权限
  9. $ chown -R git log/
  10. $ chown -R git tmp/
  11. $ chmod -R u+rwX log/
  12. $ chmod -R u+rwX tmp/
  13.  
  14. # 创建gitlab-satellites目录
  15. $ mkdir /home/git/gitlab-satellites
  16.  
  17. # 创建tmp/pids/和tmp/sockets/目录,确保gitlab有相应的权限
  18. $ mkdir tmp/pids/
  19. $ mkdir tmp/sockets/
  20. $ chmod -R u+rwX tmp/pids/
  21. $ chmod -R u+rwX tmp/sockets/
  22.  
  23. # 创建public/uploads目录
  24. $ mkdir public/uploads
  25. $ chmod -R u+rwX public/uploads
  26.  
  27. # 复制unicorn配置
  28. $ cp config/unicorn.rb.example config/unicorn.rb
  29.  
  30. # 编辑unicorn配置
  31. (笔者这里采用默认配置)
  32. $ vim config/unicorn.rb
  33.  
  34. # 配置git的用户邮件
  35. $ git config --global user.name "GitLab"
  36. $ git config --global user.email "gitlab@your_domain_name"
  37. $ git config --global core.autocrlf input

这边的配置比较复杂,细心些就行了。

c、配置数据库访问文件

  1. $ cp config/database.yml.MysqL config/database.yml

编辑config/database.yml,设置其中连接数据库的账号密码,笔者的配置部分如下:

  1. #
  2. # PRODUCTION
  3. #
  4. production:
  5. adapter: MysqL2
  6. encoding: utf8
  7. reconnect: false
  8. database: gitlabhq_production
  9. pool: 10
  10. username: gitlab
  11. password: "gitlab"
  12. # host: localhost
  13. # socket: /tmp/MysqL.sock

修改其中username和password就可以了,其中密码就是上面数据库步骤中创建gitlab用户的密码。

确保该文件只有git账号有权限读取。

  1. $ chmod o-rwx config/database.yml

d、安装Gems

  1. $ su -
  2. $ gem install charlock_holmes --version '0.6.9.4'
  3. $ exit

安装MysqL

  1. $ cd /home/git/gitlab/
  2. $ bundle install --deployment --without development test postgres puma aws

e、初始化数据和激活高级功能

  1. $ cd /home/git/gitlab
  2. $ bundle exec rake gitlab:setup RAILS_ENV=production

这步完成后,会生一个默认的管理员账号:

  1. admin@local.host
  2. 5iveL!fe

f、安装启动脚本

  1. $ su -
  2. $ wget -O /etc/init.d/gitlab https://raw.github.com/gitlabhq/gitlab-recipes/master/init/sysvinit/centos/gitlab-unicorn
  3. $ chmod +x /etc/init.d/gitlab
  4. $ chkconfig --add gitlab

开机时启动

  1. $ chkconfig gitlab on

g、检测应用程序状态

  1. $ su - git
  2. $ cd gitlab/
  3. $ bundle exec rake gitlab:env:info RAILS_ENV=production
  4. $ exit

可以查看到系统、Ruby、GitLab和GitLab Shell的版本和其他信息。

启动GitLab实例

  1. $ service gitlab start

h、查看应用更加详细的信息

  1. $ su - git
  2. $ cd gitlab/
  3. $ bundle exec rake gitlab:check RAILS_ENV=production

这里会提示一个Init script up-to-date的错误,如下:

  1. Init script up-to-date? ... no
  2. Try fixing it:
  3. Redownload the init script
  4. For more information see:
  5. doc/install/installation.md in section "Install Init Script"
  6. Please fix the error above and rerun the checks.

原文说明不用介意这个问题。

7、安装web服务器

笔者选择的是Nginx,关于apache方面的请参考原文档

  1. $ su -
  2. $ yum -y install Nginx
  3. $ chkconfig Nginx on
  4. $ mkdir /etc/Nginx/sites-available
  5. $ mkdir /etc/Nginx/sites-enabled
  6. $ wget -O /etc/Nginx/sites-available/gitlab https://raw.github.com/gitlabhq/gitlab-recipes/master/web-server/Nginx/gitlab-ssl
  7. $ ln -sf /etc/Nginx/sites-available/gitlab /etc/Nginx/sites-enabled/gitlab

编辑/etc/Nginx/Nginx.conf,将 include /etc/Nginx/conf.d/*.conf; 替换成 include /etc/Nginx/sites-enabled/*;,就是修改额外加载的配置文件目录。

编辑/etc/Nginx/sites-available/gitlab,将配置中server_name替换成实际访问的域名。

Nginx加入git用户

  1. $ usermod -a -G git Nginx
  2. $ chmod g+rx /home/git/

添加ssl证书或者自己生成一个

  1. $ cd /etc/Nginx
  2. $ openssl req -new -x509 -nodes -days 3560 -out gitlab.crt -keyout gitlab.key

启动Nginx

  1. $ service Nginx start

8、配置防火墙

配置iptables,使用户可以访问http、https和ssh的端口。

  1. $ lokkit -s http -s https -s ssh

重新启动防火墙

  1. $ service iptables restart

至此就算安装完成了。默认的账号密码:

  1. admin@local.host
  2. 5iveL!fe

问题记录

a、网站不能添加用户和创建项目问题?

查了下日志,发现是权限的问题:

Errno::EACCES (Permission denied – /home/git/gitlab/log/application.log):

修改用户和所属用户组为git就可以了。

b、无法push?

在上面安装GitLab shell步骤时,一开始笔者是将配置中的gitlab_url设置成http://test.gitlab.com/,结果在push的时候出错了,后来查看GitLab项目日志,才发现GitLab shell和GitLab通信的时候产生了一个301跳转。这点通过GitLab的Nginx配置也能看的出来。后来将http替换成https,self_signed_cert设置成true就OK了。

总结

安装的过程比较长,其中大部分时间花在了包的下载上。笔者以前没有接触过ruby,安装的过程中也了解了下Ruby、Gem、Bundle等软件,受益匪浅。一般来讲,照着上面的步骤安装,如果系统,软件等版本都一致的话,应该能成功安装。如果出现问题,可以多查查日志。GitLab项目的日志在该项目的log目录内。GitLab shell的日志在GitLab shell项目中的gitlab-shell.log

感谢

在安装的过程中多亏了朋友雷志伟的帮忙,少走了不少弯路。此外他现在正在汉化GitLab,英文不好的朋友有福了,有兴趣的朋友也可以参与进来,也可以直接使用已经汉化好的文件,地址:http://git.oschina.net/linxuix/Git-Lab-Zh。

猜你在找的CentOS相关文章