GitLab概述

GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的web服务。

使用GitLab可以自己搭建一个类似于GitHub一样的仓库，但是GitLab有更完善的管理界面和权限控制。对于开源项目而言，GitHub 是代码托管的首选。但是从代码的私有性上来看，GitLab 是一个更好的选择。

GitLab架构图：

访问GitLab有两个入口，一个是内置Nginx控制的web入口，另一个是SSH协议的GitLab Shell入口。

GitLab部署

安装GitLab依赖包

1

yum install -y curl wegt openssl-server postfix		# 安装依赖：访问站点的组件、ssl组件、邮件相关组件

安装Git Lab

1
2
3
4
5
6
7
8
9
10

# 在清华官方源中找到GitLab的rpm包安装
yum install -y https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-12.0.3-ce.0.el7.x86_64.rpm

# 有效的提示信息，在字符拼接的狐狸头的下面：
Thank you for installing GitLab!
GitLab was unable to detect a valid hostname for your instance.
Please configure a URL for your GitLab instance by setting `external_url`
configuration in /etc/gitlab/gitlab.rb file.
Then, you can start your GitLab instance by running the following command:
  sudo gitlab-ctl reconfigure

配置

• 配置域名

  用于web页面访问

  1 2 3 4

  vim /etc/gitlab/gitlab.rb # 编辑配置文件 # 通过`/^external_url` 找到此行，修改一个自定义的域名 external_url 'http://study.gitlab.com'

• 配置邮箱

  用于注册时发送验证邮件

  忘记密码时用于找回

  请求提交合并时，负责人收到邮件通知

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

  # 通过`/Email Settings`找到此行，修改邮箱发件人相关配置 ### Email Settings gitlab_rails['gitlab_email_enabled'] = true # 启用邮箱 gitlab_rails['gitlab_email_from'] = 'dengjinjun0805@126.com' # 发件邮箱，可配置为企业邮箱 gitlab_rails['gitlab_email_display_name'] = 'GitLab通知' # 发件人名称 # gitlab_rails['gitlab_email_reply_to'] = 'noreply@example.com' # 暂不配置 # gitlab_rails['gitlab_email_subject_suffix'] = '' # 暂不配置 # 通过`/GitLab email server settings`找到此行，修改邮箱服务端相关配置 ### GitLab email server settings ###! Docs: https://docs.gitlab.com/omnibus/settings/smtp.html ###! **Use smtp instead of sendmail/postfix.** gitlab_rails['smtp_enable'] = true # 开启stmp服务端 gitlab_rails['smtp_address'] = "smtp.126.com" # 服务端地址 gitlab_rails['smtp_port'] = 465 # 端口 gitlab_rails['smtp_user_name'] = "dengjinjun0805@126.com" # 邮箱名 gitlab_rails['smtp_password'] = "EMNOVPYJBDYFSNFN" # 密钥 gitlab_rails['smtp_domain'] = "126.com" # 域名 gitlab_rails['smtp_authentication'] = "login" # 登录方式 gitlab_rails['smtp_enable_starttls_auto'] = true # 加密相关 gitlab_rails['smtp_tls'] = true # 加密相关

启动并测试

• 启动

  1 2 3

  gitlab-ctl reconfigure # 验证配置并启动，适用于修改配置后启动 gitlab-ctl stop # 关闭 gitlab-ctl start # 启动

• 验证邮箱

  1 2	gitlab-rails c Notify.test_email('498790885@qq.com','主题：Gitlab-test','内容：测试发送邮件').deliver_now

• web界面

  1	# 浏览器中访问域名，查看是否正常。注意先编辑本地的hosts文件，添加域名与IP的解析关系

汉化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# 下载汉化包
wget https://gitlab.com/xhang/gitlab/-/archive/08a51a9db938bb05f9a4c999075d010079e16bad/gitlab-08a51a9db938bb05f9a4c999075d010079e16bad.tar.gz

