GitLab Enterprise Edition 镜像文档

一、镜像概述和主要用途

本镜像为 gitlab/gitlab-ee 的镜像副本，在保留其原有功能的基础上，额外提供了更灵活的标签格式（major 和 major.minor）。主要用途是通过容器化方式部署 GitLab Enterprise Edition（以下简称 GitLab EE），提供企业级代码仓库管理、CI/CD 流水线、用户权限控制、项目协作等一站式开发平台能力。

二、核心功能和特性

1. 扩展标签支持

• 提供 major 标签（如 16，对应主版本）和 major.minor 标签（如 16.11，对应主-次版本），简化版本管理；
• 兼容 gitlab/gitlab-ee 原有标签（如 latest、具体版本号 16.11.5-ee.0 等）。

2. 继承 GitLab EE 核心功能

• 企业级代码仓库：支持 Git 协议、分支保护、合并请求（MR）、代码评审；
• 集成 CI/CD：自动化构建、测试、部署流水线，支持多环境部署；
• 权限管理：细粒度角色控制（Admin、Maintainer、Developer 等）、项目共享、LDAP/SAML 集成；
• 协作工具：Issue 跟踪、Wiki、讨论区、项目仪表盘；
• 高可用性：支持集群部署、数据备份与恢复。

三、使用场景和适用范围

适用场景

• 企业级部署：需稳定运行的生产环境，通过 major 或 major.minor 标签锁定主版本，降低版本升级风险；
• 版本控制简化：无需指定具体补丁版本（如 16.11.5-ee.0），通过 16（major）或 16.11（major.minor）自动匹配最新补丁版本；
• 开发协作平台：中小型至大型团队的代码管理、协作开发、自动化交付场景。

适用范围

• 企业 IT 部门、研发团队；
• 需要标准化部署流程的 DevOps 场景；
• 对版本稳定性和升级可控性有较高要求的生产环境。

四、使用方法和配置说明

1. 标签说明

2. 基础部署（docker run）

2.1 使用默认标签（latest）

docker run -d \
  --name gitlab-ee \
  --hostname gitlab.example.com \
  -p 443:443 -p 80:80 -p 22:22 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  <镜像名称>:latest

2.2 使用 major 标签（如主版本 16）

docker run -d \
  --name gitlab-ee \
  --hostname gitlab.example.com \
  -p 443:443 -p 80:80 -p 22:22 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  <镜像名称>:16  # 使用 major 标签（主版本 16）

2.3 使用 major.minor 标签（如主-次版本 16.11）

docker run -d \
  --name gitlab-ee \
  --hostname gitlab.example.com \
  -p 443:443 -p 80:80 -p 22:22 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  <镜像名称>:16.11  # 使用 major.minor 标签（主-次版本 16.11）

3. docker-compose 部署示例

创建 docker-compose.yml 文件，配置如下：

version: '3.8'

services:
  gitlab-ee:
    image: <镜像名称>:16.11  # 指定 major.minor 标签
    container_name: gitlab-ee
    restart: always
    hostname: gitlab.example.com
    ports:
      - "80:80"    # HTTP 端口
      - "443:443"  # HTTPS 端口
      - "22:22"    # SSH 端口
    environment:
      GITLAB_ROOT_PASSWORD: "StrongPassword123"  # 初始管理员密码
      EXTERNAL_URL: "[***]"  # 外部访问 URL
    volumes:
      - /srv/gitlab/config:/etc/gitlab    # 配置文件持久化
      - /srv/gitlab/logs:/var/log/gitlab  # 日志持久化
      - /srv/gitlab/data:/var/opt/gitlab  # 数据持久化

启动服务：

docker-compose up -d

五、配置参数和环境变量

本镜像继承 gitlab/gitlab-ee 的所有配置参数，核心环境变量如下：

完整配置参数可参考 GitLab ***文档。

六、注意事项

1. 数据持久化：必须挂载 config、logs、data 目录，避免容器重启后数据丢失；
2. 资源需求：GitLab EE 建议最低配置为 4 CPU 核心、8GB 内存，生产环境需根据用户规模调整；
3. 版本升级：使用 major 或 major.minor 标签时，重启容器会自动拉取对应版本的最新补丁，建议升级前备份数据；
4. 网络配置：确保宿主机端口（80/443/22）未被占用，或通过端口映射调整（如 -p 8080:80）。