jobscale/gitlab

GitLab 镜像文档

镜像概述和主要用途

GitLab是一个开源的代码托管和协作平台，集成了版本控制、CI/CD、项目管理、代码审查等功能。本镜像提供了GitLab的容器化部署方案，包含初始化配置脚本，可快速完成外部URL设置及SSL证书相关配置，适用于团队协作开发、代码管理和自动化部署场景。

核心功能和特性

• 完整功能集成：包含Git仓库管理、分支控制、合并请求、代码审查等版本控制功能
• CI/CD支持：内置持续集成/持续部署工具，支持自动化构建、测试和部署流程
• 项目管理：提供issue跟踪、里程碑管理、看板等项目协作工具
• 初始配置脚本：内置setup脚本，可自动配置外部访问URL并生成SSL证书相关文件
• 灵活部署：支持通过环境变量自定义部署参数，适应不同网络环境需求

使用场景和适用范围

• 企业内部代码仓库搭建与管理
• 开发团队协作开发与代码审查
• 自动化构建、测试和部署流程实现
• 中小型团队的项目管理与版本控制
• 需要快速部署GitLab服务的场景

使用方法和配置说明

环境变量说明

Docker部署示例

基本运行命令

bash
docker run -d \
  --name gitlab \
  -e HOST=your-gitlab-domain.com \
  -e PORT=443 \
  -p 443:443 \
  -v /path/to/gitlab/config:/etc/gitlab \
  -v /path/to/gitlab/data:/var/opt/gitlab \
  -v /path/to/gitlab/logs:/var/log/gitlab \
  gitlab-image:latest

配置脚本说明

容器启动后，内置的setup脚本会自动执行以下操作：

1. 检查/etc/gitlab/gitlab.rb配置文件是否存在
2. 若存在，向配置文件添加外部访问URL：external_url 'https://$HOST'
3. 执行gitlab-ctl reconfigure应用配置
4. 生成获取SSL证书的命令：echo -n | openssl s_client -showcerts -connect $HOST:$PORT 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > CA.pem

手动执行配置脚本（如需）

若自动配置未执行，可进入容器手动运行：

bash
docker exec -it gitlab /bin/bash
HOST=your-gitlab-domain.com PORT=443 setup

数据持久化

建议挂载以下目录以实现数据持久化：

• /etc/gitlab：GitLab配置文件
• /var/opt/gitlab：GitLab数据存储
• /var/log/gitlab：GitLab日志文件

访问服务

配置完成后，通过https://$HOST:$PORT访问GitLab服务，首次登录需设置root用户密码。