centos7安装gitlab8.8

XiongNeng 收录于开发工具

2016-09-09 2026-05-24 约 4300 字预计阅读 9 分钟

内部需要搭建一个源码管理控制环境，选择开源的gitlab，环境为centos7。这个平台类似于github，使用起来非常方便。现在将搭建的步骤记录下来，因为官网上面提供的是ubuntu的流程。

全部命令都是在 root 用户下执行。安装操作系统 (CentOS 7 Minimal)，先配置好网卡和DNS，保证网络没问题。

安装和添加基础工具

`1`	`yum install wget`

安装EPEL源

1
2
3
yum install epel-release
wget -O /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6 https://www.fedoraproject.org/static/0608B895.txt
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6

添加RemiRPM仓库

1
2
wget -O /etc/pki/rpm-gpg/RPM-GPG-KEY-remi http://rpms.famillecollet.com/RPM-GPG-KEY-remi
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-remi

确认是否添加成功

1
2
3
rpm -qa gpg*
# 查看输出是否包含
# gpg-pubkey-00f97f56-467e318a

然后安装，这样就可以添加remi-safe仓库了

`1`	`rpm -Uvh http://rpms.famillecollet.com/enterprise/remi-release-7.rpm`

查看是否添加进去了

`1`	`yum repolist`

如果能看到输出，那么使用

1
2
yum -y install yum-utils
yum-config-manager --enable epel --enable PUIAS_6_computational

最后，更新源缓存

`1`	`yum clean all && yum makecache`

安装必要的工具

1
2
3
yum -y update
yum -y groupinstall 'Development Tools'
yum -y install readline readline-devel ncurses-devel gdbm-devel glibc-devel tcl-devel openssl-devel curl-devel expat-devel db4-devel byacc sqlite-devel libyaml libyaml-devel libffi libffi-devel libxml2 libxml2-devel libxslt libxslt-devel libicu libicu-devel system-config-firewall-tui redis sudo wget crontabs logwatch logrotate perl-Time-HiRes git cmake libcom_err-devel.i686 libcom_err-devel.x86_64 ntp nodejs python-docutils

gitlab 8.0 之后的版本需要依赖 nodejs，不然安装 gitlab-shell 的时候会出现没有javascript runtime

安装vim

1
2
yum -y install vim-enhanced
update-alternatives --set editor /usr/bin/vim.basic

设置NTP时间同步

1
2
3
4
5
6
7
# 删除当前默认时区
rm -rf /etc/localtime
# 复制替换默认时区为上海
ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
yum install -y ntp        # 安装时间同步服务（组件）
ntpdate us.pool.ntp.org   # 设置同步服务器
date                      # 查看当前时间

配置默认编辑器

`1`	`ln -s /usr/bin/vim /usr/bin/editor`

从源代码安装 Git

1
2
yum install -y zlib-devel perl-CPAN gettext curl-devel expat-devel gettext-devel openssl-devel
yum -y remove git

下载解压：

1
2
3
4
5
6
mkdir /tmp/git && cd /tmp/git
curl --progress https://www.kernel.org/pub/software/scm/git/git-2.8.4.tar.gz | tar xz
cd git-2.8.4/
./configure
make
make prefix=/usr/local install

将git加入到PATH中

1
2
3
4
which git
vi /etc/profile
# 最后 export PATH=$PATH:/usr/local/bin/git
source /etc/profile

Note: 编辑config/gitlab.yml (step 6), bin_path改成/usr/local/bin/git.

安装Ruby和Go

GitLab 需要 2.1 以上版本的 Ruby，但是当前不兼容 2.2 和 2.3，先删除旧的

`1`	`yum remove -y ruby`

如果没有安装ruby，上述删除的步骤可以跳过

下载安装

1
2
3
4
5
6
7
mkdir /tmp/ruby && cd /tmp/ruby
curl --progress ftp://ftp.ruby-lang.org/pub/ruby/2.1/ruby-2.1.8.tar.gz | tar xz
tar -xzf ruby-2.1.8.tar.gz
cd ruby-2.1.8
./configure --disable-install-rdoc
make
make prefix=/usr/local install

