★ FEATURED ARTICLE 1. 为什么选择Docker Compose部署GitLabGitLab作为最受欢迎的开源代码托管平台之一传统安装方式需要配置大量依赖项Ruby、PostgreSQL、Redis等而Docker Compose通过容器化技术将整个部署过程简化到只需一个配置文件。实测在16GB内存的MacBook Pro上从零开始到完整运行仅需12分钟相比源码安装节省80%时间。重要提示生产环境建议至少分配4核CPU8GB内存否则运行代码流水线时可能出现容器OOM崩溃1.1 基础环境准备首先确保系统已安装Docker Engine 20.10和Docker Compose 2.0。验证命令如下docker --version # 输出示例Docker version 24.0.5 docker compose version # 输出示例Docker Compose version v2.20.2对于Windows用户需特别注意务必启用WSL2后端性能提升300%在Docker Desktop设置中分配至少6GB内存关闭杀毒软件的实时监控已知会导致卷挂载失败1.2 配置文件深度解析新建docker-compose.yml文件以下是关键参数说明version: 3.6 services: gitlab: image: gitlab/gitlab-ce:16.2.0-ce.0 container_name: gitlab hostname: gitlab.example.com environment: GITLAB_OMNIBUS_CONFIG: | external_url http://gitlab.example.com gitlab_rails[gitlab_shell_ssh_port] 2222 ports: - 80:80 - 443:443 - 2222:22 # 修改SSH默认端口避免冲突 volumes: - ./gitlab/config:/etc/gitlab - ./gitlab/logs:/var/log/gitlab - ./gitlab/data:/var/opt/gitlab shm_size: 256m restart: always参数设计原理shm_size解决Sidekiq内存不足问题分离式卷挂载便于单独备份配置/日志/数据指定版本标签避免自动升级导致兼容性问题2. 启动与初始化全流程2.1 一键启动服务执行部署命令docker compose up -d首次启动会执行以下操作拉取约1.5GB的镜像文件视网络情况约5-15分钟初始化PostgreSQL数据库生成RSA加密密钥对创建初始管理员账户通过以下命令查看实时日志docker compose logs -f --tail1002.2 关键初始化配置当看到GitLab configured and initialized日志后访问http://localhost进入设置修改root密码至少包含大小写字母数字特殊字符建议使用密码管理器生成16位以上组合配置SMTP服务以阿里云邮件推送为例# 在./gitlab/config/gitlab.rb中添加 gitlab_rails[smtp_enable] true gitlab_rails[smtp_address] smtpdm.aliyun.com gitlab_rails[smtp_port] 465 gitlab_rails[smtp_user_name] your-username gitlab_rails[smtp_password] your-password gitlab_rails[smtp_domain] your-domain.com gitlab_rails[smtp_authentication] login gitlab_rails[smtp_enable_starttls_auto] true gitlab_rails[smtp_tls] true重新加载配置docker exec -it gitlab gitlab-ctl reconfigure3. 高级配置与优化技巧3.1 性能调优方案修改gitlab.rb关键参数# 工作进程数 CPU核心数 1 unicorn[worker_processes] 5 # 每个worker内存限制(MB) unicorn[worker_memory_limit_min] 300 unicorn[worker_memory_limit_max] 350 # 数据库连接池 postgresql[max_worker_processes] 8 postgresql[shared_buffers] 512MB # 缓存配置 redis[maxmemory] 1GB redis[maxmemory_policy] allkeys-lru应用优化配置docker exec -it gitlab gitlab-ctl reconfigure docker compose restart3.2 备份与恢复方案手动备份生成.tar.gz归档docker exec -it gitlab gitlab-backup create备份文件存储在./gitlab/data/backups自动备份每日2点执行docker exec -it gitlab bash -c echo 0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON1 /etc/crontab灾难恢复# 停止相关服务 docker compose stop gitlab # 恢复备份将BACKUP_TIMESTAMP替换为实际时间戳 docker exec -it gitlab gitlab-backup restore BACKUPBACKUP_TIMESTAMP # 重启服务 docker compose start gitlab4. 常见问题排错指南4.1 容器启动失败排查现象docker compose up报错退出诊断步骤查看详细日志docker compose logs --timestamps | grep -i error常见错误及解决方案错误信息原因分析解决方案Cannot allocate memory内存不足增加Docker内存分配至6GBPermission denied卷挂载权限问题执行chmod -R 777 ./gitlabAddress already in use端口冲突修改docker-compose.yml端口映射4.2 邮件发送失败处理测试邮件发送docker exec -it gitlab gitlab-rails console # 在IRB中执行 Notify.test_email(recipientexample.com, Test, Body).deliver_now常见错误处理证书验证失败在gitlab.rb中添加gitlab_rails[smtp_openssl_verify_mode] none连接超时检查防火墙是否放行465端口认证失败确认用户名密码是否包含特殊字符需要URL编码4.3 SSH克隆异常处理当使用自定义SSH端口时需要在~/.ssh/config中添加Host gitlab.example.com HostName gitlab.example.com Port 2222 User git IdentityFile ~/.ssh/id_rsa测试连接ssh -T gitgitlab.example.com # 成功响应Welcome to GitLab, username!5. 生产环境安全加固5.1 网络层防护限制容器网络访问# 在docker-compose.yml中添加 networks: gitlab_net: internal: true启用HTTPS# gitlab.rb配置 external_url https://gitlab.example.com nginx[redirect_http_to_https] true nginx[ssl_certificate] /etc/gitlab/ssl/gitlab.crt nginx[ssl_certificate_key] /etc/gitlab/ssl/gitlab.key5.2 账户安全策略强制双因素认证gitlab_rails[require_two_factor_authentication] true gitlab_rails[two_factor_grace_period] 48 # 小时密码复杂度要求gitlab_rails[password_comp
阅读完成 · 觉得有帮助？
