在团队开发中以前大家都用svn作为版本控制器 现在大家都转用git了 gitlab就是web版的git版本控制器 今天就讲讲gitlab的安装。

安装方法详见 GitLab安装说明 安装时 首先让你选择服务器版本 我这里就选择centos7了 按照官方的安装说明进行安装

官方安装时第一步的说明是这样的

sudo yum install curl policycoreutils openssh-server openssh-clientssudo systemctl enable sshdsudo systemctl start sshdsudo yum install postfixsudo systemctl enable postfixsudo systemctl start postfixsudo firewall-cmd --zone public --add-service http --permanentsudo firewall-cmd --reload

不过在实际应用中我修改了第一步 安装内容如下

sudo yum -y install postfix cronie

安装两个包 其中一个是postfix 为接下来GitLab用postfix发邮件通知做准备 还有一个就是cronie 其实就是计划任务 安装完成之后开启postfix服务

sudo service postfix start

如果提示如下错误

Job for postfix.service failed. See systemctl status postfix.service and journalctl -xn for details.

请进入/etc/hosts中去掉IPV6的设定

#::1 localhost localhost.localdomain localhost6 localhost6.localdomain6

然后启动postfix服务 并且设定postfix服务开机启动

sudo chkconfig postfix on

接下来进行第二步 第二步安装的时候有两种方法
第一种是使用添加yum源 然后用yum源安装 [推荐这种方法安装]
第二种是直接用rpm包安装 安装方法如下

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bashsudo yum -y install gitlab-ce

在使用rpm包时要选择自己需要的gitlab的版本 然后在下面的命令中 用版本号替换XXX。

curl -LJO https://packages.gitlab.com/gitlab/gitlab-ce/packages/el/7/gitlab-ce-XXX.rpm/downloadrpm -i gitlab-ce-XXX.rpm

安装完成 接下来按照原始配置启动GitLab

sudo gitlab-ctl reconfigure

因为这里要用已有的Nginx作为GitLab的服务器 所以要先进行配置 GitLab的配置文件位置

/etc/gitlab/gitlab.rb

我这里因为直接使用https作为连接方式 并且提前配置了gitlab的域名是https://git.xxx.com 接下来修改/etc/gitlab/gitlab.rb以下内容 在修改内容里要注意一点就是web_server设置的值是你nginx的配置

# note the https belowexternal_url https://git.xxx.com # Set the web serverweb_server[ external_users ] [ www ]# Disable the built-in nginxnginx[ enable ] false

上面是gitlab配置文件需要修改的地方 接下来添加nginx虚拟主机

添加gitlab.conf

vi /usr/local/nginx/conf/vhost/gitlab.conf

在gitlab.conf中添加以下模板内容

## GitLab## Modified from nginx http version## Modified from http://blog.phusion.nl/2012/04/21/tutorial-setting-up-gitlab-on-debian-6/## Modified from https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html## Lines starting with two hashes (##) are comments with information.## Lines starting with one hash (#) are configuration parameters that can be uncommented.#################################### CONTRIBUTING ###################################### If you change this file in a Merge Request, please also create## a Merge Request on https://gitlab.com/gitlab-org/omnibus-gitlab/merge_requests##################################### configuration ####################################### See installation.md#using-https for additional HTTPS configuration details.upstream gitlab-workhorse { server unix:/var/opt/gitlab/gitlab-workhorse/socket fail_timeout 0;## HTTPS hostserver { listen 80; listen 443 ssl spdy; server_name git.xx.com; ## Replace this with something like gitlab.example.com server_tokens off; ## Don t show the nginx version number, a security best practice root /opt/gitlab/embedded/service/gitlab-rails/public; include rewrite.conf; include ssl.conf; include pagespeed.conf; ## Individual nginx logs for this GitLab vhost access_log /var/log/nginx/gitlab.access.log; error_log /var/log/nginx/gitlab.error.log; location / { client_max_body_size 0; gzip off; ## https://github.com/gitlabhq/gitlabhq/issues/694 ## Some requests take more than 30 seconds. proxy_read_timeout 300; proxy_connect_timeout 300; proxy_redirect off; proxy_http_version 1.1; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Ssl on; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_pass http://gitlab-workhorse;}

在模板内容中需要修改以下几个地方

server_name

在上面配置文件中引用了三个额外的配置文件
https强制跳转配置文件

rewrite.conf;

https访问配置文件

