ansheng’s blog!

Docker安装及配置GitLab

GitLab和GitHub一样，都是基于Git开发了一些功能，然后商业化的产品，它俩唯一的不同之处在于GitLab可以私有化部署，这也就导致受到了很多企业的青睐。

本篇文章主要介绍如何以Docker化的方式安装GitLab，以及简单的配置，使用的是GitLab-CE社区版，操作系统CentOS 7。

环境

$ sudo yum update -y
$ sudo reboot

$ hostname
gitlab
$ uname -a
Linux gitlab 3.10.0-957.27.2.el7.x86_64 #1 SMP Mon Jul 29 17:46:05 UTC 2019 x86_64 x86_64 x86_64 GNU/Linux
$ whoami
ansheng
$ cat /etc/redhat-release
CentOS Linux release 7.6.1810 (Core)
$ getenforce
Disabled
$ sudo systemctl status firewalld
● firewalld.service - firewalld - dynamic firewall daemon
   Loaded: loaded (/usr/lib/systemd/system/firewalld.service; disabled; vendor preset: enabled)
   Active: inactive (dead)
     Docs: man:firewalld(1)

安装

$ curl -sSL https://get.docker.com/ | sudo sh
$ sudo systemctl enable --now docker

$ sudo docker run --detach \
  --hostname git.ansheng.me \
  --publish 443:443 \
  --publish 80:80 \
  --publish 8022:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

上面的配置中，请根据自己的实际情况进行调整，GitLab产生的数据都将存储在/srv/gitlab/目录下，如果不需要SSL是不用开放443端口的，因为系统本身占用了22端口，所以我把默认的22改成了8022。

本地位置 容器位置 作用
/srv/gitlab/data /var/opt/gitlab 数据
/srv/gitlab/logs /var/log/gitlab 日志
/srv/gitlab/config /etc/gitlab 配置文件

启动之后可能需要很长时间才能运行起来，你可以通过sudo docker logs -f gitlab来跟踪日志，第一次访问的时候系统会要求设置管理员密码

gitlab-set-password

设置完密码之后进行登陆，默认的用户名是root

gitlab-login

登陆成功之后，如下是默认的首页，至此，安装部分以及完成。

gitlab-home

创建一个项目试试

接着上图，我们点击首页上面的Create a project来创建一个项目

gitalab-create-project

如上，我们创建了一个私有的项目，项目命名为caca，隶属人root下，我这里只是作为演示，生产环境中是不会使用root用户的，毕竟不太安全，创建完成之后会进入项目首页，如下：

gitlab-project-home

然后我们点击右上角的Clone，尝试把项目下载下来

gitlab-project-clone

复制Clone with SSH下的指令git clone ssh://git@git.ansheng.me/root/caca.git，这条指令默认使用的是22端口，但是我们在运行gitlab时指定的端口是8022，所以我们还需要进行一些配置才能够正确的clone项目。

配置

容器使用的是官方Omnibus GitLab软件包，配置文件默认在/etc/gitlab/gitlab.rb中，若要修改配置，我们首先需要进入容器

$ sudo docker exec -it gitlab /bin/bash
root@git:/#

$ vim /etc/gitlab/gitlab.rb
# 默认使用的是22端口，我们需要更改为8022
gitlab_rails['gitlab_shell_ssh_port'] = 8022
# 如果你更换了域名，需要将下面的配置改为新域名，这里不需要更改
# external_url 'http://newgit.ansheng.me'

当然你也可以编辑/srv/gitlab/config/gitlab.rb这个配置文件

然后退出并重启容器使配置生效

$ sudo docker restart gitlab

再次刷新页面，复制Clone with SSH链接，发现端口以及改成了8022

gitlab-project-change-ssh

然后你就可以愉快的把项目clone到本地玩耍了！

邮件还是挺重要的，修改密码，消息通知等都会用到邮件，若要配置邮件，进入gitlab容器，然后打开配置文件

$ vim /etc/gitlab/gitlab.rb
# 增加如下配置
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.gmail.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "xxx@gmail.com"
# 这里的密码是应用专用密码，不是你登陆gmail的密码
gitlab_rails['smtp_password'] = "xxxx"
gitlab_rails['smtp_domain'] = "smtp.gmail.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false
gitlab_rails['smtp_openssl_verify_mode'] = 'peer'

配置修改完之后需要reconfig下，执行如下指令

$ gitlab-ctl reconfigure

然后进入gitlab的console来发送一封测试邮件

$ gitlab-rails console
Notify.test_email('ooo@gmail.com', 'Message Subject', 'Message Body').deliver_now

打开你的邮箱，你就可以收到如下的测试邮件

gitlab-send-mail

在登陆的时候不知道你有没有发现，旁边还有一个注册栏

gitlab-register

作为一个私有的git，有时我们是不希望别人进行注册的，所以我们需要关闭注册功能，若要添加用户，只能让管理员手动添加。

关闭注册功能需要使用root用户，以root用户登陆之后执行如下操作

  1. 点击顶部栏的Admin Area；
  2. 点击左侧栏的Settings；
  3. 找到Sign-up Restrictions设置；
  4. 取消勾选Sign-up enabled并点击下方的保存；

最后再次打开你的登陆页面就会发现已经没有注册功能了

gitlab-login

更新

GitLab更新还是挺勤快的….，还是使用新版本吧

$ sudo docker stop gitlab

$ sudo docker rm gitlab

$ sudo docker pull gitlab/gitlab-ce:latest

$ sudo docker run --detach \
  --hostname git.ansheng.me \
  --publish 443:443 \
  --publish 80:80 \
  --publish 8022:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

然后经过漫长的等待，再次打开会发现版本已经是最新的了，然后打开顶部栏的Admin Area，有一个栏目Components，会显示你当前gitlab的组件版本

gitlab-admin-components

当然我们刚刚升级完，肯定是最新的咯

参考文献