gitlab详细安装过程，错误解决方案

 在centos6.5中安装 GitLab 全过程和问题记录

如果你想省事，使用最新版本的gitlab，请下载一键安装包，一键安装

脚本：https://bitnami.com/stack/gitlab/installer

   

下载后安装时候请查看README

readme：https://bitnami.com/stack/gitlab/README.txt

以下是编译安装，真TM麻烦

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

 

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，这里使用tengine-1.5.2)

• 防火墙（iptables）

1、安装操作系统

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

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

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

$ sudo yum -y update
$ 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

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

检验下是否安装成功

$ sudo rpm -qa gpg*

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

$ 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，并添加如下内容：

[PUIAS_6_computational]
name=PUIAS computational Base
 $releasever -
 $basearchmirrorlist=
 $releasever/$basearch/mirrorlist
 #baseurl=
 $basearchgpgcheck=1
 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-puias

下载并安装GPG key

$ 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
$ sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-puias

检验下是否安装成功

$ sudo rpm -qa gpg*

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

$ sudo yum repolist

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

$ su -$ yum -y groupinstall 'Development Tools'
$ 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  redi  sudo wget crontabs logwatch logrotate perl-Time-HiRes git

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

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

e、配置redis

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

$此处redis是yum安装，为了省事、
$ sudo chkconfig redis on
$ sudo service redis start

f、配置邮件服务器

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

2、安装Ruby

下载并编译：

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

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

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

安装bundle：

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

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

3、系统用户

创建用户git

$ su -
$ 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

$ su -
$ su - git

克隆gitlab shell

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

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

$ git checkout v1.8.0
$ 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做域名映射。如果自己有DNS服务器，则不需要绑定hosts

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

$ ./bin/install

5、安装数据库

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

安装mysql并设置开机启动：

 此处我选择安装MySQL的二进制包：安装参考文档：http://douya.blog.51cto.com/6173221/1579986

设置mysql root账号的密码：

$ mysqladmin  -uroot password 'your password'

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

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

6、安装GitLab

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

$ su -
$ su - git

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

# 克隆GitLab
$ git clone https://github.com/gitlabhq/gitlabhq.git gitlab
# 进入gitlab目录
$ cd /home/git/gitlab
# 切换到6-3-stable分支  ,需要的可以切换到5.0稳定版 
$ git checkout 6-3-stable

b、配置项目

# 复制配置文件
$ cp config/gitlab.yml.example config/gitlab.yml
# 修改配置文件中的访问域名（your_domain_name为项目的访问域名）
$ sed -i 's|localhost|your_domain_name|g' config/gitlab.yml\
 设定log和tmp目录所有者和权限
 $ chown -R git log/
 $ chown -R git tmp/
 $ chmod -R u+rwX log/
 $ chmod -R u+rwX tmp/
 # 创建gitlab-satellites目录
 $ mkdir /home/git/gitlab-satellites
 # 创建tmp/pids/和tmp/sockets/目录，确保gitlab有相应的权限
 $ mkdir tmp/pids/
 $ mkdir tmp/sockets/
 $ chmod -R u+rwX tmp/pids/
 $ chmod -R u+rwX tmp/sockets/
 # 创建public/uploads目录
 $ mkdir public/uploads
 $ chmod -R u+rwX public/uploads
 # 复制unicorn配置
 $ cp config/unicorn.rb.example config/unicorn.rb
 # 编辑unicorn配置（笔者这里采用默认配置）
 $ vim config/unicorn.rb
 # 配置git的用户和邮件
 $ git config --global user.name "GitLab"
 $ git config --global user.email "gitlab@your_domain_name"
 $ git config --global core.autocrlf input

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

c、配置数据库访问文件

$ cp config/database.yml.mysql config/database.yml

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

## PRODUCTION#production:
  adapter: mysql2
  encoding: utf8
  reconnect: false
  database: gitlabhq_production
  pool: 10
  username: gitlab
  password: "gitlab"
  # host: localhost
  # socket: /tmp/mysql.sock

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

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

$ chmod o-rwx config/database.yml

d、安装Gems

$ sudo  gem install charlock_holmes --version '0.6.9.4'  此时会遇到一个错误，由于在国内无法访问国外网站原因
[root@gitlab gitlab]# gem install charlock_holmes --version '0.6.9.4'
 
ERROR:  Could not find a valid gem 'charlock_holmes' (= 0.6.9.4), here is why:
          Unable to download