Introduction

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

参考资料

  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依次下载镜像,包括gitlabmysqlredis, 三个镜像将用作启动三个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)
  • 屏幕上会将/my/gitlab/data/backups中的所有文件和目录列出来,复制粘贴要恢复的tar包文件名,敲入回车即开始恢复。
  • 注意:恢复时会将当前数据库中的所有表先删掉再导入备份tar包的里sql文件,因此此步要小心。
  • 过程能在屏幕上看到,备份会自动打成tar包放入/my/gitlab/data/backups里。可以自行对该tar包做压缩,例如gzip 时间戳_gitlab_backup.tar。
  1. 备份: docker run \   
1.    --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
  1. 恢复: docker run \      
1. --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

转载于:https://blog.51cto.com/5404542/1755318