yrzr/gitlab-ce-arm64v8

GitLab-ce arm64v8 Docker镜像

镜像概述

本镜像为GitLab Community Edition (CE) 的Docker镜像，专门针对arm64v8架构构建，解决官方GitLab CE镜像仅支持AMD64架构的限制，可在arm64v8设备上提供完整的GitLab CE功能。

• 构建地址：https://github.com/yrzr/gitlab-ce-arm64v8-docker
• Docker Hub地址：https://hub.docker.com/r/yrzr/gitlab-ce-arm64v8
• 构建状态：https://github.com/yrzr/gitlab-ce-arm64v8-docker/actions/workflows/buildx.yml/badge.svg](https://github.com/yrzr/gitlab-ce-arm64v8-docker/actions/workflows/buildx.yml)
• 拉取量：

核心功能与特性

架构兼容性

• 专为arm64v8架构优化，支持基于ARM64的设备（如树莓派、ARM服务器等）。

版本标签支持

• 提供多版本标签：
  • latest：最新稳定版
  • 次要版本标签（如16.2）：对应16.2.x系列版本
  • 主版本标签（如16）：对应16.x系列版本（自16.2.1-ce.0起支持）

Redis配置自动修复

• 针对ARM64架构下Redis默认配置启动失败问题，自版本16.6.0-ce.0起，镜像启动时会自动在redis.conf中添加ignore-warnings ARM64-COW-BUG配置，无需手动修改。

使用场景

• 需在arm64v8架构设备（如树莓派4/5、ARM开发板、ARM云服务器）上部署GitLab CE的场景。
• 个人或小型团队的代码仓库管理、版本控制、CI/CD流程搭建。
• 对硬件资源有限制，需要在ARM设备上实现本地化GitLab服务的场景。

使用方法

Docker Run命令示例

bash
docker run \
  --detach \                   # 后台运行容器
  --restart unless-stopped \   # 容器退出时除非手动停止，否则自动重启
  --name gitlab-ce \           # 容器名称
  --privileged \               # 授予特权模式（GitLab部分组件需要）
  --memory 8G \                # 限制内存使用（建议至少8G）
  --publish 22:22 \            # 映射SSH端口（Git仓库访问）
  --publish 80:80 \            # 映射HTTP端口
  --publish 443:443 \          # 映射HTTPS端口
  --hostname gitlab.example.com \  # GitLab实例主机名（需替换为实际域名/IP）
  --env GITLAB_ROOT_PASSWORD="YourPasswordHere" \  # 设置管理员(root)密码
  --env GITLAB_OMNIBUS_CONFIG=" \  # GitLab Omnibus配置（自定义参数）
    registry['enable'] = false; \  # 示例：禁用容器 registry
    # 其他配置参数按需要添加，格式为键值对
  " \
  --volume /srv/gitlab-ce/conf:/etc/gitlab:z \    # 持久化GitLab配置
  --volume /srv/gitlab-ce/logs:/var/log/gitlab:z \  # 持久化日志
  --volume /srv/gitlab-ce/data:/var/opt/gitlab:z \  # 持久化数据（仓库、数据库等）
  yrzr/gitlab-ce-arm64v8:latest  # 镜像名称及标签（可替换为具体版本标签）

配置参数说明

核心环境变量

• GITLAB_ROOT_PASSWORD：必选，设置GitLab管理员账户（root）的初始密码，首次登录时使用。
• GITLAB_OMNIBUS_CONFIG：可选，用于自定义GitLab Omnibus配置，支持所有官方GitLab Omnibus参数（如禁用registry、配置SMTP、设置外部URL等），格式为Ruby语法的键值对。

数据卷挂载

为确保数据持久化，需挂载以下目录：

• /etc/gitlab：GitLab配置文件目录，挂载至宿主机/srv/gitlab-ce/conf
• /var/log/gitlab：日志目录，挂载至宿主机/srv/gitlab-ce/logs
• /var/opt/gitlab：核心数据目录（含仓库、数据库等），挂载至宿主机/srv/gitlab-ce/data
  注：:z标签用于SELinux环境下的权限兼容，非SELinux环境可省略。

版本标签使用

• 最新稳定版：yrzr/gitlab-ce-arm64v8:latest
• 特定次要版本：yrzr/gitlab-ce-arm64v8:16.2（对应16.2.x系列）
• 特定主版本：yrzr/gitlab-ce-arm64v8:16（对应16.x系列）
  建议生产环境使用具体版本标签（如16.6.0-ce.0）以避免自动升级风险。

注意事项

• 硬件要求：建议至少8GB内存，arm64v8架构CPU（如Cortex-A53/A72/A73等）。
• Redis配置：自版本16.6.0-ce.0起，镜像启动时会自动在redis.conf中添加ignore-warnings ARM64-COW-BUG，解决ARM64架构下Redis启动失败问题，无需手动修改。
• 持久化：务必挂载数据卷，避免容器删除导致配置、日志及仓库数据丢失。
• 网络配置：--hostname需设置为实际访问的域名或IP，否则可能导致Git仓库URL错误。