markusma/gitlab

markusma/gitlab 镜像文档

镜像概述

markusma/gitlab是一个经过可信构建（trusted build）的Docker镜像，旨在简化GitLab服务的部署流程。GitLab是一个开源的代码托管平台，集成了代码仓库管理、版本控制、CI/CD流水线、问题跟踪和项目管理等功能，适用于团队协作开发。

核心功能与特性

• 代码仓库管理：支持Git版本控制，提供仓库创建、分支管理、代码审查等功能
• 用户与权限控制：细粒度的访问权限管理，支持团队、项目级别的权限配置
• CI/CD流水线：内置自动化构建、测试和部署工具，支持自定义流水线配置
• 项目管理工具：集成Issue跟踪、里程碑、合并请求（Merge Request）等协作功能
• 可信构建保障：镜像经过官方可信构建流程，确保来源可靠、安全性有保障

使用场景

• 企业或团队搭建内部代码托管平台
• 开发团队实现代码版本控制与协作开发
• 自动化构建、测试和部署流程（DevOps实践）
• 小型到中型团队的项目管理与代码质量控制

使用方法

基本部署（docker run）

通过以下命令快速启动GitLab服务，需注意挂载数据卷以确保数据持久化：

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

参数说明：

• -p 80:80：映射HTTP端口
• -p 443:443：映射HTTPS端口（如需启用HTTPS需额外配置）
• -p 22:22：映射SSH端口（用于Git SSH访问）
• -v /srv/gitlab/config：挂载GitLab配置文件目录
• -v /srv/gitlab/data：挂载GitLab数据存储目录（包含仓库数据等）
• -v /srv/gitlab/logs：挂载日志目录

环境变量配置

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

• GITLAB_ROOT_PASSWORD：设置管理员（root用户）初始密码
• GITLAB_HOST：配置GitLab访问域名或IP
• GITLAB_PORT：配置访问端口（默认80）
• GITLAB_SSH_PORT：配置SSH访问端口（默认22）

示例（设置管理员密码）：

bash
docker run -d \
  --name gitlab \
  -e GITLAB_ROOT_PASSWORD="your_secure_password" \
  -p 80:80 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  markusma/gitlab

数据持久化

GitLab运行过程中会生成配置、数据和日志文件，为避免容器重启后数据丢失，必须通过-v参数挂载以下目录到宿主机：

• /etc/gitlab：配置文件目录
• /var/opt/gitlab：核心数据目录（包含代码仓库、数据库等）
• /var/log/gitlab：日志文件目录

访问GitLab

部署完成后，通过浏览器访问宿主机IP或配置的GITLAB_HOST，首次登录使用用户名root和配置的GITLAB_ROOT_PASSWORD密码，之后可创建项目、添加用户和配置CI/CD流水线。