记录一下 Windows10 下 Docker 安装 Gitlab 的步骤。
Caution: We do not officially support running on Docker for Windows. There are known issues with volume permissions, and potentially other unknown issues. If you are trying to run on Docker for Windows, please see our getting help page for links to community resources (IRC, forum, etc) to seek help from other users.
首先,Gitlab 官方是不支持 Windows 下部署 Gitlab 镜像的,所以正常的 Gitlab 服务还是部署在 Linux 上比较好。本地部署只是用于个人开发测试环境。
问题描述其实搭建 Gitlab 本省是一件很简单的事情,直接 pull 官方的 Gitlab 镜像开起来就可以用了。
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在 Windows 下我们把 volume 配置成本地路径运行后会出现一下错误:
Error executing action create on resource 'storage_directory[/var/opt/gitlab/git-data]通过查找,这应该是权限不足,导致 Windows 下的 volume 映射存在一些问题。
解决方法别人探索出目前可用的方法是采用 volume 数据卷挂载的形式。
首先先安装 Docker for Windows。并在 Setting 中设置 Shared Drives,设置一会用于挂载 docker 镜像的 volume 的磁盘。
然后初始化配置文件路径和 volume。
mkdir D:\docker\gitlab\config mkdir D:\docker\gitlab\backups docker volume create gitlab-logs docker volume create gitlab-data然后直接创建一个 Container 运行就可以了。
docker run --detach ` --name gitlab ` --restart always ` --hostname localhost ` --publish 10443:443 --publish 10080:80 --publish 1022:22 ` --volume D:\docker\gitlab\config:/etc/gitlab ` --volume gitlab-logs:/var/log/gitlab ` --volume gitlab-data:/var/opt/gitlab ` gitlab/gitlab-ce等待一段时间初始化后,就可以访问本地的 10080 端口了,:10080
打开后就是正常 Gitlab 的页面,重置一下 root 的密码就可以正常使用了。
使用 Docker-Compose 部署(推荐)如果在运行 Docker 容器时需要配置很多的参数,显然一遍遍输入 docker run 会比较麻烦,这里可以采用三剑客当中的 Docker-Compose 来进行容器的管理和创建(安装 docker-ce 时默认安装)。暂时不管 Docker-Compose 的其他用法,其实就是把命令运行改成了文件运行而已。
Docker-Compose 是通过文件来创建 Docker Container 的。我们需要在一个目录下创建 docker-compose.yml 文件,写入相应的配置文件。现在我们把上面的命令进行改造:
# Compose file 版本号,和 docker 版本号对应。3 支持 docker 1.13.0+ version: "3" # services 节点下包含多个待创建的 Docker Container services: # web 节点就是待启动的 gitlab 容器 web: image: gitlab/gitlab-ce:latest container_name: "gitlab" restart: always hostname: localhost environment: TZ: "Asia/Shanghai" GITLAB_OMNIBUS_CONFIG: | gitlab_rails["time_zone"] = "Asia/Shanghai" gitlab_rails["gitlab_shell_ssh_port"] = 10022 ports: - "10080:80" - "10022:22" volumes: - D:\docker\gitlab\config:/etc/gitlab - gitlab-logs:/var/log/gitlab - gitlab-data:/var/opt/gitlab volumes: gitlab-logs: gitlab-data:可以看到这个文件的内容几乎和之前的 docker run 命令是保持一致的,唯一不同的是不需要我们自己创建 volume 了,直接在配置文件中配置后,启动时会自己为我们创建。
配置完成后,使用 docker-compose 命令运行起来。
# 打开 cmd,进入 docker-compose.yml 的根目录 # 创建容器 docker-compose up -d #关闭容器 docker-compose stop What‘s More 1. Web UI 端口显示问题由于 Gitlab 是在 Docker 内运行的,外部需要访问的话都是需要通过端口映射的,并且一般内部端口不会和映射出来的外部端口相同。所以在用的时候可能会出现一些问题。
例如在我们例子里,22 映射到 10022,80 映射到 10080。可以看到在 Gitlab 默认的 WebUI 中,项目显示的克隆地址默认是不带端口号的,如下图所示:
因此在进行克隆的时候,无论是 http 还是 ssh,都需要在 url 中手动添加新的端口,例如
:10080/root/demo.git修改配置文件后可以直接在 WebUI 中显示正确的 url。
具体需要修改 gitlab.rb 和容器内部 /var/opt/gitlab/gitlab-rails/etc/gitlab.yml。
首先修改 gitlab.rb
# 取消这条配置文件的注释,并修改为外部映射的 ssh 端口 gitlab_rails['gitlab_shell_ssh_port'] = 1022 # 使用 exec 进入容器内部 [email protected]:/# gitlab-ctl reconfigure