使用 docker 迅速搭建gitlab

本文博客链接

Introduction

• GITLAB版本
  7.10.4
• 说明
  
  1. gitlab在服务器的搭建不是非要使用docker的方式， 但使用开源的docker镜像是方便的，本文只介绍这种方式。
  2. 本文完全使用了 docker-gitlab 的搭建方案，但为使文章更有意义，对官方的搭建方案进行了配置上的筛选和流程上的精简。
  3. 具体区别官方文档包括：
     
     • 省略了基本的硬件设备配置需求， 这些都可以在官方文档中查看到。
     • 省略了 Quick Start， 因为 Quick Start 对实际的平台搭建可能只是练手，不需要再重复说一遍了。
     • 挑选了主要的配置进行讲解， 官方详细的配置项在实际使用中并不是都需要的，并且也可以在其文档中查看到。
     • 对于 redis 和 mysql， 这里使用了 link container的方式， 本文仅提及此一种方式。
• 参考资料
  
  1. docker-gitlab
  2. 17173

Installtion

• 我们使用 docker 的方式搭建 gitlab , 所以首先需要 安装 docker 。
  sudo apt-get purge docker.io
  curl -s https://get.docker.io/ubuntu/ | sudo sh
  sudo apt-get update
  sudo apt-get install lxc-docker
• 使用 docker 依次下载镜像，包括 gitlab``mysql``redis , 三个镜像将用作启动三个 docker container 。
  docker pull sameersbn/gitlab:7.10.4
  docker pull sameersbn/mysql:latest
  docker pull sameersbn/redis:lates

Start

• 官方提供了 Quick Start 的参考。
• start.sh
  echo "Starting Redis..." # 启动 redis container
  docker run /
  --name=gitlab_redis /
  -tid /
  sameersbn/redis:latest
  echo "Starting MySQL..." ＃ 启动 mysql container
  mkdir -p /my/gitlab/mysql
  docker run /
  --name=gitlab_mysql /
  -tid /
  -e 'DB_NAME=gitlabhq_production' /
  -e 'DB_USER=gitlab' /
  -e 'DB_PASS=password' /
  -v /mygitlab/mysql:/var/lib/mysql / ＃ 挂载服务器mysql目录
  sameersbn/mysql:latest
  echo "Starting gitlab..." ＃ 启动 gitlab container
  mkdir -p /my/gitlab/data
  mkdir -p /my/gitlab/log
  docker run /
  --name='gitlab' /
  -itd /
  --link gitlab_mysql:mysql / ＃ link 启动的 mysql
  --link gitlab_redis:redisio / ＃ link 启动的 redis
  --env-file my_gitlab.conf / ＃ gitlab的配置文件
  --publish=8000:80 / ＃ 服务器端口:docker内端口
  --publish=2000:22 / ＃ 服务器端口:docker内端口
  -v /var/run/docker.sock:/run/docker.sock /
  -v $(which docker):/bin/docker /
  -v /my/gitlab/data:/home/git/data / # 挂载服务器文件data目录
  -v /my/gitlab/log:/var/log/gitlab / # 挂载服务器文件log目录
  sameersbn/gitlab:7.10.4
• 以上脚本用来启动 gitlab， 下面依次解释带有注释的重要行。
  
  • 首先启动 redis 和 mysql 的 container， 使用的是之前下载好的镜像。
  • 在启动 mysql container 的时候新建了 /my/gitlab/mysql 目录，用来挂载docker内部的 /var/lib/mysql 目录。
  • 启动 gitlab container， 使用 link 方式，link 到刚才创建的 redis 和 mysql。
  • publish 项用来做端口映射，8000:80 是服务器 gitlab host 端口和 gitlab docker 内端口的映射， 外部 web 80端口的请求可以通过 nginx 转发到 8000 端口，将映射到 docker 内部的 80 端口。2000:22，对应用来命令行操作。
  • 挂载了两个新建目录 /my/gitlab/data /my/gitlab/log , 这样在 host 主机上就可以找到这些内容。
  • --env-file my_gitlab.conf 此处选项是通过 my_gitlab.conf 文件来作为配置文件启动， 下面介绍几个常用配置组。
