环境说明

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