# 解压
tar -xf gitlab-08a51a9db938bb05f9a4c999075d010079e16bad.tar.gz 

rpm -qa | grep gitlab	# 查看gitlab版本
cat /VERSION		# 查看汉化包版本，确保一致

# 停止gitlab服务
gitlab-ctl stop

# 中文版资源覆盖英文版
\cp -r gitlab-08a51a9db938bb05f9a4c999075d010079e16bad/* /opt/gitlab/embedded/service/gitlab-rails/

# 重新配置gitlab服务
gitlab-ctl reconfigure
# 重启
gitlab-ctl start

GitLab入门使用

web界面设置密码之后，使用用户名root与新密码登录，具体操作自行熟悉。

GitLab迁移与备份

手动备份

• 更改配置

  1 2 3 4 5 6 7 8 9 10 11

  # 编辑配置文件，通过`/Backup Settings`找到此行，修改备份相关配置 ### Backup Settings ###! Docs: https://docs.gitlab.com/omnibus/settings/backups.html gitlab_rails['manage_backup_path'] = true # 开启自定义目录 gitlab_rails['backup_path'] = "/var/opt/gitlab/backups" # 存储备份文件的目录 gitlab_rails['backup_archive_permissions'] = 0644 # 备份文件的权限 gitlab_rails['backup_keep_time'] = 604800 # 存储时间，以秒为单位 gitlab-ctl reconfigure # 重启

• 执行备份

  1 2 3 4 5

  # 手动执行备份命令，会在备份目录下生成一个压缩包 gitlab-rake gitlab:backup:create # 执行备份，此命令适用于12.1及以前版本 gitlab-backup create # 执行备份，此命令适用于12.2及以后版本 # 注意：配置文件gitlab.rb以及密码文件gitlab-secret.json包含敏感信息，需要手动备份

自动备份

• 更改配置

  1

  # 同上

• 编写脚本

  1 2 3 4 5 6 7 8

  vim /server/scripts/backup-gitlab.sh #!/bin/bash # 执行备份 gitlab-rake gitlab:backup:create # 备份配置文件以及密码文件 tar -zcf /backup/gitlab-conf-$(date +%F).tar.gz /etc/gitlab

• 写入定时任务

  1 2 3 4

  crontab -e # 每天凌晨3点备份 00 03 * * * sh /server/scripts/backup-gitlab.sh &>/dev/null

恢复

1
2
3
4
5
6
7
8
9
10
11
12

# 先停止GitLab的写入类服务
gitlab-ctl stop puma
gitlab-ctl stop sidekip

# 执行恢复命令
gitlab-rake gitlab:backup:restore BACKUP=备份文件的压缩包名		# 执行恢复，此命令适用于12.1及以前版本
gitlab-backup restore BACKUP=备份文件的压缩包名		# 执行恢复，此命令适用于12.2及以后版本

# 重启
gitlab-ctl restart

# 注意：如果需要恢复配置文件和密码文件，可以找到单独备份的压缩包，手动替换这两个文件，然后执行`gitlab-ctl reconfigure`

GitLab迁移与升级

升级

GitLab升级的理由：

1. 非常吸引人的新功能
2. 安全漏洞和修复bug
3. 标准化和自动化

GitLab升级的步骤：

GitLab的升级必须按照官方指定的升级顺序进行升级，不能够随意越级更新。注意要做好备份和快照。参考网页

迁移

GitLab跨服务器迁移有两种情况

1. 同版本迁移，只需要备份好GitLab数据和配置及密码文件，然后在另一台机器上部署同版本的服务，恢复即可。
2. 跨版本迁移，最好先在原来的机器上跨版本，然后再进行同版本迁移。

GitLab重置密码的方法

1
2
3
4
5
6

# 进入GitLab服务器，命令行操作
gitlab-rails console
user = User.where(id:1).first
user.password=12345678
user.password.confirmation=12345678
user.save