dwreg/gitlab

Docker GitLab 镜像文档

镜像概述

Docker GitLab镜像是一个容器化的GitLab服务部署方案，旨在简化GitLab的安装和运行流程。通过Docker容器化技术，用户可快速搭建完整的GitLab服务环境，无需复杂的系统配置，适用于开发团队的代码管理、协作开发及自动化构建部署需求。

核心功能与特性

核心功能

• 代码仓库管理：支持Git版本控制，提供完整的仓库创建、分支管理、代码提交与审查功能
• CI/CD流水线：内置持续集成/持续部署工具，支持自动化构建、测试和部署流程
• 用户与权限管理：细粒度的用户角色控制，支持项目级、组级权限配置
• Issue跟踪：集成任务管理系统，支持Bug报告、功能需求跟踪与进度管理
• Merge Request：代码合并流程管理，支持代码审查、讨论与自动化测试验证
• Wiki文档：为项目提供内置的知识库与文档管理功能

镜像特性

• 容器化部署：基于Docker容器，简化安装步骤，降低环境依赖
• 可移植性：支持在任何Docker兼容环境中运行，确保开发、测试与生产环境一致性
• 易于维护：通过容器管理工具简化服务启停、升级与备份操作

适用场景

• 开发团队协作：中小型开发团队的代码仓库管理与协作平台
• 企业内部代码管理：企业私有代码仓库，保护知识产权与敏感代码
• 自动化构建部署：需要实现CI/CD流程的项目，提升开发效率
• 个人开发者：个人项目的版本控制与文档管理

仓库地址

• https://github.com/pavelwolfdark/docker-gitlab
• GitLab

使用方法

基本部署（docker run）

bash
docker run -d \
  --name gitlab \
  -p 80:80 \
  -p 443:443 \
  -p 22:22 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  pavelwolfdark/docker-gitlab

参数说明：

• -p：端口映射，分别对应HTTP(80)、HTTPS(443)和SSH(22)服务
• -v：数据卷挂载，持久化存储GitLab配置、日志和数据

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gitlab:
    image: pavelwolfdark/docker-gitlab
    container_name: gitlab
    restart: always
    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
    environment:
      - GITLAB_OMNIBUS_CONFIG="external_url 'http://your-domain.com'; gitlab_rails['gitlab_shell_ssh_port'] = 22;"

启动服务：

bash
docker-compose up -d

配置说明

环境变量

通过GITLAB_OMNIBUS_CONFIG环境变量可自定义GitLab配置，常用配置项：

• external_url：GitLab访问URL（如http://gitlab.example.com）
• gitlab_rails['gitlab_shell_ssh_port']：SSH访问端口
• gitlab_rails['smtp_enable']：启用SMTP邮件服务
• gitlab_rails['smtp_address']：SMTP服务器地址

示例：

bash
-e GITLAB_OMNIBUS_CONFIG="external_url 'https://gitlab.example.com'; gitlab_rails['smtp_enable'] = true; gitlab_rails['smtp_address'] = 'smtp.example.com';"

数据持久化

建议通过卷挂载持久化以下目录：

• /etc/gitlab：GitLab配置文件
• /var/log/gitlab：日志文件
• /var/opt/gitlab：应用数据（仓库、数据库等）

注意事项

• 首次启动可能需要数分钟时间初始化服务
• 确保宿主机有足够的磁盘空间（建议至少20GB）
• 生产环境建议配置HTTPS以保障数据传输安全
• 定期备份数据卷目录，防止数据丢失