genezys/gitlab

GitLab Docker镜像文档

镜像概述和主要用途

GitLab是一款运行在自有服务器上的版本控制工具，功能类似GitHub但完全开源。它集成了Git仓库管理、代码审查、问题跟踪、活动流、Wiki和持续集成等功能，适用于团队协作开发和代码管理。本镜像基于官方Omnibus GitLab发行版构建，提供便捷的Docker化部署方式。

核心功能和特性

• 全面的开发工具集成：包含Git仓库管理、代码审查、问题跟踪、活动流、Wiki和持续集成功能
• 高扩展性：单服务器支持25,000用户，或可部署为高可用主/主集群，支持LDAP/AD组同步和审计日志
• 开源社区驱动：拥有700+贡献者，源代码可检查和修改，易于集成到现有基础设施
• 灵活部署选项：可在自有服务器上运行，也可使用免费的GitLab.com服务

使用场景和适用范围

• 企业或团队需要私有代码仓库管理
• 希望自托管版本控制系统以确保数据安全
• 需要集成代码审查、问题跟踪和持续集成的开发流程
• 寻求可扩展的版本控制解决方案，支持从小型团队到大型组织的使用需求

使用方法和配置说明

使用数据卷容器部署

推荐使用数据卷容器来简化迁移和备份，该容器将持久化GitLab使用的3个目录，注意不要删除此容器。

数据卷容器包含以下目录：

• /var/opt/gitlab：应用数据
• /var/log/gitlab：日志
• /etc/gitlab：配置文件

创建数据卷容器

bash
sudo docker run --name gitlab_data --volume /var/opt/gitlab --volume /var/log/gitlab --volume /etc/gitlab genezys/gitlab:7.10.4 /bin/true

运行GitLab应用容器

bash
sudo docker run --detach --name gitlab_app --publish 8080:80 --publish 2222:22 --volumes-from gitlab_data genezys/gitlab:7.10.4

容器启动后可能需要一段时间才能响应请求，可通过以下命令查看配置过程：

bash
docker logs -f gitlab_app

访问GitLab

• 访问地址：http://localhost:8080/（使用boot2docker时为http://192.168.59.103:8080/）
• 初始登录信息：用户名root，密码5iveL!fe

后续操作

启动容器：sudo docker start gitlab_app
停止容器：sudo docker stop gitlab_app

使用Docker Compose部署

可直接从项目仓库下载docker-compose.yml文件，该配置会创建包含3个卷的数据容器和使用这些卷的应用容器。

启动应用

bash
docker-compose up -d

配置GitLab

本容器使用官方Omnibus GitLab发行版，所有配置通过唯一配置文件/etc/gitlab/gitlab.rb完成。

访问配置文件

通过以下命令启动一个使用共享数据卷的交互式容器，可浏览3个目录并使用文本编辑器修改配置：

bash
docker run -ti -e TERM=linux --rm --volumes-from gitlab_data ubuntu
vi /etc/gitlab/gitlab.rb

应用配置

注意：GitLab会在每次容器启动时重新配置，修改配置后需重启容器使更改生效。

所有可用配置选项详见Omnibus GitLab文档。