• my_gitlab.conf 文件中的常用配置组。包括：
  
  1. GITLAB HOST 配置 设置访问主页地址，以及 root 用户的初始密码
     GITLAB_HOST=example.gitlab.com
     GITLAB_TIMEZONE=UTC
     GITLAB_ROOT_PASSWORD=password
  2. EMAIL 配置 gitlab 平台的email设置
     GITLAB_EMAIL: The email address for the GitLab server. Defaults to example@example.com .
     GITLAB_EMAIL_DISPLAY_NAME: The name displayed in emails sent out by the GitLab mailer. Defaults to GitLab .
     GITLAB_EMAIL_REPLY_TO: The reply to address of emails sent out by GitLab. Defaults to the noreply@example.com .
     GITLAB_EMAIL_ENABLED: Enable or disable gitlab mailer. Defaults to the SMTP_ENABLED configuration.
  3. SMTP 配置 gitlab需要email配置来做通知工作。
     SMTP_ENABLED: Enable mail delivery via SMTP. Defaults to true if SMTP_USER is defined, else defaults to false .
     SMTP_DOMAIN: SMTP domain. Defaults to www.gmail.com
     SMTP_HOST: SMTP server host. Defaults to smtp.gmail.com .
     SMTP_PORT: SMTP server port. Defaults to 587 .
     SMTP_USER: SMTP username.
     SMTP_PASS: SMTP password.
     SMTP_STARTTLS: Enable STARTTLS. Defaults to true .
     SMTP_OPENSSL_VERIFY_MODE: SMTP openssl verification mode. Accepted values are none , peer , client_once and fail_if_no_peer_cert . Defaults to none .
     SMTP_AUTHENTICATION: Specify the SMTP authentication method. Defaults to login if SMTP_USER is set.
  4. Backups 配置 自动备份
     GITLAB_BACKUP_DIR: The backup folder in the container. Defaults to /home/git/data/backups
     GITLAB_BACKUPS: Setup cron job to automatic backups. Possible values disable , daily , weekly or monthly . Disabled by default
     GITLAB_BACKUP_EXPIRY: Configure how long (in seconds) to keep backups before they are deleted. By default when automated backups are disabled backups are kept forever (0 seconds), else the backups expire in 7 days (604800 seconds).
     GITLAB_BACKUP_TIME: Set a time for the automatic backups in HH:MM format. Defaults to 04:00 .
• nginx 配置
  
  1. 监听 80 端口转发服务器 8000 端口。

Maintenance

• 基本信息
  
  • gitlab host地址 my_gitlab.conf 中的 GITLAB_HOST 配置项。
  • root 用户初始密码 my_gitlab.conf 中的 GITLAB_ROOT_PASSWORD 配置项。
• 状态
  
  • 所有 data 和 log 挂载到 /my/gitlab/ 文件夹下。
  • mysql 目录挂载到 /my/gitlab/mysql 。
  • 查看 container 配置信息： docker inspect gitlab 。
• 备份(引用修改自 17173 )
  

  1. 备份：

     docker run /

     --name='gitlab_backup' /

     -it /

     --rm /

     --link gitlab_mysql:mysql /

     --link gitlab_redis:redisio /

     -v /var/run/docker.sock:/run/docker.sock /

     -v $(which docker):/bin/docker /

     -v /my/gitlab/data:/home/git/data /

     -v /my/gitlab/log:/var/log/gitlab /

     sameersbn/gitlab:7.10.4 app:rake gitlab:backup:create

  • 过程能在屏幕上看到，备份会自动打成tar包放入/my/gitlab/data/backups里。可以自行对该tar包做压缩，例如gzip 时间戳_gitlab_backup.tar。

  1. 恢复：

     docker run /

     --name='gitlab_restore' /

     -it /

     --rm /

     --link gitlab_mysql:mysql /

     --link gitlab_redis:redisio /

     -v /var/run/docker.sock:/run/docker.sock /

     -v $(which docker):/bin/docker /

     -v /my/gitlab/data:/home/git/data /

     -v /my/gitlab/log:/var/log/gitlab /

     sameersbn/gitlab:7.10.4 app:rake gitlab:backup:restore

     • 屏幕上会将/my/gitlab/data/backups中的所有文件和目录列出来，复制粘贴要恢复的tar包文件名，敲入回车即开始恢复。
     • 注意：恢复时会将当前数据库中的所有表先删掉再导入备份tar包的里sql文件，因此此步要小心。