使用Docker搭建GitLab实践

使用Docker搭建GitLab实践

SVN与GIT，二者皆须会

当前版本控制系统（Version Control System，VCS）有集中化版本版本控制系统（Centralized Version Control System，简称 CVCS）和分布式版本控制系统（Distributed Version Control System，简称 DVCS）。 
集中化版本控制系统的代表是SVN，分布式版本控制系统的代表是GIT。

熟悉SVN已两年，玩过SVNKIT、svn cli、pysvn，当然也搭建过SVN服务端。 
平常偶尔也通过GitHub或Git@OSC使用GIT，web界面所提供的功能强大，简单易用。 
而SVN在业界目前没发现有开源的成熟的类似GitHub这样的解决方案； 
GitLab号称是GitHub的开源实现，它拥有与Github类似的功能，其中Git@OSC就是基于 GitLab 项目搭建。 
也一直有想法自己搭建GitLab，用来体验、使用、熟悉它。 
而查阅过多篇关于GitLab的搭建的官方文档或博客，深深的感觉搭建过程过于繁琐，非一日之功，于是搭建GitLab计划就被搁浅了。 
当然，也有第三方提供一键安装Gitlab的解决方案（如Bitnami GitLab Installers），但不是很感冒，并没有做尝试。

Docker，让GitLab安装部署更简单

而今Docker流行，它使得软件安装部署变得更简单，通过Docker镜像与容器就可以快速搞定这些繁琐的、重复的安装部署过程，并且镜像可移植。 
之前曾用Docker部署过Jenkins和ReviewBoard，切身体会到了Docker的带来的便利。 
有了之前对Docker的了解与实践，于是开始了使用Docker搭建GitLab的实践。 
GitLab的Docker镜像已经有大牛做好，并且一直在随着GitLab这个版本帝的升级而进行维护，详见其GitHub仓库，并且文档也很健全。

使用Docker搭建GitLab实践

使用docker-compose快速启动Gitlab

wget https://raw.githubusercontent.com/sameersbn/docker-gitlab/master/docker-compose.yml
docker-compose up

三步走运行GitLab容器

1、运行一个PostgreSQL容器

docker run --name gitlab-postgresql -d \
--env 'DB_NAME=gitlabhq_production' \
--env 'DB_USER=gitlab' --env 'DB_PASS=password' \
--volume /srv/docker/gitlab/postgresql:/var/lib/postgresql \
sameersbn/postgresql:9.4-2

2、运行一个Redis容器

docker run --name gitlab-redis -d \
--volume /srv/docker/gitlab/redis:/var/lib/redis \
sameersbn/redis:latest

3、运行GitLab容器

docker run --name gitlab -d \
--link gitlab-postgresql:postgresql --link gitlab-redis:redisio \
--publish 10022:22 --publish 10080:80 \
--env 'GITLAB_PORT=10080' --env 'GITLAB_SSH_PORT=10022' \
--volume /srv/docker/gitlab/gitlab:/home/git/data \
sameersbn/gitlab:7.13.1

注意：GitLab应用的启动需要几分钟。

通过csphere查看gitlab相关容器

访问GitLab

访问地址：http://localhost:10080，使用默认的用户名和密码登录。 
默认的用户名：root
默认的密码：5iveL!fe

GitLab前不久启用了全新logo，界面布局也有变化：

GitLab更多配置

通过上面的步骤已经快速启动了GitLab容器，可以用来测试使用，但是要在生产环境使用GitLab还需要进行一系列配置。 
GitLab的一系列配置信息（如：GitLab_HOST、Mail、LDAP等）目前还无法从web界面进行配置。 
而docker-gitlab为这提供了以环境变量的形式提供了一系列可配置的参数。 
这些环境变量需要在GitLab镜像启动的时候指定。 
如果当前GitLab容器已启动，可以停止、删除容器，然后基于GitLab镜像指定环境变量再创建、启动新容器即可。

GITLAB_HOST配置

GITLAB_HOST: The hostname of the GitLab server. Defaults to localhost 
这个值会被Gitlab用来生成repo的链接，所以必须要设置。否则，在创建的repo中，会发现所有的repo链接都是以localhost为hostname。

MAIL配置

mail可以用来在用户注册的时候给用户发送邮箱认证链接相关信息。 
默认的mail配置使用的是gmail，需要一个用户名和密码来登录到gmail服务器。 
当然，也可以通过指定一系列SMTP相关的环境变量来使用其他邮箱（如QQ邮箱、网易邮箱）作为邮件服务器。

时区配置

GitLab默认的时区是UTC，北京时区为UTC+8区。 
可以通过指定环境变量GITLAB_TIMEZONE=Beijing来更改时区。

包括但不限于上面的配置，GitLab还可以定制更多配置信息，如LDAP、SSL、OmniAuth Integration等等，详情请参考官方说明文档。

Docker-GitLab搭建遇到的问题

磁盘空间不足

PostgreSQL容器在启动之后迅速关闭，再次启动亦是如此，且并没有给出错误提示信息。 
通过使用docker logs gitlab-postgresql查看容器日志时获得：No space left on device，在主机上清理磁盘空间后解决了该问题。

页面提供的访问gitlab的默认用户名和密码不准确（目前已修正）

页面提供的默认密码为password，登录失败，后来使用5iveL!fe这个登录成功。 
查看docker-gitlab的提交日志，关于默认密码，有如下行：

同时，与之相关的还有issue 389：

为Docker-GitLab做贡献

在阅读docker-gitlab的README时，发现文档有一处使用的fig（docker-compose的前身）， 
于是fork了docker-gitlab的源码，并提交了一个pull request将fig修改为docker-compose， 
目前该PR已经被Merged，很荣幸自己也成为docker-gitlab的一个contributor。

后续Docker-GitLab研究计划

• 研究docker-gitlab的其他配置，如LDAP、SSL、OmniAuth Integration等

• 研究docker-gitlab的安装配置文件（docker-gitlab/assets）

• 研究docker-gitlab的Dockerfile

• 研究docker-gitlab的entrypoint.sh（该shell脚本近千行）

参考

• docker-gitlab官方说明文档

• docker-gitlab部署(from segmentfault)