Docke中如何搭建gitlab

# Docker中如何搭建GitLab

## 前言

在当今的软件开发环境中，版本控制系统是不可或缺的工具。Git作为目前最流行的分布式版本控制系统，被广泛应用于各种项目中。而GitLab基于Git的代码托管平台，不仅提供了代码托管功能，还集成了CI/CD、问题跟踪、代码审查等一系列开发工具，成为许多团队的首选。

使用Docker部署GitLab可以带来诸多好处：
- **快速部署**：无需手动安装和配置各种依赖
- **环境隔离**：避免与主机系统的冲突
- **易于维护**：通过容器管理简化升级和备份流程
- **资源可控**：可以限制容器的资源使用

本文将详细介绍如何使用Docker搭建GitLab服务，包括基础部署、配置优化以及日常维护等内容。

## 准备工作

### 系统要求

在开始之前，请确保你的系统满足以下最低要求：

- **内存**：至少4GB（8GB以上推荐用于生产环境）
- **CPU**：2核以上
- **磁盘空间**：至少20GB可用空间
- **操作系统**：支持Docker的Linux发行版（Ubuntu、CentOS等）

### 安装Docker

如果你的系统尚未安装Docker，可以按照以下步骤安装：

```bash
# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt-get update
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 设置稳定版仓库
echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

# 验证安装
sudo docker run hello-world

安装Docker Compose

虽然可以直接使用Docker命令运行GitLab，但使用Docker Compose可以更方便地管理配置：

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

基础部署

使用Docker命令直接运行

最简单的启动GitLab的方式是使用官方镜像：

sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

参数说明： - --hostname: 设置GitLab实例的域名 - --publish: 端口映射（HTTP、HTTPS和SSH） - --volume: 数据持久化目录 - --restart: 设置容器自动重启

使用Docker Compose部署

更推荐的方式是使用docker-compose.yml文件：

version: '3'

services:
  gitlab:
    image: 'gitlab/gitlab-ce:latest'
    restart: always
    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'
    volumes:
      - '/srv/gitlab/config:/etc/gitlab'
      - '/srv/gitlab/logs:/var/log/gitlab'
      - '/srv/gitlab/data:/var/opt/gitlab'

然后运行：

sudo docker-compose up -d

初始配置

访问GitLab

容器启动后，首次访问需要等待几分钟初始化完成。然后在浏览器中访问：

http://你的服务器IP或域名

首次访问会提示设置root用户密码（至少8个字符）。

基本配置调整

通过修改/srv/gitlab/config/gitlab.rb文件可以进行更多配置：

external_url 'http://gitlab.example.com'
gitlab_rails['time_zone'] = 'Asia/Shanghai'
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
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

修改配置后需要重新加载：

sudo docker exec -it gitlab gitlab-ctl reconfigure
sudo docker exec -it gitlab gitlab-ctl restart

高级配置

邮件服务器配置

GitLab需要发送邮件通知，以下是使用SMTP的配置示例：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.gmail.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "your.email@gmail.com"
gitlab_rails['smtp_password'] = "your-password"
gitlab_rails['smtp_domain'] = "gmail.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['gitlab_email_from'] = 'your.email@gmail.com'

HTTPS配置

为了安全考虑，建议启用HTTPS：

1. 首先获取SSL证书（可以使用Let’s Encrypt）
2. 将证书文件放入/srv/gitlab/config/ssl目录
3. 修改配置：

external_url 'https://gitlab.example.com'
nginx['redirect_http_to_https'] = true
nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"

备份与恢复

设置自动备份：

gitlab_rails['backup_path'] = "/var/opt/gitlab/backups"
gitlab_rails['backup_keep_time'] = 604800  # 保留7天

手动备份：

sudo docker exec -it gitlab gitlab-rake gitlab:backup:create

恢复备份：

# 将备份文件复制到容器内
sudo docker cp gitlab_backup.tar gitlab:/var/opt/gitlab/backups/

# 停止相关服务
sudo docker exec -it gitlab gitlab-ctl stop unicorn
sudo docker exec -it gitlab gitlab-ctl stop sidekiq

# 执行恢复
sudo docker exec -it gitlab gitlab-rake gitlab:backup:restore BACKUP=备份文件名

性能优化

资源限制

在Docker Compose文件中可以设置资源限制：

services:
  gitlab:
    # ...其他配置...
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

数据库优化

对于大型实例，可以考虑使用外部PostgreSQL数据库：

gitlab_rails['db_adapter'] = "postgresql"
gitlab_rails['db_encoding'] = "unicode"
gitlab_rails['db_host'] = "postgresql.example.com"
gitlab_rails['db_port'] = "5432"
gitlab_rails['db_username'] = "gitlab"
gitlab_rails['db_password'] = "password"

缓存配置

使用Redis可以提高性能：

gitlab_rails['redis_host'] = "redis.example.com"
gitlab_rails['redis_port'] = 6379

常见问题解决

启动慢的问题

GitLab容器首次启动可能需要10分钟以上，这是正常现象。可以通过以下命令查看状态：

sudo docker logs -f gitlab

502错误

如果遇到502错误，可能是资源不足导致。尝试增加内存或等待服务完全启动。

忘记管理员密码

可以通过以下命令重置root密码：

sudo docker exec -it gitlab bash
gitlab-rails console -e production
user = User.where(id: 1).first
user.password = '新密码'
user.password_confirmation = '新密码'
user.save!
exit

升级GitLab

升级前请确保有完整的备份。升级步骤：

1. 停止并删除当前容器
2. 拉取新版本镜像
3. 使用相同的配置重新启动容器

sudo docker stop gitlab
sudo docker rm gitlab
sudo docker pull gitlab/gitlab-ce:latest
# 使用之前的docker run或docker-compose命令重新启动

结论

通过Docker部署GitLab不仅简化了安装过程，还提供了更好的可维护性和可扩展性。本文介绍了从基础部署到高级配置的全过程，包括：

1. 使用Docker和Docker Compose部署GitLab
2. 基本配置和优化
3. 备份恢复策略
4. 常见问题解决方法

对于生产环境，建议： - 使用HTTPS确保安全 - 配置定期备份 - 监控资源使用情况 - 考虑使用外部数据库和缓存服务

希望本文能帮助你顺利搭建自己的GitLab服务，为团队提供一个高效的代码管理和协作平台。 “`