GitLab 中文社区版攻略

支持的 tags 和对应的 Dockerfile

• 10.2, 10.2.8 (10.2/Dockerfile)
• 10.3, 10.3.9 (10.3/Dockerfile)
• 10.4, 10.4.7 (10.4/Dockerfile)
• 10.5, 10.5.7 (10.5/Dockerfile)
• 10.6, 10.6.4, latest (10.6/Dockerfile)
• testing (testing/Dockerfile)

这是汉化的 GitLab 社区版 Docker Image twang2218/gitlab-ce-zh，基于官方提供的 Docker Image gitlab/gitlab-ce，以及 Larry Li 的汉化 https://gitlab.com/larryli/gitlab (8.9以前的版本) 和谢航的汉化 https://gitlab.com/xhang/gitlab (8.9 以后的版本) 而制作。

• 如果碰到汉化问题，欢迎到 https://gitlab.com/xhang/gitlab/issues 来提交 Issue 甚至 Merge Request；
• 如果碰到镜像问题，欢迎到 https://github.com/twang2218/gitlab-ce-zh/issues 来提交 Issue 或 Pull Request
• 如果是官方镜像同样存在的问题，欢迎到上游项目 https://gitlab.com/gitlab-org/gitlab-ce/issues（Gitlab 项目自身），或者 https://gitlab.com/gitlab-org/omnibus-gitlab/issues（Docker及打包问题）提交 Issue。

  使用

  简单运行

  如果想简单的运行一下看看，可以执行这个命令：

  docker run -d -p 3000:80 twang2218/gitlab-ce-zh:10.6.4

  可以将 10.6.4 换成你所需要的版本标签。

  启动后就可以通过主机的 3000 端口看到运行结果了，比如用的是本机 Docker 的话，访问：http://localhost:3000 即可。

  测试结束后，彻底清除容器可以用命令：

  docker rm -fv <容器ID>

  这样可以停止、删除容器，并清除数据。

  使用 Docker Compose

  正常部署时，可以使用 Docker Compose 来配置启动。建立一个 docker-compose.yml，内容如下：

  version: '2'
  services:
      gitlab:
        image: 'twang2218/gitlab-ce-zh:10.6.4'
        restart: unless-stopped
        hostname: 'gitlab.example.com'
        environment:
          TZ: 'Asia/Shanghai'
          GITLAB_OMNIBUS_CONFIG: |
            external_url 'http://gitlab.example.com'
            gitlab_rails['time_zone'] = 'Asia/Shanghai'
            # 需要配置到 gitlab.rb 中的配置可以在这里配置，每个配置一行，注意缩进。
            # 比如下面的电子邮件的配置：
            # gitlab_rails['smtp_enable'] = true
            # gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
            # gitlab_rails['smtp_port'] = 465
            # gitlab_rails['smtp_user_name'] = "[email protected]"
            # gitlab_rails['smtp_password'] = "password"
            # gitlab_rails['smtp_authentication'] = "login"
            # gitlab_rails['smtp_enable_starttls_auto'] = true
            # gitlab_rails['smtp_tls'] = true
            # gitlab_rails['gitlab_email_from'] = '[email protected]'
        ports:
          - '80:80'
          - '443:443'
          - '22:22'
        volumes:
          - config:/etc/gitlab
          - data:/var/opt/gitlab
          - logs:/var/log/gitlab
  volumes:
      config:
      data:
      logs:

  然后使用命令 docker-compose up -d 来启动，停止服务使用 docker-compose down。

  如果你的服务器有域名，将上面的 gitlab.example.com 替换为实际域名。

  实验时，也可以直接修改 /etc/hosts 方便测试。比如：

  扫描二维码关注公众号，回复： 37750 查看本文章

  127.0.0.1   gitlab.example.com

  使用 Docker 命令启动

  直接使用 docker 命令要比使用 docker-compose 繁琐一些，但是可以达到一样的效果。

  首先，Docker 容器数据应该存储于卷中，在这里我们使用最简单的本地命名卷：

  • gitlab-config 存储 GitLab 配置信息
  • gitlab-data 存储数据库
  • gitlab-logs 存储日志

  然后，我们需要创建自定义网络，从而让容器运行于独立的网络中，区别于默认网桥。

  docker network create gitlab-net

  准备好后，开始运行 Gitlab 容器：

  docker run -d \
      --hostname gitlab.example.com \
      -p 80:80 \
      -p 443:443 \
      -p 22:22 \
      --name gitlab \
      --restart unless-stopped \
      -v gitlab-config:/etc/gitlab \
      -v gitlab-logs:/var/log/gitlab \
      -v gitlab-data:/var/opt/gitlab \
      --network gitlab-net \
      twang2218/gitlab-ce-zh:10.6.4

  如果需要进入容器修改配置文件，可以用 docker exec 命令进入容器：

  $ docker exec -it gitlab bash
  root@09f6e32c528c:/# vi /etc/gitlab/gitlab.rb
  root@09f6e32c528c:/# gitlab-ctl reconfigure
  Starting Chef Client, version 12.12.15
  resolving cookbooks for run list: ["gitlab"]
  ...

  如需停止服务，直接运行 docker stop gitlab。

  如需卸载服务及相关内容，可以执行：

  docker stop gitlab
  docker rm gitlab
  docker network rm gitlab-net
  docker volume rm gitlab-config gitlab-datagitlab-logs

  testing 镜像

  testing 镜像是为了帮助翻译项目测试所制作的 GitLab 镜像，它始终使用最新的翻译结果。

  • testing 是比较 xhang 翻译项目 的 v10.6.4 标签和 10-6-stable-zh 分支 的差异生成汉化补丁，并基于官方镜像gitlab/gitlab-ce:10.6.4-ce.0 应用汉化结果进行构建的。

  测试镜像将会在所对应分支发生改变后数分钟内开始构建镜像，构建成功后，会推送到 Docker Hub 网站，以方便测试，可以随时关注最新的镜像标签列表中所对应的构建时间。

  运行测试镜像和运行其它镜像一样，可以用 docker-compose 的方法，也可以用之前最简命令的方法：

  docker pull twang2218/gitlab-ce-zh:testing
  docker run -d -p 3000:80 twang2218/gitlab-ce-zh:testing

  需要注意的是，这里的 docker pull 是必须的，因为测试镜像构建比较频繁，需要确保本地镜像是最新的镜像。如果是docker-compose，则执行 docker-compose pull 来或取最新镜像。

  build.sh 构建脚本

  build.sh 构建脚本是为了对维护本项目提供支持的脚本。脚本含 5 个子命令，分别为branch、tag、run、generate、ci。

  generate 和 ci 是维护项目所用的命令。

  而 branch、tag 和 run 配合使用，可以在不写 Dockerfile 的情况下直接生成特定版本、分支的汉化版本镜像。这样方便测试还在开发的分支，或者尚未进入 twang2218/gitlab-ce-zh 镜像库的镜像。

  generate - 生成 Dockerfile

  各个小版本分支的 Dockerfile，如 10.6/Dockerfile 等，都是使用 generate 命令生成的。因此只需要更新 build-version.sh 中的相关变量就可以完成各个版本镜像的升级。

  • 大多数补丁版本的更新只需要修改 VERSIONS 变量即可；
  • 如果添加新的分支，需要注意同时删除旧的分支，包括 VERSIONS 变量旧的版本，以及目录文件；
  • GitLab 官方镜像有时会出现同一个版本补发一个新的镜像，版本号不变，但是后缀会变化，此时不要忘记修改 APPENDIX变量；

  修改后，只需要重新生成所有文件：

  ./build.sh generate

  执行之后，可以 git diff 查看实际变更情况。

  在提交前，建议先测试新的 Dockerfile 是否可以正确构建。

  ci - 持续集成脚本

  ci 命令是为了持续集成服务准备的，现在支持 Travis CI。

  在 Travis CI 被触发后，会调用 ./build.sh ci 命令。该命令会根据环境变量情况决定是整体各个分支检查、构建、发布，还是针对某个标签检查、构建、发布。

  镜像构建成功后，会自动发布到 Docker Hub。这种方式比直接使用 Docker Hub 中的正则匹配要灵活。

  branch - 构建某个汉化分支的镜像

  格式为：./build.sh branch <基础镜像标签> <英文版本标签> <汉化版本分支>

  例如：./build.sh branch 10.6.4-ce.0 v10.6.4 8-15-stable-zh

  这表明将使用 gitlab/gitlab-ce:10.6.4-ce.0 做为基础镜像，并且使用上游版本标签 v10.6.4 作为对比的基础标签版本，也就是对应于基础镜像版本的标签，然后使用汉化分支 8-15-stable-zh 进行对比，生成汉化补丁，由此构建一个名为twang2218/gitlab-ce-zh:8-15-stable-zh 的镜像。

  tag - 构建某个汉化标签的镜像

  格式为：./build.sh tag <基础镜像标签> <英文版本标签>

  例如： ./build.sh tag 10.6.4-ce.0 v10.6.4

  这表明将使用 gitlab/gitlab-ce:10.6.4-ce.0 镜像为基础镜像，以 v10.6.4 为基础对比版本，以 v10.6.4-zh 为汉化版本进行对比生成汉化补丁，并构建一个名为 twang2218/gitlab-ce-zh:10.6.4 的镜像。

  run - 运行某个构建好的镜像

  格式为：./build.sh <镜像标签>

  例如： ./build.sh run 10.6.4

  这将会以命令 docker run -d -P twang2218/gitlab-ce-zh:10.6.4 来运行镜像。这里使用的是 -P，因此会随机映射端口。方便测试环境测试，避免和其它端口冲突。

  CONTAINER ID        IMAGE                         COMMAND             CREATED             STATUS              PORTS                                                                  NAMES
  68e03524b2f2        gitlab-ce-zh:8-15-stable-zh   "/assets/wrapper"   3 seconds ago       Up 1 seconds        0.0.0.0:32776->22/tcp, 0.0.0.0:32775->80/tcp, 0.0.0.0:32774->443/tcp   adoring_bartik

  从 docker ps 的结果可以看出，该运行的容器的 80 端口映射到了宿主的 32775 端口，因此访问 http://<主机IP>:32775 就可以看到运行结果。初次启动会比较慢，要耐心等待。

  注意事项

  登录

  启动 GitLab 后，第一次访问时，会要求设置 root 用户的密码，密码不得小于8位。设置好后，就可以登录使用了。

  对于早期版本，可以使用默认的 root 用户密码 5iveL!fe 登录。

  配置 SSH 端口

  这里运行示例中，无论是使用 docker-compose.yml 还是 docker run 都使用的是 SSH 默认端口 22 去映射容器 SSH 端口。其目的是希望比较自然的使用类似 [email protected]:myuser/awesome-project.git 的形式来访问服务器版本库。但是，宿主服务器上默认的 SSH 服务也是使用的 22 端口。因此默认会产生端口冲突。

  修改宿主的 SSH 端口

  修改宿主的 SSH 端口，使用非 22 端口。比如修改 SSHD 配置文件，/etc/ssh/sshd_config，将其中的 Port 22 改为其它端口号，然后 service sshd restart。这种方式比较推荐，因为管理用的宿主 SSH 端口改成别的其实更安全。

  修改容器的 SSH 端口

  修改容器的端口映射关系，比如将 -p 22:22 改为 -p 2222:22，这样 GitLab 的 SSH 服务端口将是 2222。这样做会让使用 GitLab 的 SSH 克隆、提交代码有些障碍。这种情况要改变用户使用 Git 的链接方式。

  要从之前的：

  git clone [email protected]:myuser/awesome-project.git

  改为明确使用 ssh:// 的 URL 方式。

  git clone ssh://[email protected]:2222/myuser/awesome-project.git

  相关信息

  • GitLab Docker 相关操作请参考：http://docs.gitlab.com/omnibus/docker/
  • GitLab 官方英文社区版 Docker 镜像：https://hub.docker.com/r/gitlab/gitlab-ce/
  • GitLab 官方英文企业版 Docker 镜像：https://hub.docker.com/r/gitlab/gitlab-ee/

继续阅读

更多最佳实践技术文章