安装Bundler Gem:

1
2
3
4
gem sources --remove https://rubygems.org/
gem sources -a https://ruby.taobao.org/
gem sources -l
gem install bundler --no-doc

同样将which ruby加入到PATH中，和前面git类似

1
2
3
which ruby
# /usr/local/bin/ruby
ruby -v

安装 go （gitlab 8.0 以后的版本需要go语言的支持）

1
2
3
4
5
6
7
mkdir /tmp/go && cd /tmp/go
URL='https://storage.googleapis.com/golang/' && wget -c `curl -s $URL|xmllint --format - |awk -PF'[><]' '{if ($3~/linux/ && $3!~/(beta|rc)[0-9]+|armv6l|386/)a=$3}END{print "'$URL'"a}'`
# 上面下载的是个md5验证，可以自己先wget压缩包后手动解压缩安装
tar xf go*.linux-amd64.tar.gz -C /usr/local/
echo "PATH=/usr/local/go/bin:\$PATH" >/etc/profile.d/go.sh
. /etc/profile.d/go.sh
go version

系统用户

为gitlab创建一个linux系统用户git

1
2
3
4
5
adduser --system --shell /bin/bash --comment 'GitLab' --create-home --home-dir /home/git/ git
visudo
# Defaults    secure_path = /sbin:/bin:/usr/sbin:/usr/bin
# 改为
# Defaults    secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin

数据库

CentOS 7 版本将 MySQL 数据库软件从默认的程序列表中移除，用 Mariadb 代替了

1
2
3
yum install -y mariadb mariadb-server mariadb-devel
systemctl enable mariadb  #设置开机启动
systemctl start mariadb #启动MariaDB

mariadb数据库的相关命令是：

1
2
3
4
systemctl start mariadb  #启动MariaDB
systemctl stop mariadb  #停止MariaDB
systemctl restart mariadb  #重启MariaDB
systemctl enable mariadb  #设置开机启动

确保你的版本是5.5.14 或以上

`1`	`mysql --version`

设置数据库 root 用户密码，并设置相关的安全配置

`1`	`mysql_secure_installation`

因为是刚安装完数据库，因此没有 root 账户的密码，按回车后，会开始让设置密码。设置完密码后，会问是否删除匿名用户（不需要密码就能登录），选择 y

如果失败了，就使用另外方法

1
2
3
4
5
6
stop the mysql daemon.
mysqld_safe --skip-grant-tables
mysql --user=root mysql
update user set Password=PASSWORD('new-password') where user='root';
flush privileges;
restart mysql

然后mysql -u root -p登陆，使用刚刚的密码，为gitlab创建一个数据库用户git：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
CREATE USER 'git'@'localhost' IDENTIFIED BY 'git';
SET storage_engine=INNODB;
# 创建生成环境数据库
CREATE DATABASE IF NOT EXISTS `gitlabhq_production` DEFAULT CHARACTER SET `utf8` COLLATE `utf8_unicode_ci`;
# 授权
GRANT SELECT, LOCK TABLES, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON `gitlabhq_production`.* TO 'git'@'localhost';
\q
# 试着连连
sudo -u git -H mysql -u git -p -D gitlabhq_production
\q

配置 MySQL max_allowed_packet 的大小，避免POST太大的内容导致出现 500 错误，例如 GitLab 发出 MergeRequest 的时候返回 500 错误。vim /etc/my.cnf，在 mysqld 中添加 max_allowed_packet，调整值，加大为一个合适的数字即可。

1
2
[mysqld]
max_allowed_packet=512M

然后重启：systemctl restart mariadb

Redis

开机就启动redis

`1`	`chkconfig redis on`

配置socket

1
2
3
4
5
6
7
cp /etc/redis.conf /etc/redis.conf.orig
# 禁止redis监听tcp请求，port设置成0
sed 's/^port .*/port 0/' /etc/redis.conf.orig | sudo tee /etc/redis.conf
echo 'unixsocket /var/run/redis/redis.sock' | sudo tee -a /etc/redis.conf
echo -e 'unixsocketperm 0775' | sudo tee -a /etc/redis.conf
service redis restart
usermod -aG redis git

