GitLab Docker容器配置完全指南

GitLab Docker容器配置完全指南

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

前言

作为一款流行的DevOps平台，GitLab提供了多种部署方式，其中Docker容器化部署因其便捷性和隔离性受到广泛欢迎。本文将深入讲解如何配置运行在Docker容器中的GitLab实例，帮助开发者快速搭建和定制自己的GitLab环境。

核心配置文件解析

GitLab容器使用标准的Linux软件包安装方式，其核心配置文件位于/etc/gitlab/gitlab.rb。这个Ruby格式的配置文件是控制GitLab各项功能的关键。

访问配置文件的两种方式

1. 进入容器Shell环境：

   sudo docker exec -it gitlab /bin/bash
   

   这种方式适合需要执行多个操作或查看多个配置的场景。

2. 直接编辑配置文件：

   sudo docker exec -it gitlab editor /etc/gitlab/gitlab.rb
   

   这种方式适合快速修改单个配置项。

关键配置项详解

1. 外部访问地址配置

external_url是必须设置的核心参数，它定义了GitLab实例的访问地址：

external_url 'http://your.domain.com'

2. 邮件服务配置

GitLab容器默认不包含SMTP服务器，需要手动配置邮件服务：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.server"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "user@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

3. HTTPS安全配置

为保障数据传输安全，建议启用HTTPS：

external_url 'https://your.domain.com'
nginx['redirect_http_to_https'] = true

容器启动预配置技巧

通过环境变量GITLAB_OMNIBUS_CONFIG可以在容器启动时预配置GitLab，这种方式特别适合自动化部署场景。

典型预配置示例

sudo docker run --detach \
  --hostname gitlab.example.com \
  --env GITLAB_OMNIBUS_CONFIG="external_url 'http://gitlab.example.com'; gitlab_rails['lfs_enabled'] = true;" \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume $GITLAB_HOME/config:/etc/gitlab \
  --volume $GITLAB_HOME/logs:/var/log/gitlab \
  --volume $GITLAB_HOME/data:/var/opt/gitlab \
  --shm-size 256m \
  gitlab/gitlab-ee:<version>-ee.0

重要提示：

• 多个配置项需要用分号(;)分隔
• 预配置不会写入gitlab.rb文件，每次启动都需要重新指定

网络配置进阶

1. 使用特定IP地址

sudo docker run --detach \
  --publish 198.51.100.1:443:443 \
  --publish 198.51.100.1:80:80 \
  --publish 198.51.100.1:22:22 \
  # 其他参数...

2. 自定义端口映射

当默认端口(80,443,22)被占用时，可以映射到其他端口：

sudo docker run --detach \
  --env GITLAB_OMNIBUS_CONFIG="external_url 'http://gitlab.example.com:8929'; gitlab_rails['gitlab_shell_ssh_port'] = 2424" \
  --publish 8929:8929 --publish 2424:22 \
  # 其他参数...

配置要点：

1. 确保external_url中的端口与映射的主机端口一致
2. 需要单独配置SSH端口参数

数据库连接配置

从GitLab 16.0开始，默认使用两个数据库连接指向同一个PostgreSQL数据库。如需恢复单连接模式：

gitlab_rails['databases']['ci']['enable'] = false

配置生效与验证

修改配置后，需要重启容器使配置生效：

sudo docker restart gitlab

或者进入容器后执行重新配置命令：

gitlab-ctl reconfigure

最佳实践建议

1. 配置持久化：确保将配置目录挂载到宿主机，避免容器重建时丢失配置
2. 资源分配：根据团队规模合理分配CPU、内存和共享内存(shm)资源
3. 定期备份：配置好数据卷后，建立定期备份机制
4. 日志监控：将日志目录挂载出来便于问题排查

总结

通过本文的详细讲解，您应该已经掌握了GitLab Docker容器配置的核心要点。从基础配置到高级网络设置，合理运用这些技巧可以帮助您搭建出既安全又高效的GitLab环境。配置完成后，建议进一步设置用户认证、备份策略等，以构建完整的DevOps平台解决方案。

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq