快捷導(dǎo)航

Docker GitLab的安裝完整配置項(xiàng)說明教程

更新時(shí)間：2025年11月23日 09:45:02 作者：Microi風(fēng)閑

這篇文章主要為大家詳細(xì)介紹了Docker GitLab的安裝完整配置項(xiàng)說明教程,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

1. 基礎(chǔ)運(yùn)行配置

docker run -d \
  --name gitlab \
  --restart always \
  --hostname gitlab.example.com \  # GitLab 訪問域名，必須設(shè)置
  -p 8443:443 \      # HTTPS 端口映射
  -p 8080:80 \       # HTTP 端口映射  
  -p 8022:22 \       # SSH 端口映射
  --shm-size 256m \  # 共享內(nèi)存大小，防止內(nèi)存不足
  gitlab/gitlab-ce:latest

2. 數(shù)據(jù)持久化配置

docker run -d \
  # ... 其他參數(shù) ...
  -v /srv/gitlab/config:/etc/gitlab \      # 配置文件持久化
  -v /srv/gitlab/logs:/var/log/gitlab \    # 日志文件持久化
  -v /srv/gitlab/data:/var/opt/gitlab \    # 應(yīng)用數(shù)據(jù)持久化
  gitlab/gitlab-ce:latest

3. 完整配置示例

docker run -d \
  --name gitlab \
  --restart always \
  --hostname gitlab.example.com \
  
  # 端口映射
  -p 8080:80 \        # Web 訪問端口
  -p 8443:443 \       # HTTPS 端口  
  -p 8022:22 \        # Git SSH 端口
  
  # 數(shù)據(jù)卷映射
  -v /docker/gitlab/config:/etc/gitlab \
  -v /docker/gitlab/logs:/var/log/gitlab \
  -v /docker/gitlab/data:/var/opt/gitlab \
  
  # 內(nèi)存和資源限制
  --shm-size 256m \
  --memory 4096m \     # 限制內(nèi)存使用
  --cpus 2 \          # 限制 CPU 核心數(shù)
  
  # 環(huán)境變量配置
  -e GITLAB_OMNIBUS_CONFIG="external_url 'https://gitlab.example.com'; gitlab_rails['gitlab_shell_ssh_port'] = 8022;" \
  
  gitlab/gitlab-ce:latest

4. 環(huán)境變量配置項(xiàng)

基礎(chǔ)配置

# 外部訪問 URL（必須）
-e EXTERNAL_URL="https://gitlab.example.com"

# 時(shí)區(qū)設(shè)置
-e GITLAB_TIME_ZONE="Asia/Shanghai"
郵件配置
bash
-e GITLAB_OMNIBUS_CONFIG="
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['smtp_tls'] = false;
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com';
"
數(shù)據(jù)庫配置
bash
# 使用外部 PostgreSQL
-e GITLAB_OMNIBUS_CONFIG="
gitlab_rails['db_adapter'] = 'postgresql';
gitlab_rails['db_encoding'] = 'unicode';
gitlab_rails['db_host'] = 'postgresql';
gitlab_rails['db_port'] = '5432';
gitlab_rails['db_username'] = 'gitlab';
gitlab_rails['db_password'] = 'password';
"
Redis 配置
bash
# 使用外部 Redis
-e GITLAB_OMNIBUS_CONFIG="
gitlab_rails['redis_host'] = 'redis';
gitlab_rails['redis_port'] = '6379';
"

5. 高級配置選項(xiàng)

SSL 證書配置

# 掛載 SSL 證書
-v /path/to/ssl:/etc/gitlab/ssl

-e GITLAB_OMNIBUS_CONFIG="
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';
"
備份配置
bash
# 備份目錄掛載
-v /backup/gitlab:/var/opt/gitlab/backups

# 備份設(shè)置
-e GITLAB_OMNIBUS_CONFIG="
gitlab_rails['backup_path'] = '/var/opt/gitlab/backups';
gitlab_rails['backup_keep_time'] = 604800; # 保留7天
"
性能調(diào)優(yōu)
bash
-e GITLAB_OMNIBUS_CONFIG="
# 工作進(jìn)程數(shù)
unicorn['worker_processes'] = 2;

# Sidekiq 并發(fā)數(shù)
sidekiq['concurrency'] = 10;

# 數(shù)據(jù)庫連接池大小
gitlab_rails['db_pool'] = 10;

# Redis 連接池
gitlab_rails['redis_cache_database'] = 0;
"

6. Docker Compose 完整示例

version: '3.8'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    hostname: 'gitlab.example.com'
    
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'https://gitlab.example.com'
        gitlab_rails['gitlab_shell_ssh_port'] = 8022
        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['smtp_tls'] = false
        gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'
        
    ports:
      - "8080:80"
      - "8443:443" 
      - "8022:22"
      
    volumes:
      - ./gitlab/config:/etc/gitlab
      - ./gitlab/logs:/var/log/gitlab
      - ./gitlab/data:/var/opt/gitlab
      - ./backup:/var/opt/gitlab/backups
      
    shm_size: '256m'
    mem_limit: 4g
    cpus: 2.0