安装GitLab

我们把gitlab安装到git用户的home目录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
cd /home/git
# 先切换到git账户
su - git
# 再clone代码
git clone https://github.com/gitlabhq/gitlabhq.git -b 8-8-stable gitlab
# Go to GitLab installation folder
cd /home/git/gitlab
vi /etc/sudoers
# 最后添加：git ALL=(ALL)  NOPASSWD: ALL
sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml
sudo -u git -H vim config/gitlab.yml

配置如下信息

1
2
3
4
host: 192.168.217.161
port: 8008
email_from: xiongneng@winhong.com
default_theme: 1

确保 GitLab 可以写 log/ and tmp/ 目录，配置其他文件夹权限

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
chown -R git log/
chown -R git tmp/
chmod -R u+rwX log/
chmod -R u+rwX tmp/
sudo -u git -H mkdir /home/git/gitlab-satellites
chmod u+rwx,g=rx,o-rwx /home/git/gitlab-satellites
chmod -R u+rwX tmp/pids/
chmod -R u+rwX tmp/sockets/
sudo -u git mkdir /home/git/gitlab/public/uploads
chmod -R u+rwX  /home/git/gitlab/public/uploads

Unicorn 配置：

1
2
3
4
5
6
7
sudo -u git -H cp config/unicorn.rb.example config/unicorn.rb
nproc  # 看看有几个核心
# Enable cluster mode if you expect to have a high load instance
# Ex. change amount of workers to 3 for 2GB RAM server
# Set the number of workers to at least the number of cores
# listen "0.0.0.0:8008", :tcp_nopush => true
sudo -u git -H vim config/unicorn.rb

复制Rack attack 配置

`1`	`sudo -u git -H cp config/initializers/rack_attack.rb.example config/initializers/rack_attack.rb`

然后配置git全局配置

1
2
3
4
5
6
sudo -u git -H git config --global user.name "GitLab"
sudo -u git -H git config --global user.email "xiongneng@winhong.com"
sudo -u git -H git config --global core.autocrlf input

# Configure Redis connection settings
sudo -u git -H cp config/resque.yml.example config/resque.yml

如果不使用Redis的默认端口，则需要配置

`1`	`sudo -u git -H vim config/resque.yml`

注意：同时你还需要配置gitlab.yml和unicorn.rb

配置一下权限，如果这里repositories还不存在，那么等后面再来执行：

1
2
3
4
sudo chmod 700 /home/git/gitlab/public/uploads
sudo chmod -R ug+rwX,o-rwx /home/git/repositories/
sudo chmod -R ug-s /home/git/repositories/
sudo find /home/git/repositories/ -type d -print0 | sudo xargs -0 chmod g+s

配置gitlab数据库

`1`	`sudo -u git cp config/database.yml.mysql config/database.yml`

配置数据库的密码，修改为正确的用户名和密码，分别修改git用户和root用户

1
2
sudo -u git -H vim config/database.yml
sudo -u git -H chmod o-rwx config/database.yml

安装Gems

1
2
3
4
5
6
cd /home/git/gitlab
# 修改为淘宝的ruby源
vi Gemfile
# 修改为：source "https://ruby.taobao.org/"
# 下面这一步的时间会等很久
sudo -u git -H bundle install --deployment --without development test postgres aws

安装GitLab shell

1
2
3
4
5
6
7
8
su - git
cd /home/git/gitlab
ln -s /usr/local/bin/git /usr/bin/git
bundle exec rake gitlab:shell:install[v$(cat GITLAB_SHELL_VERSION)] REDIS_URL=unix:/var/run/redis/redis.sock RAILS_ENV=production
logout

# 查看下gitlab-shell配置
sudo -u git -H editor /home/git/gitlab-shell/config.yml

安装 gitlab-workhorse

