使用Docker搭建GitLab实践

fefre 9年前

使用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相关容器

使用Docker搭建GitLab实践

访问GitLab

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

使用Docker搭建GitLab实践

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

使用Docker搭建GitLab实践

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的提交日志,关于默认密码,有如下行:

使用Docker搭建GitLab实践

同时,与之相关的还有issue 389

使用Docker搭建GitLab实践

为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实践

使用Docker搭建GitLab实践

后续Docker-GitLab研究计划

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

  • 研究docker-gitlab的安装配置文件(docker-gitlab/assets)

  • 研究docker-gitlab的Dockerfile

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

参考