vssware/gitlab

Gitlab Docker镜像

基于 vssware/centos 镜像构建，用于便捷部署和运行GitLab服务。

镜像概述

该镜像提供了GitLab服务的容器化部署方案，支持通过环境变量配置外部或内部的Redis缓存、PostgreSQL数据库，以及SMTP邮件服务，适用于快速搭建GitLab代码管理平台。

核心功能与特性

• 基于CentOS系统，稳定可靠
• 支持配置外部Redis或使用内部Redis
• 支持配置外部PostgreSQL数据库或使用内部数据库
• 可自定义SMTP邮件服务参数
• 通过数据卷持久化GitLab数据和日志

使用场景

适用于需要快速部署GitLab服务的开发团队或企业，支持单机部署及与外部数据库、缓存服务集成的场景。

使用方法

数据卷初始化

首先创建并配置数据卷目录，用于持久化GitLab数据和日志：

shell
# 初始化数据卷目录
mkdir -p /data/docker/gitlab/data && chmod -R 777 /data/docker/gitlab/data
mkdir -p /data/docker/gitlab/log && chmod -R 777 /data/docker/gitlab/log

初次启动（配置初始化）

初次启动时需通过环境变量配置基础参数：

shell
docker run -it \
    --rm \
    --env 'INIT=true' \
    --env 'EXTERNAL_URL=http://localhost' \
    --env 'SMTP_SERVER=smtp.vssware.com' \
    --env 'SMTP_PORT=25' \
    --env 'SMTP_USER=jimmy@vssware.com' \
    --env 'SMTP_PASSWORD=abc' \
    --env 'SMTP_DOMAIN=vssware.com' \
    --env 'REDIS_ENABLE=false' \
    --env 'REDIS_SERVER=redis' \
    --env 'REDIS_PORT=6379' \
    --env 'REDIS_PASSWORD=vssware' \
    --env 'REDIS_DATABASE=0' \
    --env 'POSTGRESQL_ENABLE=false' \
    --env 'POSTGRESQL_SERVER=postgresql' \
    --env 'POSTGRESQL_PORT=5432' \
    --env 'POSTGRESQL_USER=gitlab' \
    --env 'POSTGRESQL_PASSWORD=gitlab' \
    -v /data/docker/gitlab/data:/var/opt/gitlab:Z \
    -v /data/docker/gitlab/log:/var/log/gitlab:Z \
    --privileged \
    vssware/gitlab

环境变量说明：

• INIT=true：标记为初始化配置，仅初次启动时使用
• EXTERNAL_URL：GitLab外部访问地址
• SMTP_*参数：
  • SMTP_SERVER：SMTP服务器地址
  • SMTP_PORT：SMTP服务器端口
  • SMTP_USER：SMTP用户名
  • SMTP_PASSWORD：SMTP用户密码
  • SMTP_DOMAIN：SMTP域名
• REDIS_*参数：
  • REDIS_ENABLE：是否启用内部Redis（true=使用内部，false=使用外部）
  • REDIS_SERVER：外部Redis服务器地址（REDIS_ENABLE=false时生效）
  • REDIS_PORT：外部Redis端口（REDIS_ENABLE=false时生效）
  • REDIS_PASSWORD：外部Redis密码（REDIS_ENABLE=false时生效）
  • REDIS_DATABASE：Redis数据库编号（REDIS_ENABLE=false时生效）
• POSTGRESQL_*参数：
  • POSTGRESQL_ENABLE：是否启用内部PostgreSQL（true=使用内部，false=使用外部）
  • POSTGRESQL_SERVER：外部PostgreSQL服务器地址（POSTGRESQL_ENABLE=false时生效）
  • POSTGRESQL_PORT：外部PostgreSQL端口（POSTGRESQL_ENABLE=false时生效）
  • POSTGRESQL_USER：外部PostgreSQL用户名（POSTGRESQL_ENABLE=false时生效）
  • POSTGRESQL_PASSWORD：外部PostgreSQL密码（POSTGRESQL_ENABLE=false时生效）

常规运行

初始化完成后，常规启动命令：

shell
docker run -d \
    -p 80:80 \
    -h gitlab \
    --name gitlab \
    -v /data/docker/gitlab/data:/var/opt/gitlab:Z \
    -v /data/docker/gitlab/log:/var/log/gitlab:Z \
    --privileged \
    vssware/gitlab

注意事项

若使用外部PostgreSQL数据库，需预先初始化数据库，执行以下SQL：

shell
create user gitlab with password 'gitlab';
create database gitlabhq_production with owner gitlab ENCODING 'UTF8';
grant all privileges on database gitlabhq_production to gitlab;
\c gitlabhq_production;
CREATE EXTENSION pg_trgm;