GitLab 中文社区版 Docker 镜像启动和配置教程

GitLab 中文社区版 Docker 镜像启动和配置教程

项目的目录结构及介绍

本项目是一个汉化的 GitLab 社区版 Docker 镜像，基于官方提供的 Docker 镜像 gitlab/gitlab-ce，以及 Larry Li 的汉化 https://gitlab.com/larryli/gitlab（8.9以前的版本）和谢航的汉化 https://gitlab.com/xhang/gitlab（8.9以后的版本）而制作。项目目录结构如下：

.
├── .gitignore
├── README.md
├── build.sh
├── docker-compose.yml
├── versions.sh
├── LICENSE.md
├── Makefile
├── template
│   ├── Dockerfile
│   ├── Makefile
│   └── README.md
├── testing
│   ├── Dockerfile
│   ├── Makefile
│   └── README.md
├── 10.6
│   ├── Dockerfile
│   └── README.md
├── 10.7
│   ├── Dockerfile
│   └── README.md
├── 10.8
│   ├── Dockerfile
│   └── README.md
├── 11.0
│   ├── Dockerfile
│   └── README.md
└── 11.1
    ├── Dockerfile
    └── README.md

项目的启动文件介绍

项目提供多种启动方式：

1. 简单运行：使用 docker run 命令启动，适合快速测试。
2. 使用 Docker Compose：通过 docker-compose.yml 配置文件启动，适合生产环境部署。
3. 使用 Docker 命令：直接使用 docker 命令启动，可以更灵活地控制容器。

简单运行

执行以下命令启动容器：

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

启动后，可以通过主机的 3000 端口访问 GitLab。

使用 Docker Compose

创建一个 docker-compose.yml 文件，内容如下：

version: '2'
services:
  gitlab:
    image: 'twang2218/gitlab-ce-zh:11.1.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 设置，每行一个配置
        # 例如：
        # gitlab_rails['smtp_enable'] = true
        # gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
        # ...
    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 命令

首先创建卷和网络：

docker volume create gitlab-config
docker volume create gitlab-data
docker volume create gitlab-logs
docker network create gitlab-net

然后执行以下命令启动容器：

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:11.1.4

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

docker exec -it gitlab bash

项目的配置文件介绍

项目的配置文件主要包括 docker-compose.yml 和 config 目录下的配置文件。

1. docker-compose.yml：定义了 Docker Compose 的服务配置，包括镜像、端口映射、环境变量、卷等。
2. config 目录：包含了 GitLab 的配置文件，如 gitlab.rb。

配置文件可以使用环境变量进行覆盖，例如：

environment:
  TZ: 'Asia/Shanghai'
  GITLAB_OMNIBUS_CONFIG: |
    external_url 'http://gitlab.example.com'
    gitlab_rails['time_zone'] = 'Asia/Shanghai'
    # 其他配置...

以上就是 GitLab 中文社区版 Docker 镜像启动和配置教程，希望对您有所帮助。