【git】gitlab基本维护和使用
基本介绍
GitLab是一个自托管的Git项目仓库,可以自己搭建个人代码管理的仓库,功能与github类似。
安装
下载 gitlab下载地址: https://about.gitlab.com/downloads/
安装依赖的包
sudo yum install curl-devel sudo yum install expat-devel sudo yum install gettext-devel sudo yum install openssl-devel sudo yum install zlib-devel sudo yum install perl-devel sudo yum install curl sudo yum install openssh-server sudo yum install openssh-clients sudo yum install postfix sudo yum install cronie
sudo yum install policycoreutils-python
Ubuntu系统使用apt-get方式安装依赖包。
使用gitlab官网的脚本安装
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
或者使用gitlab的yum安装gitlab
sudo yum install gitlab-ce
配置发邮件
yum install postfix systemctl enable postfix systemctl start postfix
安装完毕后,使用Web登录
进入gitlab的管理页面,进行常用的分组,工程,用户等功能点的维护。
安装完gitlab后的运维操作
初次配置服务
sudo gitlab-ctl reconfigure
启动服务
sudo gitlab-ctl start
停止服务
sudo gitlab-ctl stop
重启服务
sudo gitlab-ctl restart
备份仓库
先修改 /etc/gitlab/gitlab.rb
配置要备份的路径,然后重新执行命令sudo gitlab-ctl reconfigure,做重新配置更新。
执行如下命令,创建备份
sudo gitlab-rake gitlab:backup:create
创建备份是会显示如下信息(会依次备份gitlab上的分组和所有的工程)。
备份文件个格式:Unix时间戳_gitlab_backup.tar,例如下面做的一个备份文件举例。
备份的仓库恢复
gitlab-rake gitlab:backup:restore BACKUP=1483198680
恢复时,选择的版本就是备份是产生的Unix时间戳。
注:恢复时,先停掉服务,以免双写导致数据错误。
修改配置/etc/gitlab/gitlab.rb文件
修改数据文件目录
查到git_data_dir配置信息,增加 git_data_dir "/data/gitlab-data"
修改备份目录
gitlab_rails['backup_path'] = "/data/gitlab-data/backups"
配置邮箱
gitlab_rails['smtp_enable'] = true gitlab_rails['smtp_address'] = "your.smtp.server" gitlab_rails['smtp_port'] = 465 gitlab_rails['smtp_user_name'] = "your.smtp user" gitlab_rails['smtp_password'] = "your.smtp password" gitlab_rails['smtp_domain'] = "your.demain.com" gitlab_rails['smtp_authentication'] = "login" gitlab_rails['smtp_enable_starttls_auto'] = true gitlab_rails['smtp_openssl_verify_mode'] = 'peer' gitlab_rails['gitlab_email_from'] = 'gitlab@mail.domain.com' gitlab_rails['gitlab_email_reply_to'] = 'noreply@mail.domain.com'
修改git仓库的域名或IP
# external_url 'http://192.168.1.100' #替换 #修改成域名访问 external_url 'http://gitlab.your.com'
检查服务的日志信息
# 检查redis的日志 sudo gitlab-ctl tail redis # 检查postgresql的日志 sudo gitlab-ctl tail postgresql # 检查gitlab-workhorse的日志 sudo gitlab-ctl tail gitlab-workhorse # 检查logrotate的日志 sudo gitlab-ctl tail logrotate # 检查nginx的日志 sudo gitlab-ctl tail nginx # 检查sidekiq的日志 sudo gitlab-ctl tail sidekiq # 检查unicorn的日志 sudo gitlab-ctl tail unicorn
检查服务状态
sudo gitlab-ctl status
一般服务状态显示信息
显示格式:
状态 : 进程名称:(进程ID)运行时间(秒);进程的日志服务进程和运行时间
run: gitlab-workhorse: (pid 11892) 281s; run: log: (pid 8630) 4742472s run: logrotate: (pid 11904) 280s; run: log: (pid 8631) 4742472s run: nginx: (pid 11911) 280s; run: log: (pid 8796) 4742455s run: postgresql: (pid 12866) 18s; run: log: (pid 8627) 4742472s run: redis: (pid 11989) 249s; run: log: (pid 8638) 4742472s run: sidekiq: (pid 12850) 20s; run: log: (pid 8634) 4742472s run: unicorn: (pid 12022) 247s; run: log: (pid 8629) 4742472s
状态 | 说明 |
run | 运行状态 |
down | 服务停止 |
常见的问题
1. 页面显示500,Whoops, something went wrong on our end.
500 Whoops, something went wrong on our end. Try refreshing the page, or going back and attempting the action again. Please contact your GitLab administrator if this problem persists.
如何检查和定位问题?
使用命令检查所有服务的状态
sudo gitlab-ctl status
检查服务状态如下
run: gitlab-workhorse: (pid 11892) 91s; run: log: (pid 8630) 4742282s run: logrotate: (pid 11904) 90s; run: log: (pid 8631) 4742282s run: nginx: (pid 11911) 90s; run: log: (pid 8796) 4742265s down: postgresql: 1s, normally up, want up; run: log: (pid 8627) 4742282s run: redis: (pid 11989) 59s; run: log: (pid 8638) 4742282s run: sidekiq: (pid 12201) 2s; run: log: (pid 8634) 4742282s run: unicorn: (pid 12022) 57s; run: log: (pid 8629) 4742282s
定位问题
从服务状态信息中显示数据库postgresql的状态是down,即服务停止。
检查数据库postgresql的运行日志,检查出现什么错误?
$ sudo gitlab-ctl tail postgresql ==> /var/log/gitlab/postgresql/state <== ==> /var/log/gitlab/postgresql/current <== 2016-12-24_01:39:39.00188 FATAL: data directory "/var/opt/gitlab/postgresql/data" has group or world access 2016-12-24_01:39:39.00190 DETAIL: Permissions should be u=rwx (0700). 2016-12-24_01:39:40.00698 FATAL: data directory "/var/opt/gitlab/postgresql/data" has group or world access 2016-12-24_01:39:40.00700 DETAIL: Permissions should be u=rwx (0700).
日志显示,数据库的访问权限应该是只有用户本身有读写执行的权限,用户组和其他用户不能有权限。
修改数据库数据的权限后,检查服务运行正常。
了解了问题的定位和解决方式,其他问题也很容易在日志中发现和解决,问题可能是磁盘空间少,用户权限错误或者其他原因。
2. gitlab管理员密码忘记,怎么重置密码
Gitlab 修改root用户密码
使用rails工具打开终端
sudo gitlab-rails console production
查询用户的email,用户名,密码等信息,id:1 表示root账号
user = User.where(id: 1).first
重新设置密码
user.password = '新密码' user.password_confirmation = '新密码'
保存密码
user.save!
完整的操作ruby脚本
user = User.where(id: 1).first user.password = '新密码' user.password_confirmation = '新密码' user.save!
然后使用重置过的密码重新登录。
Done.