LInux 下 GitLab 的安装及使用

前言

新入职公司，发现公司还在使用落后生产工具 svn，由于重度使用过 svn 和 git ，知道这两个工具之间的差异，已经在使用 git 的路上越走越远。正好服务器下来，在重装一遍gi记录一下

git的优点

• git是分布式的，svn不是
  git分布式本地就可以用，可以随便保存各种历史痕迹，不用担心污染服务器，连不上服务器也能提交代码、查看log
• GIT分支和SVN的分支不同
  分支在SVN中实际上是版本库中的一份copy，而git一个仓库是一个快照，所以git 切换、合并分支等操作更快速。
• git有一个强大的代码仓库管理系统 - gitlab
  可以很方便的管理权限、代码review，创建、管理project

GitLab介绍

GitLab：是一个基于Git实现的在线代码仓库托管软件，你可以用gitlab自己搭建一个类似于Github一样的系统，一般用于在企业、学校等内部网络搭建git私服。
功能：Gitlab 是一个提供代码托管、提交审核和问题跟踪的代码管理平台。对于软件工程质量管理非常重要。
版本：GitLab 分为社区版（CE） 和企业版（EE）。
配置：建议CPU2核，内存2G以上。

Gitlab的服务构成

Nginx：静态web服务器。
gitlab-shell：用于处理Git命令和修改authorized keys列表。（Ruby）
gitlab-workhorse: 轻量级的反向代理服务器。（go）

GitLab Workhorse是一个敏捷的反向代理。它会处理一些大的HTTP请求，比如文件上传、文件下载、
Git push/pull和Git包下载。其它请求会反向代理到GitLab Rails应用，即反向代理给后端的unicorn。

logrotate：日志文件管理工具。
postgresql：数据库。
redis：缓存数据库。
sidekiq：用于在后台执行队列任务（异步执行）。（Ruby）
unicorn：An HTTP server for Rack applications，GitLab Rails应用是托管在这个服务器上面的。（Ruby Web Server,主要使用Ruby编写）

GitLab安装

源码安装

yum安装

官方源地址：https://about.gitlab.com/downloads/#centos6
清华大学镜像源：https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce

新建 /etc/yum.repos.d/gitlab_gitlab-ce.repo，内容为：

    [gitlab-ce]
    name=Gitlab CE Repository
    baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
    gpgcheck=0
    enabled=1

安装依赖

    sudo yum install curl openssh-server openssh-clients postfix cronie
    sudo service postfix start
    sudo chkconfig postfix on
    #这句是用来做防火墙的，避免用户通过ssh方式和http来访问。
    sudo lokkit -s http -s ssh

再执行

    sudo yum makecache
    sudo yum install gitlab-ce
    sudo gitlab-ctl reconfigure  #Configure and start GitLab

配置域名vim /var/opt/gitlab/nginx/conf/gitlab-http.conf

    # 外网访问的端口，如果服务器已经有服务器占用了80，那么这里可以改成其它
    listen *:8888;
    server_name gitlab.test.domain.com;
    
    set $http_host_with_default "gitlab.test.domain.com:8888";

GitLab备份和恢复

    # 可以将此命令写入crontab，以实现定时备份
    /usr/bin/gitlab-rake gitlab:backup:create
    

备份的数据会存储在/var/opt/gitlab/backups，用户通过自定义参数 gitlab_rails[‘backup_path’]，改变默认值

恢复

    # 停止unicorn和sidekiq，保证数据库没有新的连接，不会有写数据情况
    sudo gitlab-ctl stop unicorn
    sudo gitlab-ctl stop sidekiq
    
    # 进入备份目录进行恢复，1476900742为备份文件的时间戳
    cd /var/opt/gitlab/backups
    gitlab-rake gitlab:backup:restore BACKUP=1476900742
    cd -
    
    # 启动unicorn和sidekiq
    sudo gitlab-ctl start unicorn
    sudo gitlab-ctl start sidekiq

重要：GitLab配置文件修改

    vim /etc/gitlab/gitlab.rb

基本配置

    #外部访问url（经过编译后，自动将这个配置编译到nginx配置，nginx就无需配置了）
    external_url 'http://gitlab.test.domain.com:8888'
    #默认值就是8080。如果端口被占用，可将8080修改为其它（例如：9090）
    unicorn['port'] = 8080

发送邮件配置

    gitlab_rails['smtp_enable'] = true  
    gitlab_rails['smtp_address'] = “smtp.exmail.qq.com”  
    gitlab_rails['smtp_port'] = 25  
    gitlab_rails['smtp_user_name'] = “huangdc@domain.com“  
    gitlab_rails['smtp_password'] = "smtp password"  
    gitlab_rails['smtp_authentication']= “plain"  
    gitlab_rails['smtp_enable_starttls_auto']= true  
    gitlab_rails['gitlab_email_from']= 'huangdc@domain.com'  
    gitlab_rails['gitlab_email_reply_to']= ‘noreply@domain.com'  

使配置生效

    #使配置生效
    gitlab-ctl reconfigure
    #重新启动GitLab 
    gitlab-ctl restart

GitLab常用命令

    gitlab-ctl start    # 启动所有 gitlab 组件；
    gitlab-ctl stop        # 停止所有 gitlab 组件；
    gitlab-ctl restart        # 重启所有 gitlab 组件；
    gitlab-ctl status        # 查看服务状态；
    vim /etc/gitlab/gitlab.rb        # 修改gitlab配置文件；
    gitlab-ctl reconfigure        # 重新编译gitlab的配置；
    gitlab-rake gitlab:check SANITIZE=true --trace    # 检查gitlab；
    gitlab-ctl tail        # 查看日志；
    gitlab-ctl tail nginx/gitlab_access.log

查看gitlab版本

cat /opt/gitlab/embedded/service/gitlab-rails/VERSION