GitLab 安装配置笔记(转)

renshanshan

GitLab的安装方式
　　GitLab的两种安装方法:

• 编译安装　　
  
  
  
  
  • 优点：可定制性强。数据库既可以选择MySQL,也可以选择PostgreSQL;服务器既可以选择Apache，也可以选择Nginx。
    
  • 缺点：国外的源不稳定，被墙时，依赖软件包难以下载。配置流程繁琐、复杂，容易出现各种各样的问题。依赖关系多，不容易管理，卸载GitLab相对麻烦。
    
  
  
• 通过rpm包安装　　
  
  
  
  
  • 优点：安装过程简单，安装速度快。采用rpm包安装方式，安装的软件包便于管理。
    
  • 缺点：数据库默认采用PostgreSQL，服务器默认采用Nginx，不容易定制。
    
  
  

　　由于公司只配备了一台阿里云服务器，并且没有分配任何的域名。该服务器上需要运行版本控制软件、bug管理软件、知识库等多套程序，只能采用ip的方式访问。原先采用GitLab+Apache+MySQL编译安装的方式，并且将GitLab配置为可通过xxx.xx.xxx.xx/gitlab的形式访问，由于bug管理软件（禅道）也运行于Apache之上，两套软件之间彼此有互斥的影响，找不到解决方法。同时，GitLab的注册需要邮箱验证，由于网上提供的配置方法都是基于域名的，在阿里云上多次进行配置都无法正常使用。
　　因此，只能放弃编译安装的方式，而采取rpm包的方式重新进行安装。

安装GitLab CE Omnibus包

• 
  　　在linux终端下，使用cat /etc/issue命令查询当前系统的发行版本，查询到阿里云所安装的linux版本为CentOS>
  
• 　　进入gitlab官方网站,选择对应的操作系统——CentOS 6 (and RedHat/Oracle/Scientific Linux 6),按照官方的提示进行安装：
  
  
  
  • 　　安装配置必要的依赖
    　　在Centos 6 和 7 中，以下的命令将会打开HTTP和SSH在系统防火墙中的可访问权限。
    　　
    
    sudo yum install openssh-server　　
    
    　　
    sudo yum install postfix
    　　
    
    　　
    sudo yum install cronie
    　　
    
    　　
    sudo service postfix start
    　　
    
    　　
    sudo chkconfig postfix on
    　　
    
    　　
    sudo lokkit -s http -s ssh
    　　
    
    　　
    
    　　
    
    
    
  • 　　下载Omnibus package包并安装
    　　
    
    curl -O https://downloads-packages.s3.amazonaws.com/centos-6.6/gitlab-ce-7.10.0~omnibus.2-1.x86_64.rpm　　
    sudo rpm -i gitlab-ce-7.10.0~omnibus.2-1.x86_64.rpm
    　　
    
    　　
    
    Note:由于amazonaws的服务器被墙，下载这个包时可能需要FQ下载。　　
    
    　　
    
    
    
  • 　　配置并启动GitLab
    　　打开/etc/gitlab/gitlab.rb,将external_url = 'http://git.example.com'修改为自己的IP地址：http://xxx.xx.xxx.xx,，然后执行下面的命令，对GitLab进行编译。
    　　
    
    sudo gitlab-ctl reconfigure　　
    
    　　
    
    
    
  • 　　登录GitLab
    　　
    
    Username: root　　
    Password: 5iveL!fe
    　　
    
    　　
    
    
    
  
  

配置GitLab的默认发信邮箱

• GitLab中使用postfix进行邮件发送。因此，可以卸载系统中自带的sendmail。　　使用yum list installed查看系统中是否存在sendmail，若存在，则使用yum remove sendmail指令进行卸载。
  
  
• 　　测试系统是否可以正常发送邮件。
  　　
  
  echo "Test mail from postfix" | mail -s "Test Postfix" xxx@xxx.com　　
  
  　　
  
  注：上面的xxx@xxx.com为你希望收到邮件的邮箱地址。　　
  
  　　
  
  　　当邮箱收到系统发送来的邮件时，将系统的地址复制下来，如：root@iZ23syflhhzZ.localdomain,打开/etc/gitlab/gitlab.rb,将
  　　
  
  # gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'　　
  
  　　
  
  　　修改为
  　　
  
  gitlab_rails['gitlab_email_from'] = 'root@iZ23syflhhzZ.localdomain'　　
  
  　　
  
  　　保存后，执行sudo gitlab-ctl reconfigure重新编译GitLab。如果邮箱的过滤功能较强，请添加系统的发件地址到邮箱的白名单中，防止邮件被过滤。
  　　
  
  Note:系统中邮件发送的日志可通过`tail /var/log/maillog`命令进行查看。　　
  
  　　
  
  
  

安装过程中出现的问题

• 　　在浏览器中访问GitLab出现502错误
  　　原因：内存不足。
  　　解决办法：检查系统的虚拟内存是否随机启动了，如果系统无虚拟内存，则增加虚拟内存，再重新启动系统。
  
  
• 　　80端口冲突
  　　原因：Nginx默认使用了80端口。
  　　解决办法：为了使Nginx与Apache能够共存，并且为了简化GitLab的URL地址，Nginx端口保持不变，修改Apache的端口为4040。这样就可以直接用使用ip访问Gitlab。而禅道则可以使用4040端口进行访问，像这样：xxx.xx.xxx.xx:4040/zentao。具体修改的地方在/etc/httpd/conf/httpd.conf这个文件中，找到Listen 80这一句并将之注释掉，在底下添加一句Listen 4040，保存后执行service httpd restart重启apache服务即可。
  　　
  
  #Listen 80　　
  Listen 4040
  　　
  
  　　
  
  
  
• 　　8080端口冲突
  　　原因：由于unicorn默认使用的是8080端口。
  　　解决办法：打开/etc/gitlab/gitlab.rb,打开# unicorn['port'] = 8080的注释，将8080修改为9090，保存后运行sudo gitlab-ctl reconfigure即可。
  
  
• 　　STMP设置
  　　配置无效，暂时不知道原因。
  
  
• 　　GitLab头像无法正常显示
  　　原因：gravatar被墙
  　　解决办法：
  　　编辑 /etc/gitlab/gitlab.rb，将
  　　
  
  #gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'　　
  
  　　
  
  　　修改为：
  　　
  
  gitlab_rails['gravatar_plain_url'] = 'http://gravatar.duoshuo.com/avatar/%{hash}?s=%{size}&d=identicon'　　
  
  　　
  
  　　然后在命令行执行：
  　　
  
  sudo gitlab-ctl reconfigure　　
  sudo gitlab-rake cache:clear RAILS_ENV=production
  　　
  
  　　
  
  
  

参考资料
　　GitLab 6.1 使用postfix发送email
　　Configure GitLab Omnibus installation alongside with Apache
　　解决Gitlab的Gravatar头像无法显示的问题
　　How To Set Up GitLab As Your Very Own Private GitHub Clone