GitLab Docker 镜像部署

水电工888

环境说明
　　系统环境 macOS
　　docker
　　原文地址

部署需求
　　docker 安装是必须的，可参考docker安装指引
　　提示：若使用持久卷（the persisted volumes） ，建议安装原生的docker，而不是Docker Toolbox。

运行镜像
　　运行镜像
　　

　　
sudo docker run --detach \
　　--hostname gitlab.example.com \
　　--publish 443:443 --publish 80:80 --publish 22: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 CE 容器，对外访问端口 SSH、HTTP和HTTPS。所有
　　GitLab 数据将被存储在/srv/gitlab/ 这个目录下。该容器将在系统重启时自动重启。
　　现在，你可以通过web地址访问。

提示：如下是我自己测试时的运行命令
　　

docker pull gitlab/gitlab-ce　　
docker run --detach \
　　
--hostname gitlab.example.com \
　　
--publish 8443:443 --publish 8080:80  \
　　
--name gitlab \
　　
--restart always \
　　
--volume /Volumes/MacSoft/data/gitlab/config:/etc/gitlab \
　　
--volume /Volumes/MacSoft/data/gitlab/logs:/var/log/gitlab \
　　
--volume /Volumes/MacSoft/data/gitlab/data:/var/opt/gitlab \
　　
gitlab/gitlab-ce:latest
　　
docker exec -it gitlab bash
　　

　　如果你运行的系统打开了SELinux，则需要用如下命令
　　

docker run --detach \　　--hostname gitlab.example.com \
　　--publish 443:443 --publish 80:80 --publish 22:22 \
　　--name gitlab \
　　--restart always \
　　--volume /srv/gitlab/config:/etc/gitlab:Z \
　　--volume /srv/gitlab/logs:/var/log/gitlab:Z \
　　--volume /srv/gitlab/data:/var/opt/gitlab:Z \
　　gitlab/gitlab-ce:latest
　　

　　这将确保Docker进程有足够的权限在被挂载的卷上去创建配置文件。

数据存储在哪？

本地位置
容器位置
描述
/srv/gitlab/data
/var/opt/gitlab
存储应用数据
/srv/gitlab/logs
/var/log/gitlab
存储日志
/srv/gitlab/config
/etc/gitlab
存储GitLib 配置文件　　你也可以微调这些目录，去满足你的需求。

配置GitLib

• 　　这个容器使用的官方Omnibus GitLab 包，因此所有配置被设定在唯一的配置文件 /etc/gitlab/gitlab.rb
  
  
• 你可以在一个运行中的容器环境下启动一个shell 回话，去访问GitLib 配置文件。这将允许你去访问所有的目录并使用你喜欢的编辑器去编辑他。
  

　　sudo docker exec -it gitlab /bin/bash

• 你也可以直接编辑 /etc/gitlab/gitlab.rb
  

　　sudo docker exec -it gitlab vi /etc/gitlab/gitlab.rb
　　首先打开/etc/gitlab/gitlab.rb 确认设置参数external_url指向了有效的URL

• 　　若从GitLib 接收邮件，你必须配置SMTP setting 项，因为GitLib Docker 镜像没有安装 SMTP 服务。
  
  
• 你也可能愿意 Enabling HTTPS。
  

　　所有的配置修改后，你需要重启容器，GitLab 配置才能生效。
　　sudo docker restart gitlab
　　提示：每次容器启动，GitLab会重置配置。更多的配置选项可以参考Omnibus GitLab 文档。

前置配置 Docker 容器
　　你可以前置配置GitLab Docker 镜像，在Docker 运行命令时通过添加 --env 参数 GITLAB_OMNIBUS_CONFIG。这个参数可以包括任意gitlab.rb 的设置，并将在加载容器内gitlab.rb文件前被生效。
　　通过这个方法，你可以很容易的配置GitLab的 external_url ，设置任意的数据库配置或其他Omnibus GitLab的配置选项。
　　提示：这个设置包括在GITLAB_OMNIBUS_CONFIG 参数下，配置内容不会写入gitlab.rb 中，仅在容器每次启动时被生效。
　　如下例子是当容器启动时设置外部URL 并打开LFS 支持。
　　