1
2
3
4
5
6
7
8
su - git
cd /home/git/
git clone https://gitlab.com/gitlab-org/gitlab-workhorse.git
logout

cd /home/git/gitlab-workhorse
ln -s /usr/local/go/bin/go /usr/bin/go
sudo -u git -H make

初始化数据并且激活高级特性

1
2
cd /home/git/gitlab/
sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production

按yes来创建数据库，创建后管理员用户也会创建了，并且默认密码是空，第一次打开会让你新建密码。输出类似下面：

1
2
3
4
Administrator account created:

login:    root
password: You'll be prompted to create one on your first visit.

安装初始化脚本

1
2
3
4
5
sudo cp /home/git/gitlab/lib/support/init.d/gitlab /etc/init.d/gitlab
chmod +x /etc/init.d/gitlab
chkconfig --add gitlab
chkconfig gitlab on
cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab

检查应用状态

如果前面的gitlab正确配置好了，那么现在可以查看它的状态了：

`1`	`sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production`

编译静态文件

`1`	`sudo -u git -H bundle exec rake assets:precompile RAILS_ENV=production`

启动gitlab服务

`1`	`service gitlab start`

配置web服务器

官方推荐使用nginx服务器

1
2
3
yum update
yum -y install nginx
chkconfig nginx on

使用SSl

`1`	`cp /home/git/gitlab/lib/support/nginx/gitlab-ssl /etc/nginx/conf.d/gitlab.conf`

不使用SSL

`1`	`cp /home/git/gitlab/lib/support/nginx/gitlab /etc/nginx/conf.d/gitlab.conf`

我这里不使用SSL，编辑vim /etc/nginx/conf.d/gitlab.conf，将git.example.com替换成你的地址

