GitLab CE 多架构 Docker 镜像文档

1. 镜像概述

iabsdocker/gitlab-ce 是一个专为弥补 GitLab 官方镜像缺乏 ARM 架构支持而构建的 Docker 镜像。该镜像基于 yrzr/gitlab-ce-arm64v8-docker 项目改进完善，同时提供 ARM64 和 AMD64 架构支持，打包源码均来自 GitLab 官方仓库，确保与官方版本一致性。

2. 核心功能与特性

2.1 多架构支持

• 兼容架构：同时支持 ARM64 和 AMD64 架构，可根据宿主机 CPU 自动适配或手动指定架构拉取。
• 架构指定：通过 --platform 参数显式指定拉取 AMD64 或 ARM64 镜像，满足不同硬件环境需求。

2.2 自动解决 Redis 配置问题

• ARM64 兼容性优化：针对 ARM64 架构下 Redis 默认配置无法启动的问题，镜像启动时会自动在 redis.conf 中添加 "忽略 ARM64-COW-BUG 警告" 配置（16.6.0-ce.0 及以上版本），无需手动修改配置文件。

2.3 官方源码一致性

• 所有打包源码均来自 GitLab 官方仓库，确保功能、安全更新与官方版本同步，避免第三方修改引入的风险。

2.4 即拉即用

• 无需额外手动配置，拉取镜像后可直接启动运行，简化部署流程。

3. 使用场景与适用范围

3.1 硬件环境

• ARM64 设备：如树莓派、ARM 架构服务器（AWS Graviton、阿里云 ARM 实例等）、嵌入式 ARM 设备。
• AMD64 设备：传统 x86/x86_64 服务器、PC 等。

3.2 用户场景

• 个人开发者在 ARM 开发板（如树莓派）搭建本地 GitLab 实例。
• 企业或团队在 ARM 架构服务器上部署 GitLab，降低硬件成本。
• 需要跨架构统一部署流程的场景（如同时管理 AMD64 和 ARM64 服务器集群）。

4. 详细使用方法与配置说明

4.1 拉取镜像

4.1.1 自动适配架构（推荐）

直接拉取镜像，Docker 会根据宿主机 CPU 架构自动选择匹配的镜像版本：

docker pull iabsdocker/gitlab-ce:latest

4.1.2 手动指定架构

如需显式指定架构（如在 ARM64 宿主机拉取 AMD64 镜像用于测试），使用 --platform 参数：

• AMD64 架构：

  docker pull --platform=amd64 iabsdocker/gitlab-ce:latest
  

• ARM64 架构：

  docker pull --platform=arm64 iabsdocker/gitlab-ce:latest
  

4.2 运行容器

4.2.1 基础启动命令（Docker Run）

docker run -d \
  --name gitlab-ce \
  --restart always \
  -p 80:80 \
  -p 443:443 \
  -p 22:22 \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  iabsdocker/gitlab-ce:latest

• 参数说明：
  • -d：后台运行容器。
  • --name gitlab-ce：指定容器名称为 gitlab-ce。
  • --restart always：容器退出时自动重启，确保服务持续运行。
  • -p 80:80/-p 443:443/-p 22:22：映射 HTTP、HTTPS、SSH 端口（根据实际需求调整宿主机端口）。
  • -v /srv/gitlab/config:/etc/gitlab：挂载 GitLab 配置目录，持久化配置文件。
  • -v /srv/gitlab/logs:/var/log/gitlab：挂载日志目录，持久化日志数据。
  • -v /srv/gitlab/data:/var/opt/gitlab：挂载数据目录，持久化仓库、数据库等核心数据。

4.2.2 使用 Docker Compose 部署（推荐生产环境）

创建 docker-compose.yml 文件，配置如下：

version: '3.8'
services:
  gitlab-ce:
    image: iabsdocker/gitlab-ce:latest
    container_name: gitlab-ce
    restart: always
    ports:
      - "80:80"       # HTTP 端口
      - "443:443"     # HTTPS 端口
      - "22:22"       # SSH 端口
    volumes:
      - /srv/gitlab/config:/etc/gitlab   # 配置文件目录
      - /srv/gitlab/logs:/var/log/gitlab # 日志目录
      - /srv/gitlab/data:/var/opt/gitlab # 数据目录
    environment:
      - GITLAB_OMNIBUS_CONFIG="external_url '[***] gitlab_rails['time_zone'] = 'Asia/Shanghai';" # 可选：自定义 GitLab 配置
    networks:
      - gitlab-network

networks:
  gitlab-network:
    driver: bridge

启动容器：

docker-compose up -d

4.3 初始化与访问

1. 容器启动后，首次初始化需等待 5-10 分钟（取决于硬件性能）。
2. 通过宿主机 IP 或绑定的域名访问 GitLab Web 界面（默认 HTTP 端口 80）。
3. 初始管理员账号密码存储在容器内 /etc/gitlab/initial_root_password 文件中，可通过以下命令查看：

   docker exec -it gitlab-ce cat /etc/gitlab/initial_root_password
   

   注意：该文件会在 24 小时后自动删除，请及时保存密码。

4.4 配置调整（可选）

如需自定义 GitLab 配置（如外部 URL、邮件设置、LDAP 集成等），可通过以下方式：

1. 直接修改挂载的配置目录中的 gitlab.rb 文件（/srv/gitlab/config/gitlab.rb）。
2. 通过 environment 环境变量传入配置（如 docker-compose.yml 示例中的 GITLAB_OMNIBUS_CONFIG）。
3. 修改后需重启容器使配置生效：

   docker restart gitlab-ce
   

5. 项目地址与相关链接

• GitHub 项目地址：[***]
• Docker Hub 镜像仓库：[***]
• 项目博客：[***]