sudo docker run --detach \　　--hostname gitlab.example.com \
　　--env GITLAB_OMNIBUS_CONFIG="external_url 'http://my.domain.com/'; gitlab_rails['lfs_enabled'] = true;" \
　　--publish 443:443 --publish 80:80 --publish 22: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
　　

　　提示： 每次执行“docker run” 命令，你都需要指定“GITLAB_OMNIBUS_CONFIG” 参数，这个参数的内容是不会在每次“docker run” 后存储的。
　　配置GitLab时，环境变量的数量也是有限制的。具体可参看GitLab 文档的环境变量章节。

启动容器后
　　启动容器后，你可以访问http://localhost 或 http://192.168.59.103 如果你用 boot2docker. 可能也需要等一段时间才能响应你的请求操作。
　　提示： 初始命令可能花费很长时间。你可以用“sudo docker logs -f gitlab ” 这个命令跟踪查看日志。当你第一次访问GitLab 时，你将被要求设置admin 密码。你设置密码后，就可以用用户名 root 和刚才设置的密码登陆了。

更新GitLab

运行GitLab CE 在一个外网IP
　　你可以将Docker 容器用你自己的IP地址，将docker 的所有流量都转发到 --publish 参数指定的IP 地址
　　

sudo docker run --detach \　　--hostname gitlab.example.com \
　　--publish 1.1.1.1:443:443 \
　　--publish 1.1.1.1:80:80 \
　　--publish 1.1.1.1:22: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
　　

　　提示： 你可以通过http://1.1.1.1 或 https://1.1.1.1 访问GitLab

转发GitLab 到不同的端口
　　略

诊断潜在的问题
　　读取Docker 容器日志

　　sudo docker logs gitlab

　　进入运行中的容器

　　sudo docker exec -it gitlab /bin/bash

　　进入到容器内，你可以管理GitLab 容器

安装GitLab 用 docker-compose
　　利用 Docker compose 你可以很容易的配置、安装和升级GitLab 基础Docker
　　1、安装 Docker Compose
　　2、创建 docker-compose.yaml 文件（或下载一个样例）
　　

　　
web:
　　image: 'gitlab/gitlab-ce:latest'
　　restart: always
　　hostname: 'gitlab.example.com'
　　environment:
　　GITLAB_OMNIBUS_CONFIG: |
　　external_url 'https://gitlab.example.com'
　　#Add any other gitlab.rb configuration here, each on its own line
　　ports:
　　- '80:80'
　　- '443:443'
　　- '22:22'
　　volumes:
　　- '/srv/gitlab/config:/etc/gitlab'
　　- '/srv/gitlab/logs:/var/log/gitlab'
　　- '/srv/gitlab/data:/var/opt/gitlab'
　　

　　3、确认你与docker-compose.yaml文件在同一目录，执行docker-compose up -d 启动GitLab
　　阅读“前置配置 Dokcer 容器”章节可以了解GITLAB_OMNIBUS_CONFIG 参数是如何工作的。
　　如下是 docker-compose.yaml 定义GitLab 运行在一个自定义 HTTP 和 SSH 端口的例子。注意，GITLAB_OMNIBUS_CONFIG 的参数内容可参见 ports 部分
　　

web:　　image: 'gitlab/gitlab-ce:latest'
　　restart: always
　　hostname: 'gitlab.example.com'
　　environment:
　　GITLAB_OMNIBUS_CONFIG: |
　　external_url 'http://gitlab.example.com:9090'
　　gitlab_rails['gitlab_shell_ssh_port'] = 2224
　　ports:
　　- '9090:9090'
　　- '2224:22'
　　volumes:
　　- '/srv/gitlab/config:/etc/gitlab'
　　- '/srv/gitlab/logs:/var/log/gitlab'
　　- '/srv/gitlab/data:/var/opt/gitlab'
　　

　　这里同样使用 --publish 9090:9090 --publish 2224:22

更新 GitLab 用Docker compose
　　如果你安装 GitLab 用 docker-compose ，你可以运行 docker-compose pull 和 docker-compose up -d 去下载新的版本并更新你的GitLab 实例。

安装 GitLab 到一个集群
　　略

名词解析
　　持久卷（the persisted volumes）:
　　https://www.cnblogs.com/leidaxia/p/6485646.html