ssl.conf;

pagespeed加速配置文件

pagespeed.conf;

这三个配置文件是按照博客中LNMP环境搭建及配置https访问LNMP环境中生成的配置文件 如果没有这三个配置文件请去博客中找到这三个配置文件 ssl.conf可能有点特殊 因为在之前的记录中也没有详细写出配置文件的内容我这里把它的内容写出来

ssl on;add_header Strict-Transport-Security max-age 31536000;includeSubdomains; preload; ;ssl_certificate /usr/local/nginx/conf/1_xxx.com_bundle.crt;ssl_certificate_key /usr/local/nginx/conf/ssl.key;ssl_protocols TLSv1 TLSv1.1 TLSv1.2;ssl_ciphers ALL:!DH:!EXPORT:!RC4: HIGH: MEDIUM:!LOW:!aNULL:!eNULL;ssl_session_cache shared:SSL:20m;ssl_session_timeout 20m;

我这里用到的crt和key文件是从ssl站点生成完成之后下载下来的 修改完之后保存gitlab.conf 接下来使配置生效

使GitLab配置生效

sudo gitlab-ctl reconfigure

重启Nginx

/usr/local/nginx/sbin/nginx -s reload/usr/local/nginx/sbin/nginx -s reopen

在第一步我们安装并启动了postfix 现在测试一下用postfix发送一封邮件给自己

echo Test mail from postfix | mail -s Test Postfix 你的邮件地址

如果没有错误提示 表示发送成功 接下来登录你的邮箱 查看收到的邮件 邮件的主题是Test Postfix 内容是Test mail from postfix 当邮箱收到系统发送来的邮件时 将系统的地址复制下来 如 root iZu136qbxolZ.localdomain 打开/etc/gitlab/gitlab.rb 修改以下内容

gitlab_rails[ gitlab_email_enabled ] truegitlab_rails[ gitlab_email_from ] root iZu136qbxolZ.localdomain gitlab_rails[ gitlab_email_display_name ] git.xxx.com 

保存之后重新配置GitLab

sudo gitlab-ctl reconfiguresudo gitlab-ctl restart

重启nginx

nginx -s reloadnginx -s reopen

配置完成之后 就有了邮件通知 如果为了更好的使用邮件通知系统 也可以使用smtp方式发送邮件 使用方法如下 继续修改配置文件/etc/gitlab/gitlab.rb

# Use smtp instead of sendmail/postfix.gitlab_rails[ smtp_enable ] truegitlab_rails[ smtp_address ] smtp.exmail.qq.com gitlab_rails[ smtp_port ] 25gitlab_rails[ smtp_user_name ] 需要的QQ邮箱 gitlab_rails[ smtp_password ] 密码 gitlab_rails[ smtp_domain ] smtp.qq.com gitlab_rails[ smtp_authentication ] login gitlab_rails[ smtp_enable_starttls_auto ] truegitlab_rails[ smtp_tls ] true

在smtp配置文件中根据实际情况修改对应的smtp服务信息 详细配置可看官方说明 GitLab配置SMTP

使用GibLab一段时间后发现服务器越来越卡 尤其是阿里云的ECS 由于开启swap分区会导致硬盘IO性能下降 因此阿里云服务器初始状态未配置swap 这样就导致GitLab偶尔还会出现500/502错误 原因就是内存不足 可以使用如下方法修改阿里云的swap空间

dd if /dev/zero of /var/swap bs 1024 count 2097152

/sbin/mkswap /var/swap

/sbin/swapon /var/swap

/sbin/swapon -s

echo /var/swap swap swap defaults 0 0 /etc/fstab

PS.阿里云默认在启动项里关闭了SWAP分区 在/etc/rc.d/rc.local文件里有一行 swapoff -a 表示禁用swap 想要使用SWAP分区把这行删掉就好了 如果没有就不用管。

安装完成之后访问git.xx.com 要求输入用户名密码 安装完成后GitLab默认的管理员用户是

root

默认密码是

5iveL!fe

更新GitLab

sudo yum -y update gitlab-ce

禁止GitLab开机自启动

sudo systemctl disable gitlab-runsvdir.service

启用Gitlab开机自启动

sudo systemctl enable gitlab-runsvdir.service

本文讲解到此为止 GitLab的基本配置已经完成 在使用过程中遇到的问题 GitLab一般都会有说明 更深层次的问题可以去官网索取答案。