目录

一、前言

二、部署

1、环境依赖

2、拉取镜像及运行

三、配置

1、管理员密码初始化

2、关闭注册功能

3、配置中国时区

4、配置https域名访问

5、配置邮件通知

四、数据备份及恢复

1、备份

2、通过备份恢复数据

五、总结

一、前言

环境要求：

  • docker
  • postfix（gitlab发送邮件使用，根据需要安装）

gitlab用户权限：

权限

说明

Guest

可以创建issue、发表评论，不能读写版本库

Reporter

可以克隆代码，不能提交，QA、PM可以赋予这个权限

Developer

可以克隆代码、开发、提交、push，RD可以赋予这个权限

Master

可以创建项目、添加tag、保护分支、添加项目成员、编辑项目，核心RD负责人可以赋予这个权限

Owner

可以设置项目访问权限 - Visibility Level、删除项目、迁移项目、管理组成员，开发组leader可以赋予这个权限

二、部署

1、环境依赖

# 安装依赖环境
yum install -y git curl policycoreutils-python perl

# 邮件相关
yum install postfix -y
sudo systemctl enable postfix
sudo systemctl start postfix

2、拉取镜像及运行

# 拉取镜像
docker pull gitlab/gitlab-ce:latest

# 创建gitlab数据、配置存放目录
mkdir -p /data/gitlab

# 运行gitlab
# https端口 443
# http端口 22
# ssh端口 23222，根据需要修改

docker run --detach \
  --hostname gitlab \
  --publish 443:443 --publish 80:80 --publish 23322:22 \
  --name gitlab \
  --privileged=true \
  --restart always \
  --volume /data/gitlab/config:/etc/gitlab \
  --volume /data/gitlab/logs:/var/log/gitlab \
  --volume /data/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce

三、配置

1、管理员密码初始化

# 默认管理员root，初始化密码如下
docker exec  gitlab cat /etc/gitlab/initial_root_password

2、关闭注册功能

通过web管理，使用管理员登录后，在Admin Area - Settings - Sign-up Restrictions -Sign-up enabled的勾选框去掉，即取消掉注册功能 - save

3、配置中国时区

docker exec -it gitlab ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo 'Asia/Shanghai' > /etc/timezone

4、配置https域名访问

修改Gitlab.rb配置文件

# docker exec -it gitlab bash
# vim /etc/gitlab/gitlab.rb
    EXTERNAL_URL="https://gitlab.example.com"
# gitlab-ctl reconfigure
# gitlab-ctl restart

5、配置邮件通知

# docker exec -it gitlab bash
# vim /etc/gitlab/gitlab.rb
# 修改以下配置，邮件服务根据实际情况配置，以下以QQ邮箱为例
     gitlab_rails['smtp_enable'] = true
     gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
     gitlab_rails['smtp_port'] = 465
     gitlab_rails['smtp_user_name'] = "yunwei@test.cn"
     gitlab_rails['smtp_password'] = "123456"
     gitlab_rails['smtp_domain'] = "smtp.exmail.qq.com"
     gitlab_rails['smtp_authentication'] = "login"
     gitlab_rails['smtp_enable_starttls_auto'] = true
     gitlab_rails['smtp_tls'] = true
     gitlab_rails['gitlab_email_from'] = "yunwei@test.cn"
     gitlab_rails['gitlab_email_reply_to'] = "yunwei@test.cn
# 重启
# gitlab-ctl reconfigure
# gitlab-ctl restart

四、数据备份及恢复

1、备份

# 手动备份
#注意，如果 /etc/gitlab/gitlab.rb 配置了参数“backup_path”（例如gitlab_rails['backup_path'] = '/backup'），则备份的目录就是该目录下（/backup/）；
如果没有配置参数“backup_path”，则gitlab把备份文件生成到默认目录/var/opt/gitlab/backups

# 备份命令 
# docker exec -it gitlab bash
# gitlab-rake gitlab:backup:create

2、通过备份恢复数据

注意：不同的版本备份的数据恢复时必须在对应版本下操作，否则会提示版本不匹配，导致恢复操作失败

# docker exec -it gitlab bash

# 恢复数据前先停止相关数据连接服务
# gitlab-ctl stop unicorn
# gitlab-ctl stop sidekiq

# 将备份文件放放/var/opt/gitlab/backups/，参考实际docker -v映射的数据目录路径

# 恢复备份，如备份文件名为：1647327071_2022_03_15_13.11.1.tar，则恢复命令如下

# gitlab-rake gitlab:backup:restore BACKUP1647327071_2022_03_15_13.11.1
# gitlab-ctl start