1
2
3
4
5
6
listen 0.0.0.0:80;
##listen [::]:80 default_server;
server_name 192.168.217.161; ## Replace
server_tokens off; ## Don't show
location / {
    client_max_body_size 512m;

另外还要加个gitlab的upstream，里面默认就一个gitlab-workhorse：

1
2
3
4
5
6
7
upstream gitlab {
  server unix:/home/git/gitlab/tmp/sockets/gitlab.socket fail_timeout=0;
}

upstream gitlab-workhorse {
  server unix:/home/git/gitlab/tmp/sockets/gitlab-workhorse.socket fail_timeout=0;
}

测试配置：

`1`	`nginx -t`

修改权限

1
2
usermod -a -G git nginx
chmod g+rx /home/git/

去修改/etc/selinux/conf，将selinux关闭，否则会出现 nginx 访问错误 (13: Permission denied)，HTTP显示502

将SELINUX=enforcing 改为 SELINUX=disabled,重启机器即可

setenforce 0 只是临时关闭，重启后问题仍然出现

然后执行：

1
2
3
service nginx start
shutdown -r now
service gitlab restart

配置防火墙

直接禁用防火墙最简单

1
2
systemctl stop firewalld
systemctl mask firewalld

设置开放端口到服务器外访问，这里以8008为例子，需要替换为真实的端口

1
2
/sbin/iptables -I INPUT -p tcp --dport 8008 -j ACCEPT
service iptables restart

最后检查

为了确保所有流程都正确完成，执行下面的检查：

1
2
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

如果都是绿色的，表示安装成功。如果出现类似表找不到的错误，那么就是前面的数据库初始化没成功，再执行一次：

`1`	`sudo -u gitlab -H bundle exec rake db:migrate RAILS_ENV=production`

然后浏览器直接访问：http://192.168.217.161/

Gitlab 备份

官网的备份说明

https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/raketasks/backup_restore.md

查看备份设置

`1`	`vim /home/git/gitlab/config/gitlab.yml`

检查Backup Settings设置项。默认情况下，备份文件是存放在/home/git/gitlab/tmp/backups/

执行备份

1
2
3
sudo service gitlab stop # 先停止Gitlab，可以不暂停
cd /home/git/gitlab/
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production

执行完成后，会在/home/git/gitlab/tmp/backups/目录下创建一个备份俄文件，以时间戳_gitlab_backup命名如 1417040627_gitlab_backup.tar

重新启动

1
2
sudo service gitlab start
sudo service nginx restart

还原

1
2
3
4
5
chmod o+wrx /home/git/.ssh/authorized_keys.lock
# 需要使用 git 用户来执行，否则会没有权限操作 git 目录下的文件，timestamp_of_backup为时间戳如 1417040627
sudo service gitlab stop
cd /home/git/gitlab/
sudo -u git -H bundle exec rake gitlab:backup:restore BACKUP=timestamp_of_backup RAILS_ENV=production

如果是从全新部署的 gitlab 还原，需要执行这一步

`1`	`sudo -u git -H bundle exec rake gitlab:satellites:create RAILS_ENV=production`

重启 gitlab

1
2
3
4
sudo service gitlab start
sudo service nginx restart

sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

设置自动备份

1
2
3
4
sudo service gitlab stop;
cd /home/git/gitlab;
sudo -u git -H editor config/gitlab.yml;
# Enable keep_time in the backup section to automatically delete old backups

keep_time参数默认是604800（单位是秒），因此会保留最近7天内的备份

`1`	`sudo -u git crontab -e # Edit the crontab for the git user`

将如下内容添加到文件末尾

1
2
# 每天凌晨2点自动备份
0 2 * * * cd /home/git/gitlab && PATH=/usr/local/bin:/usr/bin:/bin bundle exec rake gitlab:backup:create RAILS_ENV=production CRON=1

重新启动

1
2
3
sudo service gitlab start;
sudo service nginx restart;
sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production;

忘记管理员密码

Gitlab 服务器上使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# Gitlab 安装路径
cd /home/git/gitlab
# 进入Rails控制台
sudo -u git -H bundle exec rails console production
# 进入控制台，如果知道需要修改用户的邮箱，使用如下，直接修改
user = User.find_by(email: 'admin@example.com')
user.password = 'secret_password'
user.password_confirmation = 'secret_password'
user.save
# 如果不知道具体邮箱，可以通过find来查找邮箱
user = User.find(1)

中文汉化

如果不习惯英文界面，可以汉化

克隆 GitLab.com 仓库git clone

`1`	`git clone https://gitlab.com/larryli/gitlab.git gitlab_cn`

确认版本号，安装对应版本的汉化包：

`1`	`cat /home/git/gitlab/VERSION`

进入前面用git拉取的目录gitlab_cn

`1`	`cd gitlab_cn`

先停止gitlab

`1`	`service gitlab stop`

8.8 版本的汉化补丁（8-8-stable是英文稳定版，8-8-zh是中文版，两个 diff 结果便是汉化补丁）

`1`	`git diff origin/8-8-stable origin/8-8-zh > /tmp/8.8.diff`

应用汉化补丁

1
2
cd /home/git/gitlab/
git apply /tmp/8.8.diff

启动gitlab

`1`	`service gitlab start`

简单使用

这里我使用的是SSH协议，需要复制你的ssh-key到gitlab上面。

客户端生成ssh-key

如果已经有sshkey，可用之前的。

在客户端执行命令 ssh-keygen -t rsa -C “for xxx”，-C 选项后是备注，可随意。

命令执行后会要求输入key存储的文件名和passphrase：

输入一个特有的文件名，否则使用默认的 id_rsa。 passphrase。不输入也可以。输入之后，提交的时候要输入这个passphrase 完成后在 ~/.ssh/ 会生成2个文件。id_rsa 和 id_rsa.pub。前者是私钥，注意保管，后者是公钥。

添加ssh-key到gitlab

登录之后: Profile Settings => SSH-Keys => Add SSH key。

输入之前生成的公钥，标题随意。

FAQ

内网请使用SSH协议的地址来pull/push，profile settings中SSH Keys添加相应的pubkey
公网的话就使用https协议了，这个暂时还没研究
win7上面push的时候报了一个libcurl-4.dll找不到，去网上下载后放到C:\Windows\SysWOW64\下面

Centos7安装gitlab8.8