GitLab Docker 镜像部署

3ewsd

环境说明
　　系统环境 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