内容:
- 安装配置
- 邮件配置
- 默认端口变更、域名配置
- 自动备份
- 恢复
- 迁移
环境:centos 6.5
安装和配置必要依赖
在CentOS,下面的命令将在系统防火墙打开HTTP和SSH访问。
sudo yum install -y curl openssh-server openssh-clients cronie
sudo lokkit -s http -s ssh
Next, install Postfix to send notification emails. If you want to use another solution to send emails please skip this step and configure an external SMTP server after GitLab has been installed.
sudo yum install postfix
sudo service postfix start
sudo chkconfig postfix on
During Postfix installation a configuration screen may appear. Select ‘Internet Site’ and press enter. Use your server’s external DNS for ‘mail name’ and press enter. If additional screens appear, continue to press enter to accept the defaults.
安装 gitlab-ce
安装包有300M+,若能访问aws,直接yum install ,否则配置国内镜像
sudo yum install -y gitlab-ce
1、配置yum源
vim /etc/yum.repos.d/gitlab-ce.repo
增加以下内容
[gitlab-ce]
name=gitlab-ce
baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6
Repo_gpgcheck=0
Enabled=1
Gpgkey=https://packages.gitlab.com/gpg.key
2、更新本地yum缓存
sudo yum makecache
3、安装GitLab社区版
sudo yum intall gitlab-ce #自动安装最新版
或者:sudo yum install gitlab-ce-x.x.x #安装指定版本
如果下载太慢,不如直接访问 https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6/,用迅雷下载你需要的包,然后scp 到服务器上
scp ./gitlab-ce-10.0.1-ce.0.el6.x86_64.rpm root@10.xx.x.xxx:/data/
安装前先安装依赖,然后直接rpm -ivh [rpm安装包]安装:
yum install policycoreutils-python
rpm -ivh gitlab-ce-10.0.1-ce.0.el6.x86_64.rpm
4、Configure and start GitLab
sudo gitlab-ctl reconfigure
可以安装omnibus 版本,省心
omnibus 社区版安装
下载包安装:
https://downloads-packages.s3.amazonaws.com/centos-6.6/gitlab-ce-7.10.0~omnibus.2-1.x86_64.rpm
rpm -i gitlab-ce-7.10.0~omnibus.2-1.x86_64.rpm
配置域名
gitlab 内置nginx,默认监听80端口;
修改文件:/etc/gitlab/gitlab.rb
external_url 'http://gitlab.123.com'
如果服务器已有nginx ,那么则需要参考下节变更端口,然后修改系统nginx配置
默认端口号变更
gitlab 内置nginx,默认监听80端口;gitlab 网站服务,默认占用8080 端口,如果这两个端口已经被其他服务占用,那么也可以进行修改(举例:80 ->82,8080 ->8082)
修改文件:/etc/gitlab/gitlab.rb
#unicorn
unicorn['listen'] = '127.0.0.1'
unicorn['port'] = 8082
# nginx
nginx['listen_addresses'] = ['*']
nginx['listen_port'] = 82
重新配置重启
gitlab-ctl reconfigure
备注: reconfigure 后,会将相关组件的配置文件更新掉,所以变更了gitlab.rb,均需要reconfigure。例如nginx配置文件生成路径:/var/opt/gitlab/nginx/conf/gitlab-http.conf;gitlab-rails配置文件:/var/opt/gitlab/gitlab-rails/etc/unicorn.rb
邮件配置
修改gitlab.rb
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.yeah.net"
gitlab_rails['smtp_port'] = 25
gitlab_rails['smtp_user_name'] = "sloong@yeah.net"
gitlab_rails['smtp_password'] = "xxxpassword"
gitlab_rails['smtp_domain'] = "yeah.net"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
user['git_user_email'] = "sloong@yeah.net"
#可有可无
gitlab_rails['gitlab_email_from'] = 'sloong@yeah.net'
gitlab_rails['gitlab_email_display_name'] = 'gitlab-admin'
gitlab_rails['gitlab_email_reply_to'] = 'noreply@yeah.net'
重新配置
gitlab-ctl reconfigure
定制页面
卸载
停止gitlab:
su gitlab-ctl stop
卸载
su gitlab-ctl uninstall
su rpm -e gitlab-ce
删除所有包含gitlab的文件及目录
find / -name gitlab|xargs rm -rf
gitlab 常用命令
sudo gitlab-ctl start # 启动所有 gitlab 组件;
sudo gitlab-ctl stop # 停止所有 gitlab 组件;
sudo gitlab-ctl restart # 重启所有 gitlab 组件;
sudo gitlab-ctl status # 查看服务状态;
sudo gitlab-ctl reconfigure # 启动服务;
sudo vim /etc/gitlab/gitlab.rb # 修改默认的配置文件;
gitlab-rake gitlab:check SANITIZE=true --trace # 检查gitlab;
sudo gitlab-ctl tail # 查看日志;
备份
备份、恢复、迁移参考自:http://www.xuliangwei.com/xubusi/803.html
使用Gitlab一键安装包安装Gitlab非常简单, 同样的备份恢复与迁移也非常简单. 使用一条命令即可创建完整的Gitlab备份:
gitlab-rake gitlab:backup:create
使用以上命令会在/var/opt/gitlab/backups目录下创建一个名称类似为1481598919_gitlab_backup.tar的压缩包, 这个压缩包就是Gitlab整个的完整部分, 其中开头的1481598919是备份创建的日期
/etc/gitlab/gitlab.rb 配置文件须备份
/var/opt/gitlab/nginx/conf nginx配置文件
/etc/postfix/main.cfpostfix 邮件配置备份
备份目录更改
可以通过/etc/gitlab/gitlab.rb配置文件来修改默认存放备份文件的目录
gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
/var/opt/gitlab/backups修改为你想存放备份的目录即可, 修改完成之后使用gitlab-ctl reconfigure命令重载配置文件即可.
Gitlab自动备份
实现每天凌晨2点进行一次自动备份:通过crontab使用备份命令实现
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create
恢复
# 停止相关数据连接服务
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
# 从1481598919编号备份中恢复
gitlab-rake gitlab:backup:restore BACKUP=1481598919
# 启动Gitlab
sudo gitlab-ctl start
迁移
迁移如同备份与恢复的步骤一样, 只需要将老服务器/var/opt/gitlab/backups
目录下的备份文件拷贝到新服务器上的/var/opt/gitlab/backups
即可(如果你没修改过默认备份目录的话).
但是需要注意的是新服务器上的Gitlab的版本必须与创建备份时的Gitlab版本号相同. 比如新服务器安装的是最新的7.60版本的Gitlab, 那么迁移之前, 最好将老服务器的Gitlab 升级为7.60在进行备份.
/etc/gitlab/gitlab.rb
gitlab配置文件须迁移,迁移后需要调整数据存放目录
/var/opt/gitlab/nginx/conf
nginx配置文件目录须迁移
[root@linux-node1 ~]# gitlab-ctl stop unicorn
ok: down: unicorn: 0s, normally up
[root@linux-node1 ~]# gitlab-ctl stop sidekiq
ok: down: sidekiq: 0s, normally up
[root@linux-node1 ~]# chmod 777 /var/opt/gitlab/backups/1481598919_gitlab_backup.tar
[root@linux-node1 ~]# gitlab-rake gitlab:backup:restore BACKUP=1481598919
参考
- https://about.gitlab.com/installation/#centos-6
- https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/
- https://yq.aliyun.com/articles/74395
- http://blog.csdn.net/arybd/article/details/54635295
- https://segmentfault.com/a/1190000002722631
- http://www.cnblogs.com/shansongxian/p/6678110.html
- https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/smtp.md
- http://www.xuliangwei.com/xubusi/803.html